mcpField
S
skill-improver

skill-improver

github.com/heyvhuangAgent workflows33853 installsUpdated 30w ago
Repository

About skill-improver

skill-improver analyzes execution artifacts to suggest improvements to Skills and Workflows. It identifies failures, bottlenecks, confirmation issues, and artifact-contract gaps, then provides prioritized recommendations and optionally a minimal patch.

Key features

  1. 01Analyzes run logs and state
  2. 02Finds failures and time bottlenecks
  3. 03Checks artifact naming and persistence
  4. 04Prioritizes improvement suggestions
  5. 05Can produce a minimal skill patch

Use cases

  1. 01Improving a workflow after a run
  2. 02Identifying repeated failures or wasted steps
  3. 03Checking whether workflow artifacts are consistent

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/heyvhuang/ship-faster --skill skill-improver

After installing, type/skill-improverin Claude Code to confirm it loaded.

Details

From the project README

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)
  2. Check artifact contracts:
    • Whether each step has persisted output
    • Whether only paths are passed instead of content
    • Whether there are inconsistent naming/paths
  3. Output improvement suggestions (sorted by benefit):
    • Prompt/trigger word optimization
    • I/O contract completion (add required fields, fix artifact file names)
    • Error handling and rejection strategies
    • Suggest new deterministic scripts (only when necessary)

Output Template (recommended)

  • Overview: Core issues from this run
  • Top Issues (high → low): Each includes "symptom/root cause/fix suggestion/related skill/suggested change point"
  • Suggested Minimal Change List: Listed by file

Comments

Markdown supported