project-evangelist

Generates evidence-based developer documentation and progressive reading paths for software repositories.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/coferlandia/coferlandia-skills --skill project-evangelist-coferlandia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-evangelist
Source: https://github.com/coferlandia/coferlandia-skills/tree/main/skills/content/project-evangelist
Command: npx skills add https://github.com/coferlandia/coferlandia-skills --skill project-evangelist-coferlandia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Software repositories often lack clear developer documentation, leaving new contributors to reverse-engineer the technology stack, architecture, and change workflows from raw code. This Skill studies a repository's actual implementation and produces verified, progressively structured developer documentation under docs/. ## Core Features & Use Cases - Evidence-Based Repository Analysis: Inspects dependency manifests, entrypoints, schemas, CI configuration, and tests to build a verified model of the product, technology stack, architecture, domain, and main flows, classifying every finding as confirmed, inferred, unconfirmed, or contradictory. - Progressive Documentation Design: Proposes an adaptive docs/ structure with a clear entrypoint, Technology at a Glance, Architecture at a Glance, repository map, and goal-based reading paths for onboarding, feature work, and debugging. - Approval-Gated Authoring: Stops at a documented proposal gate before writing any project documentation, then validates links, commands, and claims against implementation evidence. - Use Case: Point the Skill at a legacy repository with scattered READMEs; it inventories the real stack, proposes a docs/index.md structure with reading paths, and after approval writes verified onboarding and architecture documentation. ## Quick Start Analyze this repository and create a developer documentation proposal with verified technology and architecture summaries before writing any docs.

Frequently Asked Questions about project-evangelist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate developer documentation for an existing repository?▼

Run the Skill from the repository root so it can inspect manifests, entrypoints, schemas, and CI configuration. It produces an evidence-based proposal first, then writes approved documentation under docs/ with reading paths for onboarding, feature work, and debugging.

How to document a project's technology stack accurately?▼

Verify each technology through imports, framework configuration, runtime wiring, migrations, or executed tests rather than dependency names alone. The Skill classifies findings as confirmed, inferred, unconfirmed, or contradictory and only presents confirmed items as facts.

Does this Skill configure MkDocs, Docusaurus, or GitHub Pages?▼

No. Version 1 deliberately does not configure MkDocs, GitHub Pages, Docusaurus, VitePress, Sphinx, themes, search, or publishing workflows. It produces plain Markdown documentation and only preserves existing tooling compatibility.

Can it modify README.md, AGENTS.md, or DECISIONS.md?▼

Not by default. Those canonical files are owned by the project-documentation-archivist Skill. Evangelist links to them instead of duplicating content and records an Archivist handoff when a canonical source is incomplete or contradicted by implementation evidence.

What are the limitations of automated repository documentation?▼

Documentation quality depends on verifiable implementation evidence; planned or historical behavior is never presented as current. Unverifiable commands are labeled unconfirmed, contradictions are reported rather than silently resolved, and writing requires an approved proposal.