Skill Candidates¶
Purpose¶
Skill-Candidates.md is an engineering evidence ledger for reusable Claude Code workflows, not a backlog or TODO list. It records the history of candidate workflows — when each was observed, how often it recurred, and why it was promoted or discarded — so that the same reusable workflow is not rediscovered repeatedly across sessions.
Entries are never deleted. A candidate is either promoted to a project Skill (.claude/skills/<name>/SKILL.md) or discarded; discarded entries remain here with the reason for rejection as part of the repository's engineering history.
The lifecycle is defined in CLAUDE.md ("Skill lifecycle") and governed by ADR-0002.
Statuses¶
| Status | Meaning |
|---|---|
Tracked |
Recorded on first observation. Not yet a candidate; below the two-session threshold. |
Candidate |
Occurred in at least two distinct sessions; eligible for review. |
Approved |
Promoted to a project Skill; decision recorded in Decisions.md. |
Discarded |
Rejected at review, superseded, or no longer recurring; reason retained. |
Entry template¶
### <Skill name>
- Status: `Tracked` | `Candidate` | `Approved` | `Discarded`
- Date created: <YYYY-MM-DD>
- Session references: <session or context for each occurrence>
- Occurrences: <count; each occurrence with its session reference>
- Evidence for recurrence: <what was observed; concrete occurrences>
- Reason for promotion or rejection: <required once Approved or Discarded>
- Related roadmap phase: <e.g., Phase 1B — Local Investigation>
- Related decision: <Decisions.md entry, if promoted>