skilldrop-cli 0.13.5 → 0.13.6

package/README.md

@@ -3,7 +3,7 @@
 [![npm](https://img.shields.io/npm/v/skilldrop-cli)](https://www.npmjs.com/package/skilldrop-cli)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-**63 portable AI-agent skills for the deliverables knowledge workers actually ship:** ADRs, design docs, PRDs, runbooks, threat models, decks, postmortems and adversarial reviews. Each one is a folder you copy into Claude Code, Cursor, Kiro, Codex or Copilot.
+**Portable AI-agent skills for the deliverables knowledge workers actually ship:** ADRs, design docs, PRDs, runbooks, threat models, decks, postmortems and adversarial reviews. Each one is a folder you copy into Claude Code, Cursor, Kiro, Codex or Copilot.
 
 ```text
 messy input → a skill with a quality bar → a gate that can say no → your decision
@@ -19,7 +19,8 @@ Install one pack. Every role pack also brings `core` (intake, critique, review c
 - **Architects:** `solution-architect` — diagrams, ADRs, design docs, API and data contracts, threat models. [Open pack](https://sananthanarayan.github.io/skilldrop/packs/solution-architect/)
 - **Software teams:** `dev-team` — story splitting, implementation with adversarial review, merge gates, launch readiness, release notes. [Open pack](https://sananthanarayan.github.io/skilldrop/packs/dev-team/)
 - **SRE and on-call:** `sre-oncall` — observability, runbooks, incident comms, postmortems, capacity. [Open pack](https://sananthanarayan.github.io/skilldrop/packs/sre-oncall/)
-- **Explaining things to decision-makers:** `stakeholder-comms` — audience profiles, deck outlines and `.pptx` decks, exec summaries, decision logs. [Open pack](https://sananthanarayan.github.io/skilldrop/packs/stakeholder-comms/)
+- **Explaining things to decision-makers:** `stakeholder-comms` — audience profiles, exec summaries, decision logs, guides. [Open pack](https://sananthanarayan.github.io/skilldrop/packs/stakeholder-comms/)
+- **On-brand decks and flyers:** `design` — capture your brand once, then build `.pptx` decks and print-ready flyers with your logo, colours and fonts. [Open pack](https://sananthanarayan.github.io/skilldrop/packs/design/)
 - **Adopting and building AI:** `ai-engineering` — readiness, use-case triage, policy, agent loops, budgets, agent threat models, evals. [Open pack](https://sananthanarayan.github.io/skilldrop/packs/ai-engineering/)
 - **Building on the Claude API:** `claude-api` — prompt caching, token budgets, eval generation, tool schemas. [Open pack](https://sananthanarayan.github.io/skilldrop/packs/claude-api/)
 - **Everyone:** `core` on its own. [Open pack](https://sananthanarayan.github.io/skilldrop/packs/core/)

package/catalogue.json

@@ -1,9 +1,10 @@
 {
   "$comment": "RFC-0034. The catalogue index: pack display order and the outcome browse axis (RFC-0026). Pack metadata lives in packs/<pack>/pack.json; membership is the folders — a skill is in a pack because it sits at packs/<pack>/skills/<name>/.",
   "version": "1.0.0",
-  "packs": ["core", "solution-architect", "product-manager", "dev-team", "sre-oncall", "stakeholder-comms", "ai-engineering", "claude-api"],
+  "packs": ["core", "solution-architect", "product-manager", "dev-team", "sre-oncall", "stakeholder-comms", "design", "ai-engineering", "claude-api"],
   "outcomes": {
     "decide-what-to-build": {
+      "for": "Product managers · founders · strategists",
       "description": "Turn a direction into a committed, measurable plan: press releases, strategy frameworks, OKRs, business cases, requirements, PRDs, and the metrics that will say whether it worked.",
       "skills": [
         "prfaq",
@@ -20,6 +21,7 @@
       ]
     },
     "design-the-system": {
+      "for": "Architects · tech leads",
       "description": "Commit the shape before the code: decision records, design docs, diagrams, contracts, schemas, migration and threat models, and the design of any agentic parts.",
       "skills": [
         "adr-generator",
@@ -40,6 +42,7 @@
       ]
     },
     "build-and-review-software": {
+      "for": "Software teams · coding agents",
       "description": "The loop around the code itself: supervised implementation, adversarial review panels, test plans, triage, accessibility and static-analysis passes, and the policy files agents read.",
       "skills": [
         "feature-implement-loop",
@@ -58,6 +61,7 @@
       ]
     },
     "build-on-the-claude-api": {
+      "for": "Teams building on the Anthropic API",
       "description": "Skills for teams building directly on the Anthropic API — prompt caching strategy, token budgeting, eval generation, and tool-use schema writing.",
       "skills": [
         "prompt-caching-advisor",
@@ -67,6 +71,7 @@
       ]
     },
     "run-and-recover-the-service": {
+      "for": "SRE · on-call · platform teams",
       "description": "Operate what shipped: runbooks, observability design, release notes, incident communication, and the postmortem that closes the loop.",
       "skills": [
         "runbook-generator",
@@ -78,6 +83,7 @@
       ]
     },
     "explain-it-to-decision-makers": {
+      "for": "Anyone presenting to leadership",
       "description": "Get a non-technical audience to a decision: audience profiling, deck outlines and real decks, exec summaries, decision logs, and how-to guides.",
       "skills": [
         "audience-profile",
@@ -89,6 +95,7 @@
       ]
     },
     "govern-ai-use": {
+      "for": "AI enablement · engineering leaders · risk owners",
       "description": "Adopt AI deliberately and prove what it is doing: readiness assessment, use-case triage, rollout plans, acceptable-use policy, adoption staging, and usage reporting.",
       "skills": [
         "ai-readiness-assessment",
@@ -99,7 +106,18 @@
         "ai-usage-report"
       ]
     },
+    "create-on-brand-collateral": {
+      "for": "Marketers · designers · anyone making a deck or flyer",
+      "description": "Make collateral that looks like it came from your team: capture the brand once, then build decks and print-ready flyers with your logo, colours and fonts.",
+      "skills": [
+        "brand-kit",
+        "deck-builder",
+        "marketing-flyer",
+        "slide-outliner"
+      ]
+    },
     "get-a-draft-ready-to-ship": {
+      "for": "Anyone shipping a document",
       "description": "The passes either side of a generator: collect a messy input into a structured brief, critique the argument, and strip the machine artifacts before it leaves the building.",
       "skills": [
         "brief-intake",

package/contracts/catalogue.schema.json

@@ -23,6 +23,7 @@
         "additionalProperties": false,
         "required": ["description", "skills"],
         "properties": {
+          "for": { "type": "string", "description": "Who this job belongs to, shown on the home page's outcome cards." },
           "description": { "type": "string", "description": "The chip's tooltip on the catalogue site." },
           "skills": { "type": "array", "items": { "type": "string" }, "minItems": 1 }
         }

package/model-routing.json

@@ -150,6 +150,14 @@
       "tier": "standard",
       "rationale": "Checks evidence against a fixed checklist. Bounded synthesis, not adversarial review."
     },
+    "brand-kit": {
+      "tier": "standard",
+      "rationale": "Extracts and normalises brand facts from files and pages, then runs a checker. Bounded synthesis."
+    },
+    "marketing-flyer": {
+      "tier": "standard",
+      "rationale": "Writes short copy to fit and fills a spec for a deterministic builder. Bounded generation."
+    },
     "runbook-generator": {
       "tier": "standard",
       "rationale": "Operational doc from service facts. Bounded synthesis."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skilldrop-cli",
-  "version": "0.13.5",
+  "version": "0.13.6",
   "description": "Portable AI-agent skills for the deliverables knowledge workers ship \u2014 diagrams, ADRs, PRDs, runbooks, decks, reviews \u2014 installable into Claude Code, Cursor, Kiro, and any IDE that takes custom instructions. One command per skill or per role-based pack.",
   "author": {
     "name": "Sanjay Ananthanarayan",

package/packs/design/pack.json

@@ -0,0 +1,22 @@
+{
+  "description": "On-brand visual work: capture a brand once, then build real PowerPoint decks and print-ready marketing flyers in that brand, with logo, colours and fonts applied.",
+  "display_name": "Design",
+  "keywords": ["brand", "deck", "pptx", "flyer", "marketing", "logo"],
+  "links": {
+    "documentation": "https://sananthanarayan.github.io/skilldrop/packs/design/"
+  },
+  "maintainers": [
+    {
+      "name": "sananthanarayan"
+    }
+  ],
+  "first-value": {
+    "audience-posture": "non-technical",
+    "prerequisites": ["Your logo as a PNG file, and your brand colours if you know them"],
+    "starter-task": "Capture your brand once, then make a flyer in it",
+    "starter-prompt": "Set up our brand kit from this logo (./brand/logo.png) and these colours: #0E5A46, #F2A541. Then make a Letter-size flyer for our community health fair on Saturday 14 November, 10am–2pm, at Riverside Park.",
+    "verification": "brand-kit writes brand.json and a one-page BRAND.md with contrast checked, and marketing-flyer writes flyer.html in your colours with your logo, one call to action, and only the facts you gave it.",
+    "recovery": "If the flyer comes out in default colours, check that marketing-flyer was given the brand.json path. If brand-kit does not activate, ask for it by name (\"use brand-kit\")."
+  },
+  "requires": ["core"]
+}

package/packs/design/skills/brand-kit/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: brand-kit
+description: Capture a brand once as a reusable brand.json — logo files (and an on-dark version), colour roles as hex codes, heading and body fonts, voice, imagery rules, a PowerPoint template, contact details and the legal footer — plus a one-page BRAND.md, with text contrast checked and every value traced to where it came from. Use when the user wants decks, flyers or documents in their branding, says "use our brand", "here's our logo and colours", "set up our brand kit", or hands over brand guidelines.
+---
+
+# brand-kit
+
+You turn whatever the user has about their brand (logo files, a guidelines PDF, a website, a
+few hex codes, "we use green") into one `brand.json` that other skills build from:
+[`deck-builder`](../deck-builder/SKILL.md) for PowerPoint decks and
+[`marketing-flyer`](../marketing-flyer/SKILL.md) for flyers. Capturing the brand once means
+nobody answers the same questions for every deck, and the deck and the flyer match.
+
+## How to respond
+
+1. **Ask for everything in one message, and take what they already gave.** Never ask for
+   something the user already supplied.
+
+   > To set up your brand kit, send whatever you have. Anything you skip I'll either take from
+   > what you sent or leave for you to confirm:
+   > 1. **Brand name**, and a tagline if you use one
+   > 2. **Logo files.** The main logo, plus a white or light version for dark backgrounds if
+   >    you have one. PNG is best; SVG works for flyers, but PowerPoint needs PNG.
+   > 3. **Colours** as hex codes (`#0E5A46`), or a guidelines PDF or website I can read them from
+   > 4. **Fonts** for headings and body text
+   > 5. **Voice:** how you sound, and words you always or never use
+   > 6. **Imagery:** the kind of photos or illustrations you use, and what to avoid
+   > 7. **A PowerPoint template** (`.potx` or `.pptx`) if your company has one
+   > 8. **Contact and legal:** website, email, phone, and any footer line such as "© 2026 …"
+
+2. **Read the sources the user points to.** From a guidelines PDF or website, extract colour
+   hex codes, font names, logo usage rules and voice. Tag every value with where it came from
+   in `sources`: `[explicit]` when the source states it, `[inferred]` when you derived it (a
+   colour sampled from the logo, a tone read from the About page). Never present an inferred
+   value as the brand's own rule.
+
+3. **Fill the five colour roles.** The roles are `primary` (main brand colour; slide title
+   bars, flyer bands), `secondary` (supporting), `accent` (highlights, calls to action),
+   `background` and `text`. If the user gave one or two colours, derive the rest and say which
+   roles you filled. Usually `background` is white or a near-white tint of the primary,
+   `text` is a near-black, and `secondary` is a lighter or darker step of the primary.
+
+4. **Write the files** next to the logo files, so relative paths resolve:
+   - `brand.json`, in the shape of [`templates/brand.json`](templates/brand.json). Leave a
+     field out instead of guessing it.
+   - `BRAND.md`: one page with the name, colour swatches as a table (role, hex, use), fonts,
+     voice, imagery rules and logo rules, readable by a person who never opens the JSON.
+
+5. **Check it.**
+
+   ```bash
+   # Claude Code
+   python3 "${CLAUDE_SKILL_DIR}/scripts/check_brand.py" ./brand/brand.json
+   # Other IDEs (from the skill folder)
+   python3 scripts/check_brand.py ./brand/brand.json
+   ```
+
+   It fails on a malformed hex code, text-on-background contrast below 4.5:1, a missing logo
+   file or template. It warns when white text on the primary is hard to read, when the accent
+   is too light for text, when a logo is SVG or EPS, or when fonts aren't set. Fix the
+   failures. Report each warning with what it means for the deck or flyer.
+
+6. **Hand off.** Tell the user the path to `brand.json` and that `deck-builder` and
+   `marketing-flyer` will use it: `build_deck.py --brand brand.json`, or the flyer spec's
+   `brand` field.
+
+**Non-interactive runs** (subagent, CI, headless): never invent a brand colour, font or logo.
+Use only what the input supplies, tag derived colours `[inferred]`, and list missing fields
+at the top of the response. With no brand material at all, emit `BLOCKED: need at least a
+brand name and either a logo file or one brand colour`.
+
+## Useful references in this skill
+
+- [`templates/brand.json`](templates/brand.json) — the full shape, with every field filled in for a sample brand
+- [`scripts/check_brand.py`](scripts/check_brand.py) — the checker: hex format, contrast, logo files and formats, template
+- [`examples/northwind-brand.md`](examples/northwind-brand.md) — worked example: a logo, two hex codes and a website become a brand kit
+
+## Quality bar
+
+- **Every colour is a hex code with a role.** "Our green" is not a brand colour; `#0E5A46` used for title bars is.
+- **Text on background passes 4.5:1,** checked by the script rather than by eye.
+- **Every value says where it came from,** and inferred values are marked as inferred.
+- **Logo files are real paths that exist,** with a PNG for PowerPoint and an on-dark version when the brand has one.
+- **Nothing is invented.** A field the user didn't supply and couldn't be read from their sources is left out and listed, not guessed.
+- **BRAND.md fits on one page.** A person checks the brand from it without opening the JSON.
+
+## When to use this skill
+
+- ✅ Before the first branded deck or flyer, so both come out in the same brand
+- ✅ The user hands over brand guidelines, a logo, or a website and asks for things "in our style"
+- ✅ A brand has changed and the old `brand.json` needs updating
+
+## When NOT to use this skill
+
+- ❌ Designing a new brand from scratch: this captures a brand, it doesn't invent one
+- ❌ Building the deck or flyer itself; use `deck-builder` or `marketing-flyer`
+- ❌ A one-off document where the user only wants the default look
+
+## Anti-patterns to avoid
+
+- ❌ **Asking eight separate questions** instead of one message with everything.
+- ❌ **Sampling a colour from a JPEG** and recording it as the official hex without the `[inferred]` tag.
+- ❌ **Accepting an SVG logo for PowerPoint use** without saying a PNG is needed.
+- ❌ **Picking a pale accent as the text colour** because it is "on brand". It fails contrast and nobody can read it.
+- ❌ **Filling the voice section with adjectives** ("innovative, passionate"). Words to use and words to avoid are what a writer can act on.

package/packs/design/skills/brand-kit/evals/eval_queries.json

@@ -0,0 +1,30 @@
+[
+  {
+    "query": "Here's our logo and brand colours \u2014 set up a brand kit we can reuse",
+    "should_trigger": true
+  },
+  {
+    "query": "Use our brand guidelines PDF so everything matches our style",
+    "should_trigger": true
+  },
+  {
+    "query": "Capture our fonts, colours and logo rules in one place",
+    "should_trigger": true
+  },
+  {
+    "query": "Make our decks and flyers on-brand \u2014 start with the brand settings",
+    "should_trigger": true
+  },
+  {
+    "query": "Build a PowerPoint deck for the board meeting",
+    "should_trigger": false
+  },
+  {
+    "query": "Make a flyer for our open day",
+    "should_trigger": false
+  },
+  {
+    "query": "Design a new logo for my startup",
+    "should_trigger": false
+  }
+]

package/packs/design/skills/brand-kit/evals/evals.json

@@ -0,0 +1,18 @@
+{
+  "skill_name": "brand-kit",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Set up our brand kit. Logo is ./brand/northwind-logo.png and there's a white version ./brand/northwind-logo-white.png. Our colours are #0E5A46 and #F2A541. We use Georgia for headings. Website is northwindhealth.example.",
+      "assertions": [
+        "Writes brand.json next to the logo files, with logo.primary and logo.on_dark set to the two supplied paths",
+        "colors.primary is #0E5A46 and colors.accent is #F2A541; secondary, background and text are filled and listed as derived",
+        "fonts.heading.family is Georgia; the body font is either asked for or marked as a default, not presented as the brand's",
+        "Every value has a source, with derived values tagged [inferred]",
+        "Runs check_brand.py and reports its contrast figures",
+        "Writes a one-page BRAND.md with a colour table (role, hex, use)",
+        "Invents no tagline, phone number, address or legal footer"
+      ]
+    }
+  ]
+}

package/packs/design/skills/brand-kit/examples/northwind-brand.md

@@ -0,0 +1,48 @@
+# Worked example — a logo, two colours and a website become a brand kit
+
+## Input given to the skill
+
+> Set up our brand kit. Logo is `./brand/northwind-logo.png` and there's a white version
+> `./brand/northwind-logo-white.png`. Our colours are `#0E5A46` and `#F2A541`. We use Georgia
+> for headings. Website is northwindhealth.example.
+
+---
+
+**Wrote** `./brand/brand.json` and `./brand/BRAND.md`.
+
+**Filled for you, please confirm:** `secondary` `#3D7F6B` (a lighter step of your green),
+`background` `#FFFFFF` and `text` `#1F2A28` (near-black with a green cast). Voice is read
+from your About page and tagged `[inferred]`.
+
+**Not set (nothing supplied):** body font, tagline, phone, address, legal footer, PowerPoint
+template. Tell me your body font; until then decks and flyers use their defaults.
+
+```
+$ python3 scripts/check_brand.py ./brand/brand.json
+  text on background   14.79:1
+  white on primary      8.17:1
+WARN accent on background is 2.05:1 — use the accent for shapes and rules, not text
+WARN fonts.body is not set; generators fall back to their defaults
+OK: brand.json — 0 failure(s), 2 warning(s)
+```
+
+### BRAND.md
+
+| Role | Hex | Use |
+|---|---|---|
+| primary | `#0E5A46` | Slide title bars, flyer header band, buttons |
+| secondary | `#3D7F6B` | Charts, secondary panels |
+| accent | `#F2A541` | Call to action, highlights; shapes and rules, never body text |
+| background | `#FFFFFF` | Page and slide background |
+| text | `#1F2A28` | Body text |
+
+- **Fonts:** headings Georgia (from you); body font not set yet
+- **Logo:** full colour on white; the white version on the green. Never the full-colour logo on the green.
+- **Voice** `[inferred]`: warm and plain, short sentences. Says "members", not "patients".
+
+---
+
+**Why this is a good output:** it uses every fact the user gave and invents none. It fills only
+the colour roles a deck needs, says which ones it filled, and leaves the tagline and legal
+footer empty rather than making them up. The checker's figures show white titles on the
+green will read, and its accent warning is carried into BRAND.md as "never body text".

package/packs/design/skills/brand-kit/manifest.json

@@ -0,0 +1,44 @@
+{
+  "name": "brand-kit",
+  "version": "0.1.0",
+  "description": "Capture a brand once as a reusable brand.json — logo files (and an on-dark version), colour roles as hex codes, heading and body fonts, voice, imagery rules, a PowerPoint template, contact details and the legal footer — plus a one-page BRAND.md, with text contrast checked and every value traced to where it came from. Use when the user wants decks, flyers or documents in their branding, says \"use our brand\", \"here's our logo and colours\", \"set up our brand kit\", or hands over brand guidelines.",
+  "entrypoint": "SKILL.md",
+  "deps": {
+    "npm": [],
+    "pip": []
+  },
+  "env": {
+    "required": [],
+    "optional": []
+  },
+  "related": [
+    "deck-builder",
+    "marketing-flyer"
+  ],
+  "handoff": [
+    {
+      "to": "deck-builder",
+      "when": "the brand kit is written and the user wants a deck",
+      "purpose": "Build the PowerPoint deck in this brand: build_deck.py --brand brand.json.",
+      "fallback": "If deck-builder is absent, give the user the brand.json path and the five hex codes to paste into whatever deck tool they use."
+    },
+    {
+      "to": "marketing-flyer",
+      "when": "the brand kit is written and the user wants a flyer or one-page sheet",
+      "purpose": "Build a print-ready flyer in this brand from the flyer spec's brand field.",
+      "fallback": "If marketing-flyer is absent, give the user BRAND.md so a designer or tool can apply it by hand."
+    }
+  ],
+  "tags": [
+    "brand",
+    "logo",
+    "colours",
+    "fonts",
+    "design",
+    "style-guide"
+  ],
+  "model": {
+    "tier": "standard",
+    "rationale": "Extracts and normalises brand facts from files and pages, then runs a checker. Bounded synthesis."
+  }
+}

package/packs/design/skills/brand-kit/scripts/check_brand.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""Check a brand.json before anything is generated from it. Stdlib only.
+
+Checks:
+  - every colour role is a 6-digit hex code
+  - text on background, and white on primary, reach WCAG AA contrast (4.5:1)
+  - each logo file exists, and is PNG or JPG (PowerPoint cannot place SVG or EPS)
+  - a referenced .pptx/.potx template exists
+  - heading and body fonts are named
+
+Usage:
+  python3 check_brand.py path/to/brand.json
+Exit code 1 if any check fails; warnings alone exit 0.
+"""
+import json
+import re
+import sys
+from pathlib import Path
+
+HEX = re.compile(r"^#[0-9A-Fa-f]{6}$")
+ROLES = ("primary", "secondary", "accent", "background", "text")
+
+
+def luminance(hex_str):
+    h = hex_str.lstrip("#")
+    def ch(v):
+        v = int(v, 16) / 255
+        return v / 12.92 if v <= 0.03928 else ((v + 0.055) / 1.055) ** 2.4
+    r, g, b = (ch(h[i:i + 2]) for i in (0, 2, 4))
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b
+
+
+def contrast(a, b):
+    la, lb = sorted((luminance(a), luminance(b)), reverse=True)
+    return (la + 0.05) / (lb + 0.05)
+
+
+def main(argv):
+    if len(argv) != 1:
+        print(__doc__)
+        return 2
+    path = Path(argv[0]).expanduser().resolve()
+    base = path.parent
+    try:
+        brand = json.loads(path.read_text())
+    except (OSError, json.JSONDecodeError) as e:
+        print(f"FAIL cannot read {path}: {e}")
+        return 1
+    fails, warns = [], []
+
+    colors = brand.get("colors") or {}
+    for role in ROLES:
+        v = colors.get(role)
+        if not v:
+            warns.append(f"colors.{role} is missing; the generators will derive it from the others")
+        elif not HEX.match(v):
+            fails.append(f"colors.{role} is {v!r}, not a 6-digit hex code like #1A2A6C")
+    for x in colors.get("extra") or []:
+        if not HEX.match(str(x.get("hex", ""))):
+            fails.append(f"colors.extra {x.get('name', '?')!r} has hex {x.get('hex')!r}")
+    if HEX.match(colors.get("text", "")) and HEX.match(colors.get("background", "")):
+        r = contrast(colors["text"], colors["background"])
+        if r < 4.5:
+            fails.append(f"text on background contrast is {r:.2f}:1, below 4.5:1")
+        print(f"  text on background   {r:5.2f}:1")
+    if HEX.match(colors.get("primary", "")):
+        r = contrast("#FFFFFF", colors["primary"])
+        msg = f"white text on primary is {r:.2f}:1"
+        if r < 4.5:
+            warns.append(msg + " — slide title bars and flyer bands will use dark text instead")
+        print(f"  white on primary     {r:5.2f}:1")
+    if HEX.match(colors.get("accent", "")) and HEX.match(colors.get("background", "")):
+        r = contrast(colors["accent"], colors["background"])
+        if r < 3:
+            warns.append(f"accent on background is {r:.2f}:1 — use the accent for shapes and rules, not text")
+
+    logo = brand.get("logo") or {}
+    if isinstance(logo, str):
+        logo = {"primary": logo}
+    if not logo.get("primary") and not logo.get("on_dark"):
+        warns.append("no logo file — decks and flyers will carry the brand name as text instead")
+    for field in ("primary", "on_dark", "mark"):
+        ref = logo.get(field)
+        if not ref:
+            continue
+        lp = (base / ref) if not Path(ref).is_absolute() else Path(ref)
+        if not lp.exists():
+            fails.append(f"logo.{field} {ref!r} does not exist (looked in {lp.parent})")
+        elif lp.suffix.lower() not in (".png", ".jpg", ".jpeg"):
+            warns.append(f"logo.{field} is {lp.suffix}: fine for the flyer, but PowerPoint needs PNG or JPG — export one")
+
+    tpl = (brand.get("templates") or {}).get("pptx")
+    if tpl:
+        tp = (base / tpl) if not Path(tpl).is_absolute() else Path(tpl)
+        if not tp.exists():
+            fails.append(f"templates.pptx {tpl!r} does not exist")
+
+    fonts = brand.get("fonts") or {}
+    for role in ("heading", "body"):
+        f = fonts.get(role)
+        fam = f.get("family") if isinstance(f, dict) else f
+        if not fam:
+            warns.append(f"fonts.{role} is not set; generators fall back to their defaults")
+
+    for w in warns:
+        print(f"WARN {w}")
+    for f in fails:
+        print(f"FAIL {f}")
+    print(f"{'FAILED' if fails else 'OK'}: {path.name} — {len(fails)} failure(s), {len(warns)} warning(s)")
+    return 1 if fails else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv[1:]))

package/packs/design/skills/brand-kit/templates/brand.json

@@ -0,0 +1,54 @@
+{
+  "$comment": "brand-kit output. deck-builder and marketing-flyer read this file; any field left out is asked for or defaulted by them. Paths are relative to this file. Every value carries where it came from in `sources`.",
+  "name": "Northwind Health",
+  "tagline": "Care that comes to you",
+  "logo": {
+    "primary": "logo.png",
+    "on_dark": "logo-white.png",
+    "mark": "mark.png",
+    "notes": "Keep clear space equal to the height of the N on every side. Never place the full-colour logo on the green."
+  },
+  "colors": {
+    "primary": "#0E5A46",
+    "secondary": "#3D7F6B",
+    "accent": "#F2A541",
+    "background": "#FFFFFF",
+    "text": "#1F2A28",
+    "extra": [
+      { "name": "Mist", "hex": "#E8F1EE", "use": "panel backgrounds" }
+    ]
+  },
+  "fonts": {
+    "heading": { "family": "Georgia", "fallback": "serif", "weight": 700 },
+    "body": { "family": "Arial", "fallback": "sans-serif", "weight": 400 }
+  },
+  "voice": {
+    "tone": "Warm, plain, confident. Short sentences.",
+    "use": ["members", "care team", "near you"],
+    "avoid": ["patients", "cutting-edge", "solutions"]
+  },
+  "imagery": {
+    "style": "Real people in daylight, community settings, no stock handshakes.",
+    "do": ["natural light", "diverse ages"],
+    "dont": ["clinical close-ups", "illustrated icons as hero images"]
+  },
+  "templates": {
+    "pptx": "northwind-master.potx"
+  },
+  "contact": {
+    "website": "northwindhealth.example",
+    "email": "hello@northwindhealth.example",
+    "phone": "",
+    "address": ""
+  },
+  "legal": {
+    "footer": "© 2026 Northwind Health",
+    "disclaimer": ""
+  },
+  "sources": {
+    "colors": "brand guidelines PDF, page 4 [explicit]",
+    "fonts": "brand guidelines PDF, page 6 [explicit]",
+    "voice": "website About page [inferred]",
+    "logo": "files supplied by the user [explicit]"
+  }
+}