Can it identify recurring patterns?

Yes, it includes a pattern detection step that can promote recurring issues to a 'Required Reading' file to prevent the AI from making the same mistake twice.

How does the Compound Docs skill trigger?

The skill automatically invokes after confirmation phrases like 'that worked' or 'it's fixed', and can also be manually triggered using the /doc-fix command.

Does it support custom metadata?

It uses a strict YAML frontmatter schema to ensure every documented solution includes critical context like module names, symptoms, and root causes.

How are the solution files organized?

Solutions are stored as individual markdown files within categorized subdirectories (e.g., docs/solutions/performance-issues/) based on the problem type.

Compound Documentation

Name: Compound Documentation
Author: Microck

byMicrock

•

Learning & Documentation

Captures and categorizes solved technical problems into a searchable markdown knowledge base with validated YAML metadata.

This skill transforms individual problem-solving sessions into institutional knowledge by systematically documenting resolutions as soon as they are confirmed. It guides Claude through a strict 7-step process to extract root causes, error messages, and verified solutions, then organizes them into a structured repository using validated YAML frontmatter. By maintaining a single-file architecture per solution and supporting automated cross-referencing, it prevents the recurrence of known issues and accelerates future debugging sessions within the Claude Code environment.

Key Features

01Intelligent cross-referencing to existing documentation and patterns

02Post-capture menu for promoting solutions to critical patterns or training skills

0381 GitHub stars

04Strict YAML schema validation for consistent metadata and searchability

05Auto-categorization based on validated problem-type enums

06Automatic trigger upon detecting problem resolution phrases

Use Cases

01Standardizing how complex debugging wins are documented for team visibility

02Preventing redundant work by searching previous solutions before starting new investigations

03Building a project-specific troubleshooting guide during active development

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