How does the Compound Docs skill trigger?

It invokes automatically when it detects phrases like 'it's fixed' or 'problem solved', or it can be manually called using the /doc-fix command.

Does it support cross-referencing existing documentation?

Yes, the skill searches for similar existing issues and provides options to link new documentation to previous entries or update them.

What information does it require to document a solution?

It gathers the module name, symptoms, investigation attempts, root cause, verified solution, and prevention steps from the conversation history.

Where does it store the documented files?

Documents are stored locally in your repository, typically within a docs/solutions/ hierarchy organized by symptom category.

Can I use custom categories for my documentation?

Yes, categories are mapped from the problem_type field defined in your local schema.yaml and enum validation files.

Compound Problem Documentation

Name: Compound Problem Documentation
Author: Activer007

byActiver007

0•

学习与文档

Captures and organizes technical solutions into a searchable, YAML-validated knowledge base for institutional memory.

Compound Problem Documentation is a specialized skill for Claude Code that transforms fleeting conversation history into permanent technical assets. By enforcing a structured 7-step capture process, it documents solved bugs, debugging steps, and root causes immediately after verification. The skill ensures high-quality data through strict YAML frontmatter validation and category-based organization, allowing teams to build a searchable 'solutions' directory that prevents the loss of non-obvious project knowledge and facilitates the creation of critical pattern guides.

主要功能

01Automatic categorization and directory organization for easy lookup

02Cross-referencing logic to link related technical issues

030 GitHub stars

04Automated capture triggered by confirmation phrases or /doc-fix command

05Strict YAML frontmatter validation against project-specific schemas

06Pattern promotion menu to escalate recurring fixes to critical documentation

使用场景

01Building a local developer wiki of non-obvious bug fixes and edge cases

02Onboarding new developers by providing a history of solved architectural hurdles

03Automating the creation of project-specific 'Required Reading' for AI agents

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill