Agent Skills
› gooseworks-ai/goose-skills
› make-content-content-brief
make-content-content-brief
GitHub在撰写内容前生成一页内容简报,涵盖受众、意图、核心论点、大纲及证据清单,并对照六大标准进行校验。适用于已明确主题和受众,仅需快速制定内容策略的场景。
触发场景
需要为文章或页面制定内容策略时
已有主题但尚未开始起草正文时
安装
npx skills add gooseworks-ai/goose-skills --skill make-content-content-brief -g -y
SKILL.md
Frontmatter
{
"name": "make-content-content-brief",
"version": "0.1.1",
"description": "Writes a one-page content brief before any draft: audience, intent, the one arguable point, what top results already say and what this piece adds, an outline, a proof inventory with gaps marked, voice, CTA and banned words, checked against six gates. Use alone when you already have the topic, format, audience and destination and want only the brief; otherwise run make-content."
}
Content brief
No fresh draft starts without a brief. Write it, check it against the six gates below, and save it before drafting.
Read first (all free)
gooseworks:brand_readsections: ["summary","kit","learnings"], lean (it returns everymust/dontfact; read learnings in full only fordo/insightrules): the voice, audience, value props, the kit's reference examples and templates, and the learnings (must/do/dont). Read the kit in full (alone:sections: ["kit"],detail: "full") only when you need its example lines or images.gooseworks:knowledge_searchwith the topic as the query, across all source types. This returns past creatives and feedback, saved rules, customer evidence and documents. Then work out which brand claims are usable through the shared claims gate (theclaims-gateskill,../claims-gate/SKILL.md): signed-off claims, the scoped sign-off this run, or plain product facts only. Proof slots may only hold usable claims and the sourced facts in../make-content/references/fact-rules.md.- The voice-of-customer bank (research-audience writes it):
gooseworks:file_readresearch/audience/voc-bank.md(brand coworker scope). If it is not there, usegooseworks:knowledge_searchsource_types: ["document","evidence"], query "voice-of-customer bank". It gives buyer phrases, objections and questions on this topic, each with its source and date. - When the ask comes from a sibling:
- improve-search-visibility page brief:
gooseworks:file_readsearch/briefs/<page-slug>.md. It gives the cluster, intent, the questions the page must answer, the facts it must state, the claims allowed and the competitor-name rules. Put the brief's path on the draft's first line. - plan-campaign asset list:
gooseworks:campaign_readcampaign_idgives the brief, the concepts and the asset row. - analyze-performance "what to make next": the latest
reports/performance/<date>.md(gooseworks:file_listreports/performance/), its "what to make next" section.
- improve-search-visibility page brief:
- When it is a comparison:
gooseworks:competitor_readfor dated competitor facts. - Top search results (search-intent pieces only, when no page brief already carries them): use the host's own web search when it has one (free). Otherwise make one
/v1/google/searchread through the proxy (themarketing-data-accessskill,../marketing-data-access/SKILL.md), under the spend gate (thespend-gateskill (../spend-gate/SKILL.md), proxy branch: a probe with the yes asked in SKILL.md's #5 message). Open the top 3 pieces and log URL and date; with no fetch, judge from titles and snippets and label it "snippets only". This feeds "information gain". - Public sources. When your host has web search or fetch, open 2–5 primary sources for the world facts the outline needs (platform help docs, standards bodies, original studies, official statistics). Log each URL and the date opened in the proof inventory. Never cite from memory. With no web tool, list them in "what unlocks this draft".
gooseworks:file_listcontent/in the brand workspace: existing briefs and drafts, to avoid duplicating a piece and to find internal-link candidates.
The brief (fill every line; use ../make-content/references/formats.md for the format's anatomy)
Brief — <working title> (+2 alternative titles)
Format · length · where it publishes · by when
Audience: <one role/segment>, their situation, what they already know
Intent: learn | do | decide | trust | be convinced | news
The one argument: <one sentence a reasonable person could disagree with>
Information gain: what the top results and competitor pieces in hand say (page brief, the search read above, research-competitors files) → what ours adds | "not checked: you declined the search read"
Outline (H2s written as claims): …
Proof inventory:
- <proof> — "Claims you may use" fact | product fact: <field> | VoC "<quote>" (<source>, <date>) | interview line | <public URL opened>
- [PROOF NEEDED: <what>, for H2 n]
Reader questions to answer word for word: …
POV needed: yes/no — have it: yes (source) / no → interview (`../make-content/references/point-of-view.md`)
Voice: brand | <person> (brand/voices/<handle>.md)
CTA: <action> → <destination the human gave>
House style: spelling (US/UK), heading case, reading level
Banned words: <from voice guide + learnings>
Sources this brief stands on: <list>
Live data: <what the page brief supplied> | none available (no search/AI-answer data tool today)
Gates before drafting
- Thesis. The one argument is arguable. "Skincare matters" fails. "Most 'non-comedogenic' labels mean nothing, so check the ingredient list instead" passes.
- Proof. At least one real proof unit per H2, or an honest
[PROOF NEEDED]the human can see. Never a plausible stand-in. If fewer than half the H2s have real proof, the draft stops here (SKILL.md step 4, proof gate). Sections that only give instructions and make no factual claim need no proof. Interview lines from the human count as proof. - POV. If needed and missing, run the interview before drafting, or switch to the no-POV format and say so.
- Inputs. Missing format, audience, destination or deadline → ask once, all together. Never guess them.
- Length gate. For long-form (over ~1,200 words, guides, reports) and every case study, show the brief and outline and wait for the human's yes before drafting.
- Audience fit. Check the piece against every audience in the kit. A piece that insults one of them (e.g. "us vs hiring an agency" when agencies are a listed audience) is flagged to the human before drafting, with a reframe.
Save
gooseworks:file_write → content/briefs/<YYYY-MM-DD>-<slug>.md in the brand workspace (scope: ../make-content/references/point-of-view.md, Workspace scope). The draft links back to it.
版本历史
- 1add09b 当前 2026-11-02 21:50


