From ork
Analyzes Claude Code skill usage patterns, suggests improvements, tracks versions, and enables rollbacks. Use for reviewing performance, applying edits, or reverting changes.
npx claudepluginhub yonatangross/orchestkit --plugin orkThis skill is limited to using the following tools:
Enables skills to automatically improve based on usage patterns, user edits, and success rates. Provides version control with safe rollback capability.
Improves existing Claude Code skills by fixing under/over-triggering, refining instructions, adding sub-skills, and evolving architecture based on feedback.
Analyzes skill executions from conversation friction, file diffs, user feedback, diagnostics, and lessons to propose concrete improvements to SKILL.md files for efficiency.
Autonomously optimizes Claude Code skills by iteratively running them on test inputs, scoring against binary evals, reflecting on failures to mutate prompts, and archiving improvements. Invoke via /auto-optimize for skill enhancement or autoresearch.
Share bugs, ideas, or general feedback.
Enables skills to automatically improve based on usage patterns, user edits, and success rates. Provides version control with safe rollback capability.
| Command | Description |
|---|---|
/ork:skill-evolution | Show evolution report for all skills |
/ork:skill-evolution analyze <skill-id> | Analyze specific skill patterns |
/ork:skill-evolution evolve <skill-id> | Review and apply suggestions |
/ork:skill-evolution history <skill-id> | Show version history |
/ork:skill-evolution rollback <skill-id> <version> | Restore previous version |
The skill evolution system operates in three phases:
COLLECT ANALYZE ACT
─────── ─────── ───
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ PostTool │──────────▶│ Evolution │──────────▶│ /ork:skill- │
│ Edit │ patterns │ Analyzer │ suggest │ evolution │
│ Tracker │ │ Engine │ │ command │
└─────────────┘ └─────────────┘ └─────────────┘
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ edit- │ │ evolution- │ │ versions/ │
│ patterns. │ │ registry. │ │ snapshots │
│ jsonl │ │ json │ │ │
└─────────────┘ └─────────────┘ └─────────────┘
Load details: Read("${CLAUDE_SKILL_DIR}/rules/pattern-detection-heuristics.md") for tracked edit patterns and detection regexes. Load details: Read("${CLAUDE_SKILL_DIR}/rules/confidence-scoring.md") for suggestion thresholds.
Each subcommand is documented with implementation details, shell commands, and sample output. Load details: Read("${CLAUDE_SKILL_DIR}/references/evolution-commands.md")
/ork:skill-evolution — Shows evolution report for all tracked skills with usage counts, success rates, and pending suggestions.
/ork:skill-evolution analyze <skill-id> — Deep-dives into edit patterns for a specific skill, showing frequency, sample counts, and confidence scores.
/ork:skill-evolution evolve <skill-id> — Interactive review of improvement suggestions. Uses AskUserQuestion for each suggestion (Apply / Skip / Reject). Creates version snapshot before applying.
/ork:skill-evolution history <skill-id> — Shows version history with performance metrics per version.
/ork:skill-evolution rollback <skill-id> <version> — Restores a previous version after confirmation. Current version is backed up automatically.
| File | Purpose | Format |
|---|---|---|
.claude/feedback/edit-patterns.jsonl | Raw edit pattern events | JSONL (append-only) |
.claude/feedback/evolution-registry.json | Aggregated suggestions | JSON |
.claude/feedback/metrics.json | Skill usage metrics | JSON |
skills/<cat>/<name>/versions/ | Version snapshots | Directory |
skills/<cat>/<name>/versions/manifest.json | Version metadata | JSON |
Load details: Read("${CLAUDE_SKILL_DIR}/rules/auto-evolution-triggers.md") for full safety mechanisms, health monitoring, and trigger criteria.
Key safeguards: version snapshots before changes, auto-alert on >20% success rate drop, human review required, rejected suggestions never re-suggested.
Load on demand with Read("${CLAUDE_SKILL_DIR}/references/<file>"):
| File | Content |
|---|---|
evolution-commands.md | Subcommand implementation, shell commands, and sample output |
evolution-analysis.md | Evolution analysis methodology |
version-management.md | Version management guide |
Load on demand with Read("${CLAUDE_SKILL_DIR}/rules/<file>"):
| File | Content |
|---|---|
pattern-detection-heuristics.md | Edit pattern categories and regex detection |
confidence-scoring.md | Suggestion thresholds and confidence criteria |
auto-evolution-triggers.md | Safety mechanisms and trigger criteria |
ork:configure - Configure OrchestKit settingsork:doctor - Diagnose OrchestKit issuesfeedback-dashboard - View comprehensive feedback metrics