Prompt Brief — Development skill for Claude Code

prompt-brief

[](https://skills.sh/bragai/prompt-brief)

An agent skill that makes your coding agent write the brief before it writes the code.

A brief is a prompt you paste back to the agent as the task. It is the difference between "redesign the billing page" and a page-long spec that names the files, the states, the copy, the rules that must hold, and how to check the result. The agent researches the codebase, writes the brief, and stops. You read it, edit it, and paste it back. The run that follows needs no clarifying questions, and anyone can check the result against the brief afterwards.

It follows the [Agent Skills](https://agentskills.io) format, so it works with Claude Code, Codex, Cursor, Gemini CLI and every other agent the [`skills`](https://github.com/vercel-labs/skills) CLI supports. From the team building [BragAI](https://bragai.dev).

Install

npx skills add bragai/prompt-brief

For one agent only, or into your user directory so every project has it:

npx skills add bragai/prompt-brief -a claude-code
npx skills add bragai/prompt-brief -g

Use

Ask for a brief in plain words:

Write me a brief for the settings page. It should feel like the rest of the app.

I want thumbs up / thumbs down on every answer. Use the same prompting approach.

Or invoke it by name, with the ask after it:

/prompt-brief move invoice PDF generation off the request path: a queue with retries and a dead-letter table, idempotent on invoice id, a status endpoint the page can poll, a webhook when the file is ready, and a backfill for the invoices already stored

The agent replies with the brief and nothing else. When it reads right, paste the whole thing back as your next message. That is the task.

What the agent does

1. Pins the subject. One line: the surface or feature, who it is for, and its single job.
2. Learns the house rules. Reads CLAUDE.md or AGENTS.md