askit-build-subagentlisted
Install: claude install-skill product-on-purpose/agent-skills-toolkit
# askit-build-subagent
## Purpose
Author conformant subagents. Two modes: `create` scaffolds a new `agents/<name>.md` (frontmatter + role body); `improve` raises an existing subagent toward the quality bar. Subagents are Claude-only for plugin distribution (Codex v0.135 plugins cannot ship `[agents.*]`; Standard sec 3.3), so this skill emits no Codex artifact. Authoring depth is in [references/authoring-subagents.md](references/authoring-subagents.md).
## When to use
When the user asks to create, scaffold, write, or improve a subagent (an `agents/<name>.md` delegate).
## create mode
1. Brief interview: ask for the subagent name (kebab-case), the bounded job it owns, the narrowest tools it needs, and which components (if any) it may invoke. Skip the interview if these inputs are already in context.
2. Copy `templates/agent.md` into `agents/<name>.md`.
3. Fill the frontmatter: `name` equal to the file basename; a `description` that states what AND when (Standard sec 8.1); `tools` as the narrowest set (sec 9); optional `model`; `chain` listing components it may invoke (omit if none); `metadata.version`, `metadata.tier`, `metadata.status`, and `metadata.agent-targets: [claude]` (sec 3.3 - subagents are Claude-only for plugin distribution).
4. Register the subagent in `library.json` `components.subagents` as `{ name, path, version, tier, status }`.
5. If the subagent declares a `chain`, add the entry to `agents/_chain-permitted.yaml` (`<name>: [<invoked>, ...]`) so S4 has no or