skill-evolution · git:20261020.3598af2 · 2026-10-20 · sha256 bc754b6d94b1ece9
skill-evolution git:20261020.3598af2A
Immutable. This exact content never changes and is served at /api/v1/blob/bc754b6d94b1ece9.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_wtp2bykbeygk6ck7/bc754b6d94b1ece90dda2cbd1a7f372bafb4c4480cfa078333656c3a043e8c00.json
Then /plugin install skill-evolution@markdownregistry-wtp2bykbeygk6ck7 in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: skill-evolution description: Evolve new skills from project experience. Use when a repeating pattern, useful workflow, or hard-won knowledge should be captured as a reusable skill for the current project. --- # Skill Evolution Distill project experience into reusable skills that live under the current project. ## Two evolution paths 1. **Automatic**: The system promotes playbook skills when an employee's pattern reaches 2 project reflections with recurring behaviors, checklists, or preferences. These are saved as `<employee>-<role>-<domain>-playbook` and require no manual action. 2. **Agent-driven** (this skill): You proactively identify valuable patterns and create skills manually. Use this when domain knowledge, workflows, or tool sequences should be preserved before the auto-promotion threshold is reached, or when the knowledge is not tied to a specific employee pattern. ## When to evolve a skill (agent-driven) - A task required non-obvious steps that will likely recur - You discovered a workflow that worked well and should be preserved - Domain-specific knowledge was gathered that future tasks will need - A sequence of tool calls forms a reliable pattern worth codifying ## Process 1. **Identify the pattern**: What knowledge or workflow is worth preserving? 2. **Read the skill-creator skill**: `file_read` the `skill-creator/SKILL.md` for format and naming guidelines 3. **Name the skill**: Lowercase letters, digits, and hyphens only, under 64 characters (e.g., `api-validation-workflow`) 4. **Create the skill directory**: Under `.opc/projects/<project_id>/skills/<skill-name>/` 5. **Write SKILL.md** with proper frontmatter (`name`, `description`) and concise instructions 6. **Add scripts/references/assets** if the skill benefits from bundled resources ## Skill location Evolved skills belong to the project that produced them: ``` .opc/projects/<project_id>/skills/<skill-name>/SKILL.md ``` ## Guidelines - Keep it concise: only include what the agent doesn't already know - Use concrete examples over abstract explanations - Include the minimal set of steps needed to reproduce the workflow - Add `scripts/` for deterministic operations that get rewritten repeatedly - Add `references/` for domain docs the agent should consult - Follow the same naming conventions as auto-promoted skills (hyphen-case) ## Cross-project reuse Other projects can reference this project's skills via `file_read` when the secretary recommends them. Do not duplicate skills across projects; read from the source project instead.