feature-doc-writer

Update repository documentation for new feature context and maintainability.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/yuridefranca/ai-prompts --skill feature-doc-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature-doc-writer
Source: https://github.com/yuridefranca/ai-prompts/tree/main/src/skills/feature-doc-writer
Command: npx skills add https://github.com/yuridefranca/ai-prompts --skill feature-doc-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many code changes and new features are implemented without updating project documentation, leaving future developers and AI assistants unable to discover, reproduce, or understand the feature and its context. This Skill ensures documentation is created or updated in the repository so knowledge is preserved and discoverable.

Core Features & Use Cases

  • Repository-first documentation: Creates new feature docs and updates AGENTS.md or CLAUDE.md to surface new capabilities.
  • Consistent formatting: Integrates with agents-md-generator for format consistency and links docs to code locations.
  • Practical scenarios: Use when a new endpoint, workflow, or UI feature is added, when behavior changes, or when missing documentation is discovered.

Quick Start

Create or update the feature documentation file and add the feature entry to AGENTS.md using the repository file creation and replacement tools.

Frequently Asked Questions about feature-doc-writer

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

FAQPage Schema
How do I update repository documentation when adding new features?

Update repository documentation for new features by creating feature page files and modifying AGENTS.md or CLAUDE.md using file creation and replacement tools to preserve context and ensure discoverability.

Why does project documentation become outdated after code changes?

Project documentation becomes outdated after code changes because features are frequently implemented without updating docs, leaving future developers and AI assistants unable to discover or reproduce feature context.

What is the best way to keep AGENTS.md files up-to-date with new capabilities?

Keep AGENTS.md files up-to-date by applying documentation updates during feature design and implementation, linking to agents-md-generator to maintain format consistency across the repository.

Can I use doc-automation to update architecture diagrams and inline code comments?

Yes, doc-automation can update architecture diagrams and inline code comments during feature design, implementation, and behavior changes to maintain repository documentation and ensure feature discoverability.

Does feature documentation require any specific dependencies to format consistently?

Feature documentation requires no external dependencies, relying on repository file creation and replacement tools, but links to agents-md-generator to ensure format consistency across AGENTS.md and CLAUDE.md.

When should I not use automated repository documentation updates?

Avoid automated repository documentation updates for minor refactoring that does not alter feature behavior, as the process specifically targets feature design, implementation, and behavior changes to update AGENTS.md and CLAUDE.md.