skills.rest
oxhagolli
oxhagolliCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

documentation-engineer

Generate per-directory CLAUDE.md files and refresh top-level CLAUDE.md and ARCHITECTURE.md.

4|Updated Feb 19, 2026
Search Tags:#architecture#documentation#claude#docs#update#per-directory
One-click install
npx skills add https://github.com/oxhagolli/clawdskillz --skill documentation-engineer-oxhagolli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: documentation-engineer
Source: https://github.com/oxhagolli/clawdskillz/tree/main/skills/documentation-engineer
Command: npx skills add https://github.com/oxhagolli/clawdskillz --skill documentation-engineer-oxhagolli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation often drifts after design decisions or major code changes. This skill guides updates and ensures consistency across CLAUDE.md and ARCHITECTURE.md.

Core Features & Use Cases

  • Per-directory CLAUDE.md generation: Creates CLAUDE.md in each directory to capture local patterns and caveats.
  • Top-level documentation maintenance: Updates CLAUDE.md at project root and ARCHITECTURE.md to reflect changes.
  • Trigger scenarios: Recommended after features are completed, major refactors occur, or architectural decisions change.

Quick Start

Execute after major changes to automatically generate per-directory CLAUDE.md files and refresh the root CLAUDE.md and ARCHITECTURE.md.

Frequently Asked Questions about documentation-engineer

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

FAQPage Schema
How do I keep documentation in sync with code after major refactoring?▼

To keep documentation in sync after refactoring, trigger an automated update that generates per-directory CLAUDE.md files and refreshes root CLAUDE.md and ARCHITECTURE.md to reflect the new architectural state.

What's the best way to maintain per-directory CLAUDE.md files for local patterns?▼

Maintaining per-directory CLAUDE.md files is best handled by automatically generating them after feature completion, ensuring each directory documents its local patterns and specific caveats accurately.

When do I need to update ARCHITECTURE.md in a software project?▼

You need to update ARCHITECTURE.md when architectural decisions change or major refactoring occurs, ensuring the top-level project documentation accurately reflects the new structural design and remains synchronized with the code.

Can I automatically generate CLAUDE.md files for each project directory?▼

Yes, you can automatically generate per-directory CLAUDE.md files after completing features or major code changes, capturing local patterns and caveats while simultaneously synchronizing root CLAUDE.md and ARCHITECTURE.md.

Does this documentation update skill work without external dependencies?▼

Yes, this documentation update skill operates without any external dependencies, requiring only your software project files to guide updates and ensure consistency across top-level and per-directory CLAUDE.md files.

Related Skills

Explore More Content & Communication Skills→
brmatolabrmatola

maintaining-project-context

Update CLAUDE.md files to reflect API changes and architectural decisions.

Community
Advanced
JongsixJongsix

moai-docs-generation

Generate technical documentation from source code and API definitions.

Community
Advanced
rishikanthcrishikanthc

requesting-code-review

Review git commit ranges for code quality, architecture, and tests.

Community
Intermediate
Mahaboob26Mahaboob26

markdown-documentation

Create structured Markdown documentation with GitHub Flavored Markdown formatting.

Community
Basic