agent-authoring
Use when creating or reviewing Agent Deck agents, including frontmatter, tools, supervisor behavior, continuation behavior, and skill assignment.
npx skills add a-streetcoder/agent-deck --skill agent-authoring --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Agent Deck Agent Authoring Use this skill when creating or reviewing Agent Deck agent markdown files. ## Agent file shape Agents are Markdown files with YAML frontmatter and a compact role prompt body: ```markdown --- name: example-agent description: Short human/UI summary of what this agent does whenToUse: Use for the precise delegation condition that should make the parent choose this agent. tools: read, grep, find, ls, bash, contact_supervisor thinking: high systemPromptMode: replace defaultExpectedOutcome: reportOnly skills: agent-authoring --- You are `example-agent`, an Agent Deck specialist agent. Describe the role-specific workflow, validation expectations, and return format here. ``` ## Prompt composition Agent Deck composes the runtime system prompt as the agent body followed by common child-session rules. The appended common rules cover completing only the assigned task, preserving parent/user decision authority, avoiding further delegation, supervisor-contact behavior, and final-result handling. Do not repeat those generic boundaries in the agent body unless the role needs a specific variation. Keep the agent body focused on: - role identity and scope - role-specific
- Agent file shape
- Prompt composition
- Required decisions
- Scope rules
- Routing metadata rules
- Skill rules
- Supervisor guidance
- Good defaults
What does the agent-authoring skill do?
Use when creating or reviewing Agent Deck agents, including frontmatter, tools, supervisor behavior, continuation behavior, and skill assignment.
How do I install it?
Run `npx skills add a-streetcoder/agent-deck --skill agent-authoring --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From a-streetcoder/agent-deck, a repository with 88 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.