How does Compound Docs trigger the documentation process?

The skill automatically invokes when it detects phrases like 'it's fixed' or 'working now' in the conversation, or it can be manually triggered using the /doc-fix command.

Where is the documentation stored?

Solutions are saved as Markdown files within the docs/solutions/ directory, organized into subdirectories based on the specific category of the problem.

Can it help identify recurring patterns?

Yes, if the skill detects multiple similar issues, it suggests promoting the solution to a 'Critical Patterns' list to prevent the AI or developers from repeating the mistake.

What kind of metadata does the skill capture?

It captures the module name, symptoms, root cause, resolution steps, and environment details, all validated against a strict YAML schema.

Compound Docs

Name: Compound Docs
Author: gvkhosla

bygvkhosla

•

Learning & Documentation

Captures and organizes solved technical problems into a searchable, YAML-validated knowledge base for engineering teams.

Compound Docs is a specialized documentation skill for Claude Code that automates the creation of institutional knowledge. By detecting when a problem is resolved, it extracts critical context—such as symptoms, root causes, and code fixes—and formats them into structured Markdown files with strict YAML frontmatter validation. This ensures every fix is searchable, categorized by problem type, and available for future cross-referencing. It is particularly effective for complex engineering workflows where preventing recurring issues and maintaining a high-quality 'lessons learned' database is critical for long-term project velocity.

Key Features

01Automated cross-referencing of similar historical issues

02Strict YAML schema validation for consistent metadata and lookup

03Categorized directory organization based on problem types

0435 GitHub stars

05Pattern detection to promote frequent bugs to critical reading

06Automatic invocation upon resolution confirmation phrases

Use Cases

01Standardizing bug-fix documentation across distributed engineering teams

02Preventing regression by capturing non-obvious debugging insights

03Building a searchable 'solutions' database for complex legacy codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gvkhosla/compound-engineering-pi compound-docs

For use in Claude.ai and ChatGPT

Download Skill