improve-selflisted

Detect when a missing Agent Skill would have made the current task faster or more reliable, then scaffold a candidate SKILL.md for user review. Use after a non-trivial task when one of these signals fires: the same procedure repeated 3+ times, error recovery required inventing a workflow, the user corrected the approach (not the answer), the agent realized mid-task that a playbook did not exist, or 5+ tool calls produced what should have taken 1-2. Detects which `.{vendor}/` directories exist on the host (project and home), reads every skill and slash command in them before proposing, and never duplicates. Writes candidates into the project's .{vendor}/skills/{name} directory that the running host actually loads, never the home folder. Do NOT use for first-attempt failures, one-off questions, fact gaps that belong in research, or style gaps that belong in rules files. Pass the trace and the signal that fired as arguments; the skill does not reconstruct them from the conversation.
sergeyklay/.agents · ★ 5 · AI & Automation · score 80

Install: claude install-skill sergeyklay/.agents

# Improving Self by Closing Skill Gaps This skill turns the trace of just-completed work into a question: *was there a procedure I should have had written down?* When the answer is yes, it scaffolds a candidate Agent Skill into the current project — with the human approving every write. The discipline is conservative by design. A skill created for a one-off question becomes long-term noise in the activation context of every future task. A skill created without checking existing skills becomes a duplicate and a confusion vector. A skill encoding version-specific or transient behavior becomes a permanent footgun. The bar for creation: a concrete, recurring, procedural gap that survived a check against every existing skill, with the user signing off on the draft. ## Running scripts bundled with this skill Script paths are resolved relative to **this** SKILL.md, not the agent's CWD. If a relative command (for example `python3 scripts/discover_skills.py`) fails to resolve, prefix it with the directory the platform loaded SKILL.md from. **Fallback.** If `python3` is missing or the script cannot be located, every procedure here ships a manual alternative — follow that instead. ## What counts as a gap A gap is **procedural and recurring**. Not every difficulty is a gap. | Pattern in the trace | Skill-shaped? | |---|---| | The agent repeated the same 3-step lookup three times in one task | Yes | | The agent figured out a non-obvious investigation workflow from scratch and it w