update-agent

Provide an exact agent path, name, or glob selector and optionally a --changes description. The skill snapshots the target's expertise and triggers, reconciles base.md and the four frontmatter JSON files with the current template, then verifies the result with the stitch helper for all three harnesses.

Pass a glob selector or explicit --all flag for repository-wide work; an empty selector never means all. Independent targets can be delegated in bounded batches of one agent source set per subagent, within the declared child-spawn budget.

update-agent handles bounded migrations and corrections to existing, explicitly selected agent definitions. create-agent owns genuinely new roles; any request that actually creates a new role is rejected and routed there.

Yes. The workflow snapshots owned outcomes, positive and negative triggers, expertise, and working voice before editing, then integrates approved changes into existing prose rather than appending boilerplate. Completion requires no unrequested role, voice, permission, or ownership change.

Common causes include malformed JSON, obsolete keys, a tools allowlist that should be omitted, or initialPrompt disagreeing with base.md. Parse all four JSON files with python -m json.tool and re-run the stitch helper for each harness to locate the failing check.