skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
heyvhuang/ship-faster53 installs

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-improver
view source ↗

Is 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>/ (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

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>