compound-promotion-ladder

Detects recurring solution patterns and promotes them into critical patterns or new skills.

6|2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/Jerrylalala/compound-engineering --skill compound-promotion-ladder-jerrylalala
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: compound-promotion-ladder
Source: https://github.com/Jerrylalala/compound-engineering/tree/main/plugins/compound-engineering/skills-custom/compound-promotion-ladder
Command: npx skills add https://github.com/Jerrylalala/compound-engineering --skill compound-promotion-ladder-jerrylalala

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering lessons captured as one-off solution documents often get lost, so the same problems are rediscovered repeatedly. This Skill analyzes accumulated solution docs to detect recurring patterns and decides when an experience should be promoted into a critical pattern, a supplement to an existing skill, or a brand-new skill. ## Core Features & Use Cases - Recurrence Detection: Counts how often problems with the same tags appear in docs/solutions/ and flags patterns occurring two or more times. - Promotion Ladder: Classifies each experience into solution doc, critical pattern, skill supplement, or new skill based on recurrence count, affected modules, and non-obviousness. - Recurrence Miner: Periodically mines docs/solutions/ by tags and affected file paths to produce a recurrence analysis report. - Use Case: After ce:compound writes a solution doc about a Windows CRLF hooks issue, the Skill detects three similar tagged solutions across multiple modules and suggests promoting it to a critical pattern and appending a Windows caveats section to the relevant skill. ## Quick Start Ask the AI to run the compound promotion ladder analysis over docs/solutions/ and report which solution docs should be promoted to critical patterns or skills.

Frequently Asked Questions about compound-promotion-ladder

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

FAQPage Schema
How do I detect recurring problems in solution documentation?▼

Run the recurrence miner, which counts documents sharing the same tags in docs/solutions/ and groups issues by affected file paths. It outputs a recurrence report highlighting tags and files that appear multiple times.

When should a solution doc be promoted to a critical pattern?▼

Promote a solution doc when the same tagged problem occurs at least twice. If it affects three or more modules, supplement the related skill instead; if it is a non-obvious recurring pattern, create a new skill.

Does this skill run automatically after ce:compound?▼

No, it does not auto-trigger. After ce:compound writes a solution doc, you manually load this skill to run the promotion detection and review its upgrade suggestions before confirming.

How does the promotion ladder prevent overfitting to eval cases?▼

Promotions are based only on real recurrence counts, never on eval results, and single occurrences are never promoted. Content from evals/ is strictly forbidden from being copied into skill prompts.

What are the limitations of tag-based recurrence detection?▼

Detection depends on consistent tagging in solution frontmatter, so inconsistently tagged docs may be missed. Judging whether a pattern is non-obvious still requires human review, as the skill only provides hints.