How does the skill know when to start documenting?

The skill monitors the conversation for confirmation phrases like 'that worked' or 'it's fixed,' and can also be manually invoked using the /doc-fix command.

Does it support metadata validation?

Yes, it includes a blocking validation gate that ensures all documentation includes required YAML frontmatter fields like problem_type, severity, and module name before saving.

Can I promote a specific fix to a 'best practice'?

Yes, after documentation, you can select the 'Add to Required Reading' option to promote the solution into a critical pattern library with 'Correct vs. Incorrect' examples.

Is it suitable for simple syntax errors?

No, the skill is specifically designed for non-trivial problems that required investigation, ensuring your knowledge base remains focused on high-value information.

How does it handle duplicate issues?

Before creating a new file, the skill searches the existing documentation directory for similar error messages and asks the user whether to update an existing doc or create a cross-reference.

Compound Docs: Structured Knowledge Capture

Name: Compound Docs: Structured Knowledge Capture
Author: Microck

byMicrock

•

Learning & Documentation

Captures and organizes verified problem resolutions into a searchable, YAML-enriched technical knowledge base.

Compound Docs is a specialized skill designed to transform transient debugging sessions into permanent institutional knowledge. By automatically detecting when a problem has been solved, it guides the user through a structured 7-step process to document the root cause, symptoms, and verified resolution. The skill enforces high data quality through strict YAML schema validation and intelligent categorization, ensuring that every documented fix is easily searchable and properly cross-referenced. It is particularly useful for teams looking to eliminate redundant troubleshooting by building a robust 'Required Reading' library of critical patterns and edge cases.

Key Features

01Duplicate detection and cross-referencing with existing solution docs

02Pattern promotion system for highlighting recurring critical issues

0381 GitHub stars

04Automatic triggering upon problem resolution confirmation phrases

05Strict YAML frontmatter validation for consistent metadata categorization

06Structured organization into category-specific symptom directories

Use Cases

01Building a team-wide searchable troubleshooting manual for complex software modules

02Standardizing post-mortem documentation for non-obvious technical bugs

03Extracting reusable architectural patterns from verified code fixes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add microck/ordinary-claude-skills compound-docs

For use in Claude.ai and ChatGPT

Download Skill