feat(aidd-context): add cook skill for recipe how-to sheets

README.md

@@ -7,7 +7,7 @@
 ### A community-maintained marketplace of skills, agents, and rules for Claude Code.
 
 <p>
-  <!--counts:start--><kbd>6 plugins</kbd> · <kbd>37 skills</kbd> · <kbd>3 agents</kbd><!--counts:end--> · <kbd>MIT</kbd>
+  <!--counts:start--><kbd>6 plugins</kbd> · <kbd>38 skills</kbd> · <kbd>3 agents</kbd><!--counts:end--> · <kbd>MIT</kbd>
 </p>
 
 <p>
@@ -137,7 +137,7 @@ that tool's model via the **LLM tier reference** below.
 
 ### 🧭 [aidd-context](plugins/aidd-context/README.md)
 
-`12 skills` · stable
+`13 skills` · stable
 
 Project init, architecture, generation of Claude Code context artifacts (skills, agents, rules, commands, hooks), diagrams, learning, discovery.
 

plugins/aidd-context/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "aidd-context",
   "version": "1.1.2",
-  "description": "Knowledge production: project bootstrap, project init, generation of context artifacts (skills, agents, rules, commands, hooks), mermaid diagrams, learn, discovery",
+  "description": "Knowledge production: project bootstrap, project init, generation of context artifacts (skills, agents, rules, commands, hooks), mermaid diagrams, learn, discovery, recipe how-to sheets",
   "author": {
     "name": "AI-Driven Dev",
     "url": "https://github.com/ai-driven-dev"
@@ -19,7 +19,8 @@
     "./skills/08-hook-generate",
     "./skills/09-mermaid",
     "./skills/10-learn",
-    "./skills/11-discovery"
+    "./skills/11-discovery",
+    "./skills/12-cook"
   ],
   "keywords": [
     "context",

plugins/aidd-context/CATALOG.md

@@ -21,6 +21,7 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai
   - [`skills/09-mermaid`](#skills09-mermaid)
   - [`skills/10-learn`](#skills10-learn)
   - [`skills/11-discovery`](#skills11-discovery)
+  - [`skills/12-cook`](#skills12-cook)
 
 ---
 
@@ -195,3 +196,13 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai
 | `references` | [ai-mapping.md](skills/11-discovery/references/ai-mapping.md) | - |
 | `-` | [SKILL.md](skills/11-discovery/SKILL.md) | `Enumerate installed surfaces of the AI tool (skills, agents, commands, plugins, MCP servers, rules, hooks, memory files) and recommend the best match for the user's stated intent. Use proactively whenever the user asks the model to list, show, enumerate, find, or pick among any of these surfaces - including imperative phrasings ("list hooks", "show me the rules", "enumerate skills", "find a memory file", "which agent reviews code"), question phrasings ("what's available?", "what hooks do we have?", "which rule applies here?", "what memory files do we have?"), and indirect phrasings ("what can I use for X?", "do we have something that does Y?"). Always pick this skill over scanning the filesystem with grep, find, ls, or reading action files directly when the user is enumerating a surface. Do NOT use for picking a specific item inside one plugin (the plugin's own onboard handles that), creating a new surface, or executing a recommended item (this skill only points; the user invokes).` |
 
+#### `skills/12-cook`
+
+| Group | File | Description |
+|-------|------|---|
+| `actions` | [01-list.md](skills/12-cook/actions/01-list.md) | - |
+| `actions` | [02-upsert.md](skills/12-cook/actions/02-upsert.md) | - |
+| `assets` | [recipe-template.md](skills/12-cook/assets/recipe-template.md) | - |
+| `-` | [README.md](skills/12-cook/README.md) | - |
+| `-` | [SKILL.md](skills/12-cook/SKILL.md) | `Manage the project's recipes/ how-to sheets: list them as a table, or create and update one from the canonical template. Use for "list recipes", "new recipe", "update a recipe", "cook a recipe".` |
+

plugins/aidd-context/README.md

@@ -21,6 +21,7 @@ Covers project bootstrap, project initialisation, generation of Claude Code cont
 | [1.4]      | [mermaid](skills/09-mermaid/README.md)                 | Generate high-quality Mermaid diagrams from markdown content using a structured plan-validate workflow.                                                         |
 | [1.5]      | [learn](skills/10-learn/README.md)                     | Capture and store learnings from recently implemented features into memory bank, decisions, or coding rules.                                                    |
 | [1.6]      | [discovery](skills/11-discovery/README.md)             | Help users discover installed skills and find the right one for their use case.                                                                                 |
+| [1.7]      | [cook](skills/12-cook/README.md)                       | Maintain the project's `recipes/` how-to sheets: list every recipe, or create and update one from the canonical recipe template.                              |
 
 ## Onboarding
 

plugins/aidd-context/skills/12-cook/README.md

@@ -0,0 +1,12 @@
+← [framework](../../../../README.md) / [aidd-context](../../README.md)
+
+# 12 - cook
+
+Maintain the project's `recipes/` how-to sheets: list them, or create and update one from the canonical template. The recipes are the short runbooks at the root of whatever project the skill runs in.
+
+| #   | Action                         | Purpose                                        |
+| --- | ------------------------------ | ---------------------------------------------- |
+| 01  | [list](actions/01-list.md)     | List every recipe as a table.                  |
+| 02  | [upsert](actions/02-upsert.md) | Create or update one recipe from the template. |
+
+See [`SKILL.md`](SKILL.md) for the router and [`assets/recipe-template.md`](assets/recipe-template.md) for the recipe shape.

plugins/aidd-context/skills/12-cook/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: 12-cook
+description: Manage the project's recipes/ how-to sheets: list them as a table, or create and update one from the canonical template. Use for "list recipes", "new recipe", "update a recipe", "cook a recipe".
+---
+
+# Cook
+
+Maintains the project's `recipes/` how-to sheets, the short runbooks that live at the project root.
+
+## Actions
+
+| #   | Action   | Role                                          | Input                 |
+| --- | -------- | --------------------------------------------- | --------------------- |
+| 01  | `list`   | List every recipe as a table                  | none                  |
+| 02  | `upsert` | Create or update one recipe from the template | recipe topic + fields |
+
+Run `list` to survey recipes, `upsert` to author one. Run `list` first when the user wants to update a recipe but hasn't named which.
+
+## Assets
+
+- `assets/recipe-template.md`: the canonical recipe scaffold `upsert` renders from, and the shape `list` parses. Its header comment carries the field rules.

plugins/aidd-context/skills/12-cook/actions/01-list.md

@@ -0,0 +1,24 @@
+# 01 - List recipes
+
+List every recipe under `recipes/` at the project root as a table, excluding `README.md`.
+
+## Output
+
+```md
+| Recipe | Goal | Level |
+| --- | --- | --- |
+| [<title>](recipes/<file>) | <goal> | <level> |
+```
+
+One row per `recipes/*.md`, sorted by file name. If `recipes/` is absent or empty: `No recipes yet.`
+
+## Process
+
+1. Read each `recipes/*.md` except `README.md`.
+2. Pull the H1 title, the `> **Goal:**` line, and the **Level** row.
+3. Render the table above.
+
+## Test
+
+- One row per recipe file, each with title, goal, and level.
+- Absent/empty `recipes/` → `No recipes yet`, no error.

plugins/aidd-context/skills/12-cook/actions/02-upsert.md

@@ -0,0 +1,17 @@
+# 02 - Upsert recipe
+
+Create or update one recipe at `recipes/<slug>.md`, scaffolded from `@assets/recipe-template.md`.
+
+## Input
+
+The recipe topic. Ask for any missing field (level, time, prerequisites, steps, verify, related) before writing.
+
+## Process
+
+1. Derive a kebab-case `<slug>` from the topic → `recipes/<slug>.md`.
+2. If it exists, update in place; else scaffold from the template.
+3. Fill every placeholder, then add or refresh the recipe's row in the `recipes/README.md` index. The index table is `| Recipe | Goal | Level |`: link the title to `<slug>.md` (relative), copy the `> **Goal:**` text, and copy the **Level**. Same columns `list` emits.
+
+## Test
+
+- `recipes/<slug>.md` exists and matches the template, every section present, no `<...>` placeholder left.

plugins/aidd-context/skills/12-cook/assets/recipe-template.md

@@ -0,0 +1,29 @@
+<!-- Recipe contract: file is recipes/<kebab-slug>.md · Level ∈ {Beginner, Intermediate, Advanced} · Time prefixed with ~ · one idea per sentence, prefer removing over adding. -->
+
+# <Recipe title>
+
+> **Goal:** <one line stating the outcome the reader achieves>
+
+|                   |                                          |
+| ----------------- | ---------------------------------------- |
+| **Level**         | <Beginner \| Intermediate \| Advanced>   |
+| **Time**          | ~<N> min                                 |
+| **Prerequisites** | <what the reader needs first, or "None"> |
+
+## Why
+
+<One short paragraph: the problem this recipe solves and when to reach for it.>
+
+## Steps
+
+1. 📋 **<First step>** — <imperative instruction.>
+2. 🔧 **<Next step>** — <imperative instruction.>
+3. ✅ **<Last step>** — <until the goal is reached.>
+
+## Verify
+
+- <An observable check that proves it worked: a command, a UI state, a file that now exists.>
+
+## Related
+
+- <Link to a sibling recipe, a skill, or a doc the reader needs next.>