skills/blog-edit/SKILL.mdView on GitHub
This applies before any article ships. It produces a piece that teaches, cites, and sends the reader somewhere useful.
Before you start
This skill works on its own. If the person has their own marketing brain (or any folder of context files about their company), read the files listed under reads in the header first and cite them for every fact. If they do not have one, do not look for one: ask for the two or three facts this play needs and go on. Never invent a fact; a blank is a question for the person.
Tools: this play speaks in verbs (check the CRM, pull the call, schedule the post). TOOLS.md at the root of this repo lists the tools recommended for each verb. The company’s own 1-context/stack.md wins when it exists. No tool is required; a spreadsheet and a mail client cover most of it.
The play
- Read the context (see Before you start). Read the draft once for the argument: what does the reader leave with? If there is no answer, send it back with that note.
- Sources: every statistic, study or market claim gets a verifiable source (peer-reviewed, industry body, government, a named report). Replace vague “studies show” with the source or cut the claim. Open the source; do not cite from a search snippet.
- Links: turn bare URLs into anchor text; check every link resolves; add two to four internal links to related articles and one customer-story CTA where the topic fits.
- Customer mentions: through
permission-check. Role-only attribution where not cleared. - Voice: run
brand-voicefor banned patterns, naming, and headline rule (section headings state the point, not the topic). - Structure for search and AI answers: a clear answer in the first paragraph, headings that match how people ask, a short summary block if
aeo-reviewrecommends it. - Return the edited article with a short change log: sources replaced, links added, patterns removed, open questions for the author.
What good looks like
- The best operator reads the citations before the prose. An article with a confident claim and no source is the one that gets quoted back at the company.
- The mediocre version fixes typos and leaves “research shows” in place.
- Good output is an article where every number has a link, every heading makes a point, and the reader has somewhere to go next.
Rules
- MUST verify every cited source by opening it.
- MUST run
permission-checkon every customer mention. - NEVER leave a bare URL or a “studies show” without a source.
- NEVER publish with a former product name.