Brief
alirezarezvani/claude-skills
/cs:brief <topic — Generate a one-page strategy brief from an office-hours intake.
Interview the user with sharp, one-at-a-time questions to turn a vague request into a tight, complete brief any other skill can run on.
MITAuto-check passed
Install Brief Builder
$ npx skills add mohitagw15856/pm-claude-skills --skill brief-builder -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install mohitagw15856/pm-claude-skills brief-builder --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/brief-builder .claude/skills/brief-builder && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "brief-builder" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/brief-builder into .claude/skills/brief-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brief-builder", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/brief-builderType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add mohitagw15856/pm-claude-skills --skill brief-builder -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install mohitagw15856/pm-claude-skills brief-builder --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/brief-builder .agents/skills/brief-builder && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "brief-builder" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/brief-builder into .agents/skills/brief-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brief-builder", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mohitagw15856/pm-claude-skills --skill brief-builder -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install mohitagw15856/pm-claude-skills brief-builder --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/brief-builder .cursor/skills/brief-builder && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "brief-builder" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/brief-builder into .cursor/skills/brief-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brief-builder", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/mohitagw15856/pm-claude-skills.git --path skills/brief-builder--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add mohitagw15856/pm-claude-skills --skill brief-builder -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install mohitagw15856/pm-claude-skills brief-builder --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/brief-builder .gemini/skills/brief-builder && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "brief-builder" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/brief-builder into .gemini/skills/brief-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brief-builder", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install mohitagw15856/pm-claude-skills brief-builderInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add mohitagw15856/pm-claude-skills --skill brief-builder -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/brief-builder .github/skills/brief-builder && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "brief-builder" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/brief-builder into .github/skills/brief-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brief-builder", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mohitagw15856/pm-claude-skills --skill brief-builder -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install mohitagw15856/pm-claude-skills brief-builder --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/brief-builder .opencode/skills/brief-builder && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "brief-builder" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/brief-builder into .opencode/skills/brief-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brief-builder", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
brief-builder- GitHub stars
- 1.4k
- Token cost
- ~1.1k tokens
- SKILL.md length
- 606 words
- Files
- 1
- Skills in repo
- 1,348
- Repo updated
- First seen
- Licence
- MIT
At a glance
Interview the user with sharp, one-at-a-time questions to turn a vague request into a tight, complete brief any other skill can run on.
- Works in 3 steps: The questions (interactive) → The brief (once enough is gathered) → Handoff
- A request is fuzzy
- SKILL.md covers Required Inputs, How to run this skill (the…, Output Format and Quality Checks, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Brief Builder is an agent skill from mohitagw15856/pm-claude-skills. Interview the user with sharp, one-at-a-time questions to turn a vague request into a tight, complete brief any other skill can run on. Use when a request is fuzzy, under-specified, or 'help me think this through', or before running a skill that needs inputs the user hasn't given. Produces a structured brief (goal, audience, constraints, success criteria) and hands off to the right skill — by interrogating, not guessing.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.
When your agent uses it
- A request is fuzzy
- Under-specified
- Help me think this through
- Before running a skill that needs inputs the user hasnt given
Example prompts
- “help me think this through”
- “/brief-builder”
Workflow steps
3 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Brief Builder loads about 1.1k tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 606 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 606 words, ~1,139 tokens.
Download SKILL.mdSave it as
.claude/skills/brief-builder/SKILL.md (or your agent's skills folder).- name
- brief-builder
- description
- Interview the user with sharp, one-at-a-time questions to turn a vague request into a tight, complete brief any other skill can run on. Use when a request is fuzzy, under-specified, or 'help me think this through', or before running a skill that needs inputs the user hasn't given. Produces a structured brief (goal, audience, constraints, success criteria) and hands off to the right skill — by interrogating, not guessing.
Brief Builder Skill
Most weak AI output comes from a weak brief — the model guessed at context instead of getting it. This skill flips that: it interviews the user with focused questions, one or two at a time, following up where answers are thin, until it has enough to produce excellent work. Then it writes the brief and hands off. The whole value is asking the right questions in the right order — not producing on the first vague sentence.
Required Inputs
- The raw ask — whatever the requester actually said, however vague ("we need a dashboard", "marketing wants a one-pager"). Verbatim beats paraphrased; the gaps in their words are the interrogation map.
- Who is asking and who will consume the output (if known) — the same ask from a CEO and an intern needs different briefs.
- Optional: any prior artifacts the ask relates to (the doc being replaced, the thread that sparked it).
How to run this skill (the interrogation loop)
- Read what they gave you and identify the task type (a launch? a doc? a decision? a piece of copy?).
- Ask the smallest set of high-leverage questions first, ONE or TWO at a time — never a 20-question wall. Lead with the questions whose answers most change the output.
- Follow up when an answer is vague ("everyone" → "who specifically?"; "soon" → "what date?"). Dig until it's concrete.
- Offer defaults: when the user doesn't know, propose a sensible default and let them confirm ("I'll assume B2B SaaS founders unless you say otherwise").
- Stop when you have enough — don't over-interview. Then summarize the brief and confirm before producing.
The question backbone (adapt to the task)
- Goal — what does success look like? What decision or action should this drive?
- Audience — who is this for, specifically? What do they already know / believe?
- Context — what exists already? What's the backstory, the constraint, the deadline?
- Scope & format — how long, what format, where will it live?
- Voice & guardrails — tone, must-says, can't-says, examples to match.
- Success criteria — how will they judge if the output is good?
Output Format
1. The questions (interactive)
Ask them conversationally, batched 1–2 at a time, easiest path first. (Do not dump the whole list at once.)
Show full SKILL.md (241 more words)Show less
2. The brief (once enough is gathered)
Brief: [task]
- Goal: …
- Audience: …
- Context / inputs: …
- Scope & format: …
- Voice & guardrails: …
- Success criteria: …
- Open assumptions: anything still defaulted, flagged for confirmation.
3. Handoff
Name the skill (or skills) this brief should now feed (e.g. "→ run prd-template" or "→ landing-page-copy"), and offer to proceed.
Quality Checks
- Questions are asked a few at a time, highest-leverage first — not a giant wall
- Vague answers are followed up until concrete (named audience, real dates, specifics)
- Sensible defaults are offered when the user is unsure, and labeled as assumptions
- The interview stops once there's enough — it doesn't over-interrogate
- The final brief is complete enough that another skill could produce great output from it alone
- It ends by handing off to the right skill(s)
Anti-Patterns
- Do not produce the deliverable yourself from a vague prompt — the job is to build the brief first
- Do not dump 15 questions at once — pace them, lead with what matters most
- Do not accept vague answers — "more sales", "everyone", "soon" all need a follow-up
- Do not interrogate forever — once you can write a strong brief, stop and summarize
- Do not silently assume — when you default, say so and let the user correct it
Based On
Creative/agency briefing practice and structured-elicitation interviewing (decision-tree questioning, progressive disclosure, confirm-before-produce).
Example Trigger Phrases
- "Help me think this through."
- "Ask me questions until the brief is clear."
- "Turn my vague idea into a proper brief."
- "Interview me before you write anything."
© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/brief-builder of mohitagw15856/pm-claude-skills.
Open the folder on GitHubat commit 1cbf1f0
Compare with similar skills
Brief Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Brief Builder this skillmohitagw15856/pm-claude-skills | 1.4k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Briefalirezarezvani/claude-skills | 28k | — | ~967 | Automated safety check: Pass | MIT | |
| Interviewcodewhale-hq/Codewhale | 41k | — | ~232 | Automated safety check: Pass | MIT | |
| Interviewalirezarezvani/claude-skills | 28k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Interview Meaddyosmani/agent-skills | 103k | 6 repos | ~3.8k | Automated safety check: Pass | MIT | |
| Interview Coachsickn33/agentic-awesome-skills | 47k | 2 repos | ~751 | Automated safety check: Pass | MIT |
Similar skills
Interview
codewhale-hq/Codewhale
Ask one useful structured question at a time only when material product/implementation choices are genuinely missing; remember answers and produce a brief/spec.
Interview
alirezarezvani/claude-skills
Phase 1 of building a Claude Managed Agent — interview the founder about the one job the agent should do, then produce a build sheet (CMA primitives table + v1/v2 deferrals + eval plan) WITHOUT…
Interview Me
addyosmani/agent-skills
Asks one question at a time, each with a best guess attached, until the agent is about 95 percent sure what you really want, before any plan, spec or code.
Interview Coach
sickn33/agentic-awesome-skills
Full job search coaching system — JD decoding, resume, storybank, mock interviews, transcript analysis, comp negotiation.
Interview
Q00/ouroboros
Socratic interview to crystallize vague requirements. An agent skill from Q00/ouroboros.
More from mohitagw15856/pm-claude-skills
All 1,348 skills in this repoCar Tco
mohitagw15856/pm-claude-skills
Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…
Cs Health Scorecard
mohitagw15856/pm-claude-skills
Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.
Exit Waterfall
mohitagw15856/pm-claude-skills
Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.
Feature Prioritisation
mohitagw15856/pm-claude-skills
Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.
Fire Number
mohitagw15856/pm-claude-skills
Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.
Freelance Rate
mohitagw15856/pm-claude-skills
Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.
Questions about Brief Builder
What does Brief Builder do?
Interview the user with sharp, one-at-a-time questions to turn a vague request into a tight, complete brief any other skill can run on. Brief Builder is an agent skill from mohitagw15856/pm-claude-skills. Interview the user with sharp, one-at-a-time questions to turn a vague request into a tight, complete brief any other skill can run on.
When should I use Brief Builder?
Brief Builder fits situations like: A request is fuzzy; under-specified; help me think this through; before running a skill that needs inputs the user hasnt given.
How do I install Brief Builder in Claude Code?
Run `npx skills add mohitagw15856/pm-claude-skills --skill brief-builder -a claude-code`. Or copy the skill folder (skills/brief-builder in mohitagw15856/pm-claude-skills) into .claude/skills/brief-builder in your project. Claude Code loads it when a task matches its description.
How do I install Brief Builder in Codex?
Run `npx skills add mohitagw15856/pm-claude-skills --skill brief-builder -a codex`. Or copy the skill folder (skills/brief-builder in mohitagw15856/pm-claude-skills) into .agents/skills/brief-builder in your project. Codex loads it when a task matches its description.
Can I use Brief Builder in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill brief-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brief-builder, .gemini/skills/brief-builder, .github/skills/brief-builder and .opencode/skills/brief-builder in your project.
What does Brief Builder need to run?
SKILL.md names no scripts, command-line tools or credentials: Brief Builder is instructions for the agent only.
Does Brief Builder access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Brief Builder safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Brief Builder use?
Brief Builder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Brief Builder use?
About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Brief Builder?
Skills that share tags, products or a category with Brief Builder: Brief (alirezarezvani/claude-skills, 28k stars), Interview (codewhale-hq/Codewhale, 41k stars), Interview (alirezarezvani/claude-skills, 28k stars) and Interview Me (addyosmani/agent-skills, 103k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Brief Builder?
mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,433 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 8, 2026.
Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.