enhance-skill-by-derailment
Enhance Skill by Derailment
Improve a skill by making a subagent use it on a real task, reading the execution trace for friction, and fixing the skill text where it broke.
When to use
Use this skill if you are:
- testing whether a SKILL.md actually holds up when an agent uses it ("test my skill", "is this skill any good", "does this skill work")
- hardening an existing skill before publishing it or relying on it
- diagnosing why an agent keeps drifting, guessing, or stalling on a skill that "should" work
- running a derailment / friction-trace pass on a draft skill
- post-edit verifying that a fix to a skill actually closed the friction it was meant to close
- deciding which lines, examples, or routing cues in a skill are load-bearing vs dead weight
Do NOT use this skill if you are:
- creating a new skill from scratch — use
synthesize-skills - rewriting a one-off task prompt for an agent (not a skill) — that is out of scope for this pack
More from yigitkonur/skills-by-yigitkonur
run-research
Use skill if you are answering one technical research question with current web evidence, Reddit practitioner experience, and source-backed synthesis, optionally fanned out across parallel subagents.
42run-agent-browser
Use skill if you are driving the agent-browser CLI for ad hoc browser automation — @ref snapshots, sessions, forms, extraction, screenshots, headed/stealth, or provider runs.
38publish-npm-package
Use skill if you are publishing to npm via GitHub Actions release workflow with trusted publishing, NPM_TOKEN, provenance, semantic-release, changesets, release-please, or fixing npm publish CI.
35init-agent-config
Use skill if you are creating, auditing, or migrating CLAUDE.md, AGENTS.md, or REVIEW.md instruction files, folder-scoped agent guidance, or cross-agent companion entrypoints.
34build-mcp-use-server
Use skill if you are building TypeScript MCP servers with mcp-use/server — server.tool, response helpers, ctx.auth, sessions, transports, widgets, Inspector, deploy.
34build-skills
Use skill if you are creating or substantially revising a Claude skill and need workspace-first evidence, remote comparison, and repo-fit synthesis before writing SKILL.md.
32