| name | draft-recipe |
| description | Use when drafting a recipe seed JSON for CMS import. Output at the target repo's resolved recipe seed path. Include structured-data fields (times, servings, difficulty). Match brand-voice.md before finishing. Do NOT merge or publish — seed PR only.
|
| license | MIT |
| allowed-tools | ["Read","Write","Glob","Grep"] |
| argument-hint | <slug> [--brief from calendar] |
| metadata | {"version":"0.1.0","owner":"content-marketing","review_cadence":"quarterly","work_shape":"generate-draft","output_class":"draft-for-review"} |
Draft recipe
When to use
Draft a recipe seed JSON when a calendar brief or user request specifies a recipe slug
and topic.
What this skill does not do
- Does not plan the monthly calendar (
content-calendar)
- Does not merge, publish, or run
import-content-seed.ts
- Does not audit site-wide structured data (
technical-seo-audit)
Preconditions
- Target repo with CMS recipe collection schema (read collection config before drafting)
- Read ../../references/content-conventions.md
- Read
<resolved-brand-path>/brand-voice.md and match tone on excerpt and instruction steps
Trust spine
| Failure mode | Mitigation |
|---|
| Direct apply vs draft | Seed JSON in PR only; human merges then imports as CMS draft |
| Brand safety | Reads brand-voice.md from resolved brand path; inline tone ask if missing |
| Blast radius | Writes only under resolved recipe seed directory |
| DoD bypass | Does not mark recipe live |
Workflow
Follow prompts/run.prompt.md.
Outputs
{recipe-seed-dir}/{slug}.json on the target repo (resolve per content-conventions).
Schema derived from the target CMS recipe collection config:
| Field | Type | Required |
|---|
slug | string | yes |
title | string | yes |
date | ISO date | yes |
author | author slug | yes |
difficulty | easy | medium | hard | no |
servings | number | no |
prepTime | ISO 8601 duration | no, e.g. PT20M |
cookTime | ISO 8601 duration | no |
totalTime | ISO 8601 duration | no |
excerpt | string, max 500 | yes |
description | string, max 300 | no |
image | public path | no |
tags | tag slug array | no |
ingredients | [{ "item": "..." }] | yes, min 1 |
instructions | [{ "step": "..." }] | yes, min 1 |
Structured data: valid ISO 8601 durations; totalTime equals prep + cook when both set;
ingredients as full lines in item.
Related skills
content-seo-review — SEO review on seed PRkeyword-research — target keywords for recipe SEO
