askit-build-subagent
Creates and improves Claude subagents (agents/<name>.md) to the Advanced Skill Library Standard. Use when you need to author a new subagent, scaffold an agents/ delegate, declare its tools and chain, or raise an existing subagent's conformance.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- askit-build-subagent
- metadata
- { "tier": "universal", "version": "0.2.3", "audience": "intermediate" }
- description
- Creates and improves Claude subagents (agents/<name>.md) to the Advanced Skill Library Standard. Use when you need to author a new subagent, scaffold an agents/ delegate, declare its tools and chain, or raise an existing subagent's conformance.
02 资源文件 3
- 参考文档examples/golden-1-samples-validator-subagent.md9.6 KB
- 参考文档README.md602 B
- 参考文档references/authoring-subagents.md1.6 KB
03 SKILL.md 正文
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.
When to use
When the user asks to create, scaffold, write, or improve a subagent (an agents/<name>.md delegate).
create mode
- 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.
- Copy
templates/agent.mdintoagents/<name>.md. - Fill the frontmatter:
nameequal to the file basename; adescriptionthat states what AND when (Standard sec 8.1);toolsas the narrowest set (sec 9); optionalmodel;metadata.chainnaming the components it may invoke as a comma-separated string (the recommended shape - a YAML list is silently coerced to a string repr by the reference implementation, seeauthoring-chain-contracts.md; omitchainif there is none);metadata.version,metadata.tier,metadata.status, andmetadata.agent-targets: [claude](sec 3.3 - subagents are Claude-only for plugin distribution). - Do not write
hooks,mcpServers, orpermissionMode. Claude Code states plainly that "for security reasons, plugin subagents don't support thehooks,mcpServers, orpermissionModefrontmatter fields" (subagents documentation, read 2026-09-28). Writing one does not configure anything; the runtime ignores it, and the author is left believing otherwise. The runtime also ignoresinitialPrompton a plugin agent (plugin components), so leave that out too. The supported set isname,description,model,effort,maxTurns,autoCompactWindow,tools,disallowedTools,skills,memory,background,omitClaudeMd,isolation(whose only valid value isworktree),color, and thecacheTtlkey ofexperimental. Marketplace scope reports this across every member of a catalogue. - Register the subagent in
library.jsoncomponents.subagentsas{ name, path, version, tier, status }. - If the subagent declares a
chain, add the entry toagents/_chain-permitted.yaml(<name>: [<invoked>, ...]) so S4 has no orphan. - Assess with
node scripts/evaluate.mjs . --jsonand iterate until 0 errors (S3 components index + S4 chain contract must be clean).
improve mode
- Run
node scripts/evaluate.mjs . --jsonand read the report. - For each finding: an S3 error -> declare/undeclare the subagent in
components.subagentsto match disk; an S4 orphan -> add the missingcaller -> calleetoagents/_chain-permitted.yaml; an S4 phantom (the contract names a component not on disk) -> remove that contract entry, fix a misspelled name, or create the missing component. For any other finding, read its message and apply the fix it states. - Re-run evaluate to confirm.
Scope
Claude-only: a subagent is agents/<name>.md (Claude auto-discovers it). Codex does not ingest plugin-shipped subagents (Standard sec 3.3), so there is no Codex render. Authoring is performed inline by the running agent; the toolkit's own askit-skill-author subagent is the delegated authoring role for skills.
04 同仓库更多 Skills
fx-demo
A fixture skill that exists so the re-derived manifest has a component list to compare. Use only from tests/unit/self-consistency.test.mjs.
fx-demo
A fixture skill that exists so the re-derived manifest has a component list to compare. Use only from tests/unit/self-consistency.test.mjs.
fx-demo
A fixture skill that exists so the re-derived manifest has a component list to compare. Use only from tests/unit/self-consistency.test.mjs.
sf-caller
Calls the worker subagent to do a thing. Use when delegating work to sf-worker.
sf-do-thing
Converts CSV input into a formatted summary. Use when the user asks to summarize or tabulate spreadsheet data.
root-skill-plugin
Summarizes a changelog section into one release-note sentence. Use when the user asks to condense a list of changelog bullets into a single announcement line.