feat: package the whole repo as a single skill

[wesleysimplicio]

Summary

Turns the entire marketing-engine repo into one invocable skill in the Anthropic Skills format. Adds a top-level SKILL.md with full frontmatter and an in-tree reference index pointing at every sub-skill, design doc, and provider implementation. CLAUDE.md and README.md get a one-line breadcrumb so both agents and humans find the entry point first.

The 16 sub-skills under .skills/ stay as they are — they're the building blocks. This new root SKILL.md is the package: one capability, one entry point.

What's in SKILL.md

• Frontmatter — name: marketing-engine, description, version, license, repository.
• When to invoke — piece pipeline, new client onboarding, new provider, re-render, compliance gate, captions fan-out, ads handoff, metrics.
• Inputs — piece_path, client_slug, stage, task_type (abstract, never a provider name), dry_run.
• Process — the full mandatory per-piece loop (brief → script → creative → caption → compliance → publish → metrics → ads).
• Outputs — manifest.json, script.md, captions.json, creative artefacts, append-only audit logs, Playwright evidence.
• Definition of Done — 6 gates from CLAUDE.md restated.
• Sub-skills — all 16 listed by category (Dispatch, Copy, Image specialists, Video specialists, Gates, Bootstrap, Tooling).
• Provider-agnostic principle — re-stated as the load-bearing invariant.
• Stack table — LLM / Image / Video / Publishing / Ads / Calendar with default-first ordering.
• CLI surface — npx marketing-engine init|check|generate|promote.
• Add-a-provider — the three-step contract.
• Add-a-client — the four-step playbook.
• Non-negotiable rules — provider hardcoding, mocks-in-prod, push-to-main, secrets, real calls in CI.
• References — pointers to CLAUDE.md, AGENTS.md, .specs/architecture/*, lib/providers/, .skills/*/SKILL.md, e2e/, bootstrap.{sh,ps1}.
• Upstream — links to repo, HyperFrames, yool-tuple-hamt.

Test plan

• Anyone (human or agent) opening the repo finds SKILL.md at the root and can reach every capability from it without spelunking.
• npx marketing-engine generate still routes through the same dispatchers — the SKILL.md changes no runtime behavior.
• An external skill-aware client (e.g. skills add wesleysimplicio/marketing-engine) parses the frontmatter cleanly.

https://claude.ai/code/session_01H7AkCb3czV1qAwvUjPGWJC

---

Generated by Claude Code