compound-capture

Capture verified problem resolutions into YAML-frontmatter Markdown knowledge-base entries.

12|2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/jikig-ai/soleur --skill compound-capture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compound-capture
Source: https://github.com/jikig-ai/soleur/tree/main/plugins/soleur/skills/compound-capture
Command: npx skills add https://github.com/jikig-ai/soleur --skill compound-capture

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill converts confirmed, non-trivial problem resolutions into consistent, searchable knowledge-base entries so teams stop losing hard-won fixes and context after a session ends.

Core Features & Use Cases

  • Structured capture: Extracts module, symptoms, root cause, attempted fixes, and prevention steps into YAML-frontmatter-backed Markdown files.
  • Schema validation & categorization: Validates frontmatter against schema.yaml, enforces enum categories, and places files in the correct knowledge-base category.
  • Cross-references & routing: Detects similar docs, adds cross-references, and routes sharp-edge insights back to skill/agent/command definitions or files via interactive edits or GitHub issues.
  • Auto-consolidation on feature branches: Discovers related feature artifacts, proposes project updates, archives artifacts, and commits consolidation changes automatically or with user approval.
  • Modes: Supports interactive and headless modes with clear gating for missing context and YAML validation.

Quick Start

Use the compound-capture skill to document a verified fix by running the capture flow immediately after you confirm the problem is solved.

Frequently Asked Questions about compound-capture

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

FAQPage Schema
How do I document verified problem resolutions into a searchable knowledge base?

To document verified fixes, extract module, symptoms, root cause, and prevention steps into structured YAML-frontmatter Markdown files. This ensures hard-won resolutions are validated against schema.yaml and stored consistently in a searchable knowledge base.

What is the best way to consolidate feature branch artifacts before merging?

Consolidating feature branch artifacts requires discovering related artifacts, proposing project updates, and archiving them via automated commits. This auto-consolidation happens directly on the feature branch, optionally with user approval, to maintain a clean project state.

Does YAML frontmatter validation enforce specific category paths for documentation?

Yes, YAML frontmatter validation enforces enum categories and maps files to the correct knowledge-base paths. By validating against schema.yaml, the system ensures documentation is routed, categorized correctly, and cross-referenced with similar existing docs.

Can I route sharp-edge insights back to definitions using GitHub issues?

Yes, you can route sharp-edge insights back to skill, agent, or command definitions via interactive edits or optional GitHub issue creation. This ensures critical edge-case learnings are proposed directly to the relevant project files.

Do I need interactive mode to capture knowledge base entries, or does headless mode work?

Headless mode works for capturing knowledge base entries without user interaction, but both headless and interactive modes are supported. Clear gating ensures missing context and YAML validation are handled appropriately across both operational modes.

Why does schema validation fail when capturing fixes into Markdown files?

Schema validation fails when capturing fixes if the YAML frontmatter does not match the required fields and enum categories defined in schema.yaml. The system enforces strict validation to ensure proper categorization and routing within the knowledge base.