compound-docs

Automates documentation of solved problems into searchable, categorized files.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/sammyjoyce/pi-compound-engineering --skill compound-docs-sammyjoyce
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compound-docs
Source: https://github.com/sammyjoyce/pi-compound-engineering/tree/main/skills/compound-docs
Command: npx skills add https://github.com/sammyjoyce/pi-compound-engineering --skill compound-docs-sammyjoyce

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the process of documenting solved technical problems, transforming them into searchable institutional knowledge and preventing recurring issues.

Core Features & Use Cases

  • Automated Documentation: Captures problem context, root cause, and solution into structured Markdown files.
  • Categorized Knowledge Base: Organizes documentation by problem type for efficient retrieval.
  • Use Case: After fixing a complex bug, you can use this Skill to automatically generate a detailed documentation entry that includes the exact error, the steps taken to resolve it, and preventative measures, making it easily searchable for future reference.

Quick Start

Use the compound-docs skill to document the solution to the recently solved N+1 query issue.

Frequently Asked Questions about compound-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate documentation for solved technical problems?

Automating documentation for solved technical problems involves extracting context, root causes, and solutions into structured Markdown files with YAML frontmatter. This process organizes solutions into a searchable knowledge base for fast lookup and retrieval, preventing recurring issues.

What is the best way to capture institutional knowledge and reduce technical debt?

Capturing institutional knowledge to reduce technical debt requires transforming resolved issues into categorized documentation. Validating problem context against a schema and generating structured filenames creates a searchable repository of preventative measures and solutions.

How do I structure a knowledge base for fast troubleshooting retrieval?

Structuring a knowledge base for fast troubleshooting retrieval requires organizing documentation by problem type with YAML frontmatter. Generating standardized filenames and validating entries against a schema ensures solutions remain easily searchable during future incidents.

Can I trigger knowledge base documentation automatically after fixing a bug?

You can trigger knowledge base documentation automatically using specific confirmation phrases. The system supports manual invocation or auto-triggering to capture exact errors, resolution steps, and preventative measures immediately after a bug fix.

What actions can I take after generating a troubleshooting document?

After generating a troubleshooting document, the system offers post-documentation decision points for further knowledge management actions. These options allow you to perform additional organization or retrieval tasks within your newly created institutional knowledge base.