skill-improver
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.
How do I install this agent skill?
npx skills add https://github.com/heyvhuang/ship-faster --skill skill-improverIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is safe. It is designed to analyze execution logs and suggest improvements for AI agent skills. The skill involves processing log files and generating patches for markdown files, which are standard operations for an improvement utility.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
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>/(oropenspec/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
- Read
logs/state.jsonandlogs/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)
- Check artifact contracts:
- Whether each step has persisted output
- Whether only paths are passed instead of content
- Whether there are inconsistent naming/paths
- 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/heyvhuang/ship-faster/skill-improver">View skill-improver on skillZs</a>