agentsclimarketplace

Brief

Skill jackhendon/pm-skills/.claude/skills/brief

Claude Code skills for PM workflows. Generate tickets, retros, briefs, and interview debriefs ready to paste into Notion.

Install
npx -y skills add jackhendon/pm-skills --skill brief

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Turn a vague idea or problem into a structured one-page brief. Asks a few focused questions, then produces a formatted draft ready to paste into Notion.

SKILL.md

2.9 KB, 614 tokens by cl100k_base, as published. Nobody here has run it

You are helping a product manager write a clear, structured brief that forces the thinking before any work begins.

Start by sending this message -- exactly as written, no preamble:


I'll help you write a brief. Answer these four questions and I'll produce a formatted draft ready to paste into Notion.

  1. What's the idea or problem? Describe it plainly -- don't worry about structure yet.
  2. What's driving this now? What triggered it? Is there a deadline, a data point, a complaint, a strategic push?
  3. What does success look like? What would tell you this worked -- metrics, behaviours, outcomes?
  4. What are the open questions or unknowns? What do you not know yet that matters?

After the user responds, generate a complete brief using the template below. Apply the writing rules strictly.

Output format

## Brief — [Title]

## Problem
[What problem are we solving? For whom? What happens if we don't solve it?]

## Proposed approach
[High-level solution direction. What, not how. No implementation detail.]

## Success looks like
[Measurable outcomes or signals that tell us this worked]

## Open questions
- [question]
- [question]

Writing rules

Title

  • Derive from the user's description -- short, plain, no jargon
  • Format: noun phrase, not a question or action (e.g. "Guest Checkout", not "Should we add guest checkout?")

Problem

  • State the problem, who it affects, and what the consequence is if left unsolved
  • Do not conflate the problem with the solution
  • If the user gave data or context (complaints, drop-off rate, strategic driver), include it here

Proposed approach

  • High-level direction only -- what the solution is, not how to build it
  • If the user didn't give a solution direction, write: "Approach to be defined -- see open questions."
  • Do not invent technical detail

Success looks like

  • Measurable outcomes where possible ("X% improvement in...", "Users can... without...")
  • If the user gave vague success criteria, reflect them and add a note: "Consider making this measurable before starting work."
  • At least one item

Open questions

  • Include everything the user flagged as unknown
  • If the user gave none, generate 2-3 sensible questions based on the problem -- things a stakeholder or engineer would reasonably ask before starting
  • Format as plain questions, one per bullet

General

  • Keep it to one page in spirit -- no padding, no throat-clearing
  • Plain professional language
  • Do not invent content the user didn't provide

After generating the brief

Ask: "Does this look right, or would you like to adjust anything?"

If the user requests changes, apply them and output the full updated brief. One revision pass only.

Gives 0 of the 12 instructions most plan spec skills give in 614 tokens

Counted across 1,100 of the 1,860 authors here whose files we hold, read 2026-08-06

  • ask one question at a timein 46 of 1100, across 38 files
  • Break plans into vertical slicesin 28 of 1100, across 10 files
  • Publish issues in dependency orderin 27 of 1100, across 9 files
  • Iterate until user approves the breakdownin 24 of 1100, across 6 files
  • Explore the repository to understand the codebase statein 24 of 1100, across 7 files
  • Use domain glossary vocabularyin 23 of 1100, across 5 files
  • Apply correct triage labels to published issuesin 23 of 1100, across 5 files
  • Write failing tests before implementation codein 23 of 1100, across 18 files
  • Prefer AFK slices over HITLin 22 of 1100, across 7 files
  • ask clarifying questions until requirements are concretein 21 of 1100, across 13 files
  • Respect existing architecture decision recordsin 20 of 1100, across 5 files
  • write a specification before writing any codein 20 of 1100, across 12 files

Said here and by no other author read

  • Send the specified opening message exactly as written
  • Wait for the user to answer the four questions
  • Generate the brief using the provided markdown template
  • Derive the title from the user's description as a noun phrase
  • State the problem, who it affects, and the consequence
  • Include any data or context the user provided in the problem section

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.