---
name: skill-creator-improvement
description: Improves skill-creator generated skills by updating SKILL.md Gotchas and verified examples with reusable learnings. Use after using a generated skill if the interaction revealed custom fields, service quirks, faster workflows, corrected commands, or safer usage patterns.
---

# skill-creator improvement

Use this skill proactively after using a skill generated by `@asnd/skill-creator` when you discover reusable knowledge that would make future use faster or safer.

## Safety boundary

Only edit skills tracked in `~/.skill-creator/lock.json` or `${SKILL_CREATOR_HOME}/lock.json` when that environment variable is set.

Before editing:

1. Identify the generated skill directory you used.
2. Read the lock file.
3. Confirm the target skill path or `agent:scope:name` entry is present.
4. If the skill is not tracked, do not modify it. Tell the user it is outside skill-creator management.

## What to improve

Add concise, verified learnings directly to the target skill's `## Gotchas` section when real usage reveals:

- stable custom fields, IDs, project keys, registry names, or instance-specific mappings
- service quirks that caused failed or repeated discovery
- faster command chains that worked
- corrected command examples or safer flags
- output filters, pagination, or bounded-query patterns that reduce noise

## Editing rules

- Keep `SKILL.md` concise and hot-path useful.
- Prefer short bullets in `## Gotchas`.
- Add only reusable knowledge verified by actual use.
- Do not add secrets, tokens, raw API responses, huge outputs, or one-off task details.
- Do not rewrite the whole skill unless necessary.
- Ask before changing destructive workflows, auth behavior, source URLs, install scope, or anything that could affect production data.

## Workflow

1. Read the target `SKILL.md`.
2. Locate `## Gotchas`; create it if missing.
3. Add or update the smallest useful bullet(s).
4. Update verified examples or usage rules only when a command example changed and was smoke-tested.
5. Briefly report what changed and why.

## Gotchas

- The lock file is the source of truth for whether this skill may edit another skill.
- Important learnings belong in `SKILL.md`, not only in references, because agents rarely read references unless prompted.