write-agent

Creates or edits Claude Code agent definitions through interview, template, and independent review.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/sagittaras/agentic-workflow --skill write-agent-sagittaras
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-agent
Source: https://github.com/sagittaras/agentic-workflow/tree/main/skills/write-agent
Command: npx skills add https://github.com/sagittaras/agentic-workflow --skill write-agent-sagittaras

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a well-configured Claude Code agent requires choosing the right role name, model, effort, maxTurns, and tool permissions, plus a three-part description that avoids triggering collisions with neighboring agents. This Skill guides that process end to end so the resulting agent definition holds up in real project operation. ## Core Features & Use Cases - Structured interview and project vocabulary discovery: Scans README, CONTRIBUTING, CODEOWNERS, and existing agents to name the role after one that would genuinely exist on the project, then interviews the user about mandate, triggering, tools, and memory. - Matrix-based configuration: Assigns model, effort, and maxTurns from a binding decision matrix that accounts for role difficulty and invocation frequency, with mandatory frontmatter comments justifying every omitted field. - Independent review loop: Submits the finished agent to a clean-context review subagent, autonomously processes blocking findings across rounds, and escalates to the user only on mandate disputes or repeated failures. - Use Case: A user says "I need someone to own release decisions on this project." The Skill discovers the project's role vocabulary, interviews about the release manager's mandate, writes .claude/agents/release-manager.md per the template, and iterates with a reviewer until approved. ## Quick Start Ask the assistant to create a new agent for a role your project needs, for example by saying "create an agent that owns release decisions for this project".

Frequently Asked Questions about write-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Claude Code subagent for my project?

Invoke the write-agent skill with the role or topic as an argument. It scans your project's role vocabulary, interviews you about mandate and triggering, writes the definition to .claude/agents/<name>.md following a mandatory template, and runs an independent review loop before finishing.

How do I choose model, effort, and maxTurns for an agent?

The skill applies a decision matrix based on role difficulty, invocation frequency, and run boundedness. Judgment-heavy reviewers get opus with xhigh effort, mechanical roles get haiku without effort, and frequent automatic invocation shifts the selection one tier down.

When should I write a skill instead of an agent?

Choose a skill when the work is a repeatable procedure with known steps whose result does not depend on domain judgment. Choose an agent when someone must own an area and decide in unscripted situations. The skill explicitly refuses to create an agent when a procedure suffices.

Can the skill edit an existing agent definition?

Yes. It reads the existing agent fully before interviewing, narrows the interview to what changes, preserves prior frontmatter decisions, and sends the modified file through the same independent review loop as a new agent.

Why does the agent description need a negative boundary?

The description is the only text the orchestrator uses to decide delegation. Without a third part stating when not to call the agent, neighboring agents compete for the same tasks and delegation becomes arbitrary, so boundaries must be defined on both sides.