author-brief

Solid

Use this skill when the user has unstructured external input (an email thread, a prose description, a Linear Issue, a stakeholder message) and needs to produce a DoR-compliant product brief and queue it in workspace.toml. Triggers on "author a brief", "write a brief from this email", "create a brief from this Linear issue", "intake this brief", "turn this into a brief". Do NOT use to decompose an existing brief into specs (use receive-brief) or to author a single feature from scratch (use new-spec).

AI & Automation 14 stars 4 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 80/100

Stars 20%
39
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Skill: author-brief Turn any unstructured external input into a DoR-compliant product brief, then queue it so `workspace-status` can surface it immediately. `author-brief` stops at **draft** — it does not decompose the brief into specs and does not set `Status: Ready`. Those are `receive-brief`'s job. The two skills have distinct entry points and must stay distinct. ## When to invoke - The user has an email thread, a prose description, a Linear Issue body, or a stakeholder message they want to turn into a brief. - The unit of work is larger than one feature (otherwise use `new-spec`). - The brief does not yet exist as a file in `docs/product/briefs/`. If the input is already a well-formed brief file, go directly to `receive-brief`. If the user wants to record a decision already made, use `new-adr`. ## Procedure ### 1. Ingest Accept whatever the user provides: a pasted email, a prose block, issue text, a verbally-described idea. Do **not** reject partial or messy input — the brief template is a guide, not a form. The goal is to extract enough signal to elicit what is missing. ### 2. Identify Scan the input for DoR fields already present: - **Outcome** — a user-facing or system change the input is trying to achieve; often in the subject or opening sentence. - **Appetite** — a time or effort constraint ("this needs to ship before the conference", "a sprint, not a quarter"). - **Rabbit holes** — named design traps, constraints, or things to avoid ("don't touc...

Details

Author
eugenelim
Repository
eugenelim/agent-ready-repo
Created
2 months ago
Last Updated
today
Language
Python
License
Apache-2.0

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

receive-brief

Use this skill when the user receives an externally-authored, multi-feature product brief -- a PRD, a solution handoff, a requirements packet -- and needs to turn it into shippable specs. Triggers on "receive a brief", "decompose this PRD", "we got a product brief", "break this handoff into specs". Elicits the load-bearing fields without mandating a schema, decomposes by shippability, and executes each slice through new-spec then work-loop. Do NOT use to author a single feature from scratch (use new-spec) or to record a decision (use new-adr).

14 Updated today
eugenelim
AI & Automation Featured

content-brief-authoring

How to author a content brief that actually guides a writer (human or AI) to produce a piece that ranks, converts, or both. Per-piece editorial brief: target keyword and cluster, search intent, audience and JTBD, heading structure, entity coverage for AEO/GEO, internal linking strategy, success criteria. The middle path between thin briefs (a keyword and a deadline) and thick briefs (a 4-page document nobody reads). Triggers on content brief, brief the writer, brief the article, brief authoring, content brief template, brief audit, per-piece brief, editorial brief, target keyword brief, search intent brief. Also triggers when briefing a human writer or an AI agent on a single content piece.

496 Updated 5 days ago
rampstackco
Data & Documents Listed

creating-briefs

Transforms unstructured requests into clear, actionable briefs. Use when writing a brief, preparing a specification, extracting requirements, or clarifying what a task needs.

8 Updated 1 weeks ago
isvlasov