Skip to content
Skills Library
AI & agents · Writing

draft-agent-brief

/draft-agent-brief

Use this skill when the user wants to create a new agent and has a clear business goal but isn't fluent in the agent's target domain. Walks them through producing a strong brief by filling in `templates/agent-brief.md` from their plain-language description, then iterating once or twice before building or dispatching the agent. Triggers when the user asks for "a new agent that does X" without already supplying the technical spec, or when they've filled the brief template and left blanks where they didn't know.

Repository
ravenclaude ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use this skill when the user wants to create a new agent and has a clear business goal but isn't fluent in the agent's target domain. Walks them through producing a strong brief by filling in `templates/agent-brief.md` from their plain-language description, then iterating once or twice before building or dispatching the agent. Triggers when the user asks for "a new agent that does X" without already supplying the technical spec, or when they've filled the brief template and left blanks where they didn't know.

Triggers from the description

t fluent in the agenta new agent that does Xve filled the brief template and left blanks where they didn
Original author description

Use this skill when the user wants to create a new agent and has a clear business goal but isn't fluent in the agent's target domain. Walks them through producing a strong brief by filling in `templates/agent-brief.md` from their plain-language description, then iterating once or twice before building or dispatching the agent. Triggers when the user asks for "a new agent that does X" without already supplying the technical spec, or when they've filled the brief template and left blanks where they didn't know.

How it works

  1. When to use this skill
  2. The workflow
  3. The principle
  4. See also
Original SKILL.md headings · 45 lines, 493 words
SKILL.md preview
---
name: draft-agent-brief
description: Use this skill when the user wants to create a new agent and has a clear business goal but isn't fluent in the agent's target domain. Walks them through producing a strong brief by filling in `templates/agent-brief.md` from their plain-language description, then iterating once or twice before building or dispatching the agent. Triggers when the user asks for "a new agent that does X" without already supplying the technical spec, or when they've filled the brief template and left blanks where they didn't know.
---

# Skill: draft-agent-brief

A repeatable workflow for **producing a strong agent brief when the user knows what they want in business terms but doesn't yet have the domain expertise to write the technical spec themselves.**

## When to use this skill

- The user asks for a new agent and isn't fluent in the agent's target domain.
- The user has filled in `templates/agent-brief.md` and left blanks where they didn't know.
- The user has described a goal in plain words and asked Claude to *"draft a strong request for me."*

## The workflow

1. **Listen for the goal in business terms.** What does the user actually want this agent to do for them? Keep them out of technical territory if they're new to the domain.

2. **Identify the domain.** What world does this agent live in (Power Platform, Salesforce, web dev, iOS, etc.)? If unclear, ask **once**.

3. **Draft a strong brief** — fill in the eight fields of [`templates/agent-brief.md`](../../templates/agent-brief.md):
   - **Outcome** (in business terms)
   - **Context** (the user's situation, including their experience level)
   - **Domain familiarity** (so the agent knows whether to over-explain)
   - **Success criteria** (concrete, in business terms)
   - **Out of scope** (anti-goals)
   - **Constraints** (hard requirements)
   - **Personality / style** (terse, conservative, asks-when-ambiguous, etc.)
   - **Judgment level → model tier** (`haiku` for read-a-lot-return-a-little, `sonnet` for bounded well-specified work, `opus` only for design / adjudication / merge gates — the tier table in [`knowledge/model-tier-delegation.md`](../../knowledge/model-tier-delegation.md); when the user is unsure, describe the output shape and default to the cheaper tier)

4. **Show the draft to the user** with a clear *"here's what I wrote based on what you told me — does this fit?"* prompt.

5. **Iterate.** Expect one or two rounds of *"yes, but change X."* Don't push back on changes that move toward the user's actual intent.

6. **Once approved, build (or dispatch) the agent.** The brief becomes the system prompt or the agent definition, depending on whether this is a one-shot dispatch or a permanent role. Field 8 becomes the `model:` line — a permanent agent **must** carry it (a tier alias, never a full model id; the marketplace's `check-frontmatter.py` CI gate fails the build without it), and a one-shot dispatch passes it as the `model` parameter so the worker does not silently inherit the session's frontier model.

## The principle

**The user brings the *what* and *why*. Claude brings the *how*.**

A non-domain-expert user can absolutely write a strong brief — they just need help filling in the domain-specific bits. This skill keeps that division of labor explicit so neither side is asked to do the other's job.

## See also

- [`templates/agent-brief.md`](../../templates/agent-brief.md) — the eight-field template the user fills in (or leaves blank for Claude to fill).
- [`templates/agent-definition-template.md`](../../templates/agent-definition-template.md) — the gated frontmatter block (`name` / `description` / `tools` / `model` / scenarios) a permanent agent is built from.
- [`agents/architect.md`](../../agents/architect.md) — example of a finished, role-style agent definition produced by this kind of brief.

Versions

The database has no other skills named draft-agent-brief.

Database snapshot: 13.11.2026 · package version e8578ed4db03 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100forge-agent
    Brief, build, and prove a new agent (Claude Code subagent/skill, Cursor agent, Agent SDK, Python/LangGraph, scheduled job) before it ships. Use when the user types /forge-agent, says "create/build/design/spec/scaffold an agent", "brief an agent", "ask me the agent questions", or…
  • 85cmd-210-write-a-brief-another-agent-can-follow
    Write a self-contained brief for another agent: goal, inputs and where they are, what done looks like, deadline, limits, when to stop and ask, and what to return, with no secrets and no instructions copied from outside text. Use whenever you hand a task to another agent or draft…
  • 100brief
    Generate a structured delegation brief. Use when assigning a task, handing off work, or briefing a sub-agent.
  • 100create-agent
    Create a new custom agent for the workspace. Guides the user through defining agent name, domain, personality, skills, model, and memory folder. Use when the user says 'create an agent', 'new agent', 'add an agent', 'I need a custom agent', or wants to create a specialized agent…
  • 100dispatch-authoring
    Write the structured handoff from a planning session to a coding agent: a dispatch with a header, Gate 0 checks, scope, specification, verification, delivery rules, and stop conditions, so the agent can execute unattended and return a reviewable draft PR. Use this skill whenever…
  • 100run-kit
    Reference for running the technical team — the roster (who does what, writes what), the pipeline workflow commands, how to write a brief, the .team/ workspace with its templates, and the handoff every agent returns. Load it when running a pipeline, writing a brief, reading a…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.