skill-improver

Installation
SKILL.md

Skill Improver

Retrospect and improve Skills/Workflows based on real execution artifacts, making the skill chain more stable with use.

Input (pass path only)

  • run_dir: runs/<workflow>/active/<run_id>/ (or openspec/changes/<change-id>/)

Output

  • improvements.md: Improvement suggestions (can be directly converted to change tasks)
  • Optional: Minimal patch to relevant SKILL.md (only change what's necessary)

Process

  1. Read logs/state.json and logs/events.jsonl, extract:
    • Failure points (error types, frequency, missing context)
    • Time bottlenecks (repetitive steps, ineffective searches, excessive context)
    • Manual confirmation points (whether too early/too late/missing)
Related skills

More from heyvhuang/ship-faster

Installs
49
GitHub Stars
338
First Seen
Feb 10, 2026