bragai

Prompt Brief — Development skill for Claude Code

Development community

An agent skill that writes a brief before the work: subagents map the code, then the agent drafts a paste-back prompt with a thesis, scope, non-negotiables and verification.

How to install Prompt Brief

This entry records only its repository, not the path inside it, so there is no exact command to give. Open bragai/prompt-brief and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Prompt Brief does

An agent skill that writes a brief before the work: subagents map the code, then the agent drafts a paste-back prompt with a thesis, scope, non-negotiables and verification. Works with Claude Code, Codex, Cursor and any skills-CLI agent. Install: npx skills add bragai/prompt-brief

Alternatives in Development

Last30days Skill — Claude Code skill that researches any topic across Reddit + X from the last 30 days, then writes copy-paste-re 4.4k ★
HERO Anti OverDefense — HERO = Hashing · Edge cases · Rubrics · Overbuild — the four shapes coding agents over-defend in 333 ★
Explore Idea — Collaborative exploration and brainstorming for new project ideas 88 ★

README

prompt-brief

[![Installs](https://skills.sh/b/bragai/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

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