Generates and maintains a standard docs folder structure with four topic areas: architecture (how the system works), codebase (where things live), code standard (team conventions), and project PDR (product requirements). It scans your project, infers whether you need initial setup or an incremental update, then writes or refreshes markdown files with actual content pulled from your code. The Agent Context Guide it adds to SUMMARY.md is deliberately narrow, just loading instructions for other AI agents. Useful when you inherit an undocumented repo or want to keep docs synced without rewriting everything from scratch each time. It won't invent requirements or pad empty projects with placeholder text.

skills.sh installs
388
GitHub stars
48
last updated
Jun 3, 2026

Install

$ npx -y skills add buiducnhat/agent-skills --skill docs --agent claude-code

Installs into .claude/skills of the current project.

Files

Docs

Create and maintain project documentation in docs/ with a consistent, lightweight structure.

Outputs

Maintain these outputs:

  1. docs/SUMMARY.md — documentation entry point with an Agent Context Guide (always regenerated)
  2. docs/architecture/ — system design, infrastructure, component interactions, data flows, feature flows. Focus on how the system works, not file/code structure.
  3. docs/codebase/ — file organization, directory structure, entry points, key modules and their responsibilities. Focus on where things live in the code.
  4. docs/code-standard/ — coding conventions, naming rules, style guides, environment setup, custom rules and patterns the team follows. Focus on how to write code that fits in with the existing codebase, best practices, and team conventions, very important for maintaining consistency.
  5. docs/project-pdr/ — product goals, use cases, business rules, constraints, and decision rationale. Nice to have many use case/requirements files

Also keep README.md aligned with current docs links and project summary.

Workflow

Step 1: Context Scan

Scan the project to understand what needs documenting:

Sponsors

Details

Repository
github.com/buiducnhat/agent-skills
Categories
Documentation, AI & Agent Building
First seen
Jun 3, 2026

More from buiducnhat/agent-skills

All 12
1different-ai avatarwriting-styledifferent-ai/agent-bankClean up text while preserving the writer's voice - minimal edits only385skills.sh installs
2levnikolaevich avatarln-114-frontend-docs-creatorlevnikolaevich/claude-code-skillsCreates design_guidelines.md with WCAG 2.1 compliance and design system docs. Use when project has a frontend.384skills.sh installs
3levnikolaevich avatarln-120-reference-docs-creatorlevnikolaevich/claude-code-skillsCreates reference docs (ADRs, guides, manuals) for nontrivial tech stack choices. Use when project needs justified architecture decision records.380skills.sh installs
4wordflowlab avatargetting-started-guidewordflowlab/novel-writer-skillsActivates when users start a new novel project - guides them through the seven-step methodology (constitution → specify → clarify → plan → tasks → write → analy374skills.sh installs
5freestylefly avatarpaddleocr-doc-parsingfreestylefly/canghe-skillsAdvanced document parsing with PaddleOCR. Returns complete document structure including text, tables, formulas, charts, and layout information. The AI agent ext373skills.sh installs
6diskd-ai avatardesign-docdiskd-ai/design-docCreate technical design documents for new features, systems, refactoring plans, API designs, and database schemas. Use when asked to write a design doc, TRD (te372skills.sh installs