What are Compound Docs?

Compound Docs is a structured system for documenting, categorizing, and searching technical solutions within Elixir and Phoenix projects to build institutional knowledge.

What format do the documentation files use?

Solutions are stored as Markdown files with mandatory YAML frontmatter, including metadata like component, root cause, symptoms, and severity.

How does it help with debugging?

It implements an 'Iron Law' that mandates searching the existing solution base before investigating new issues, preventing developers from solving the same problem twice.

Does it integrate with other Elixir-Phoenix skills?

Yes, it integrates with /phx:investigate for pre-debugging searches and /phx:plan for consulting known risks during feature planning.

Compound Docs for Elixir/Phoenix

Name: Compound Docs for Elixir/Phoenix
Author: oliver-kriska

byoliver-kriska

•

Learning & Documentation

Builds a searchable institutional knowledge base of technical solutions and bug fixes to accelerate development and debugging.

Compound Docs is a specialized documentation system designed to capture and categorize solutions to recurring development challenges within Elixir and Phoenix applications. By enforcing a standardized Markdown format with mandatory YAML frontmatter, it transforms every debugging session into a reusable asset. The skill integrates deeply with the Elixir-Phoenix plugin ecosystem, requiring developers to consult previous fixes before starting new investigations. This approach ensures that institutional knowledge grows over time, preventing the recurrence of known issues and significantly reducing the cognitive load required for project maintenance.

Key Features

01Categorized directory structure for Ecto, LiveView, OTP, and deployment issues

02Grep-friendly architecture for rapid command-line querying of past resolutions

03Mandatory search-before-investigation workflow to reduce redundant debugging

0462 GitHub stars

05Standardized solution templates with mandatory YAML metadata for precise searching

06Prevention-focused documentation that records how to stop bug recurrence

Use Cases

01Building a searchable 'team brain' for complex Elixir and Phoenix project troubleshooting

02Automating the search for known project risks during the planning phase of new features

03Standardizing bug reporting and resolution documentation across a development team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add oliver-kriska/claude-elixir-phoenix compound-docs

For use in Claude.ai and ChatGPT

Download Skill