Agents & Skills / Content Writer / /draft
skillContent Writerby stackbrief

/draft

Run the full content-writer workflow from a brief file. Takes a slug, finds the brief, checks tool JSONs, writes the MDX article, and reports ready for seo-auditor.

content-pipelinearticle-writingmdxautomation

Usage

/draft <slug>

Where <slug> matches a brief file at content/briefs/<slug>.md.

What it does

  1. Reads the brief at content/briefs/<slug>.md (lists available briefs if the file doesn't exist)
  2. Checks content/tools/ for every tool mentioned in the brief — creates missing JSON entries
  3. Writes the full MDX article to content/articles/<slug>.mdx following the site's voice and structure rules
  4. Sets all frontmatter fields: title, description, date, category, tags, tools, lastVerified, reviewFrequency, volatile, imagePrompt
  5. Adds {/* CHECK: ... */} comments above any volatile claims (pricing, install commands, version numbers)
  6. Uses [affiliate link] placeholders for tools with potential affiliate programs
  7. Reports "Ready for seo-auditor" when complete

Workflow position

quick-brief → content-writer (/draft) → seo-auditor → publishing-gate → social-writer

Templates

The skill reads three supporting template files that define the exact spec for each output:

  • templates/frontmatter.md — MDX frontmatter field rules
  • templates/image-prompt-guide.md — Good/bad imagePrompt examples for the pixel art generator
  • templates/tool-json.md — Tool JSON schema and when to create new entries
Part of the Content Writer agent

Drafts MDX articles from a content brief following strict voice, formatting, and frontmatter rules. Handles tool JSON creation and affiliate link placeholders.

View agent →