Skill Store 33

Skill Improver

Improve skills and workflows by analyzing run artifacts and execution logs (events.jsonl/state.js…

by heyvhuang · MIT

The skill

Improve skills and workflows by analyzing run artifacts and execution logs (events.jsonl/state.json) under runs/ (or OpenSpec changes/). Use when you want to iterate on skills based on real runs: find failure modes, bottlenecks, unclear prompts, missing I/O contracts, and propose concrete edits.

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

Use this skill

Connect your agent to the Skill Store MCP server and ask for it by ref: heyvhuang/skill-improver-66257952035.

Download SKILL.md · Markdown version

Details

Publisher
heyvhuang
Category
AI & Agents › Skill & prompt authoring
License
MIT
Updated
2026-04-04

References

More from heyvhuang

  • Review Clean Code Analyze code quality based on "Clean Code" principles.
  • Review Doc Consistency Documentation consistency reviewer that checks alignment between code implementation and document…
  • Review Merge Readiness Request/execute structured code review: use after completing important tasks, at end of each exec…
  • Workflow Execute Plans Execute written implementation plans: first read and critically review the plan, then implement i…

Related skills

  • Skill Writing Write and improve agent skills (SKILL.md files).
  • Skill Upper Capture and review Agent Skill observations, and create, run, diagnose, or iteratively improve Sk…
  • Test Skill Use when creating or editing skills, before deployment, to verify they work under pressure and re…
  • Skill Logger Logs and scores skill usage quality, tracking output effectiveness, user satisfaction signals, an…
  • Skill Creator Use this skill when creating a new Claude skill from scratch, editing or improving an existing sk…