Boring Marketing Skills
boringmarketer/boring-marketing-skills (MIT, commit bd5aaed, 559 GitHub stars / 214 forks) is an open-source marketing operating system built for coding agents. It ships 32 SKILL.md skills (spanning ads-incrementality-check through start-here), 8 JSON schemas in _system/schemas/, 5 recurring routines in automations/routines/, and 2 multi-skill workflows (campaign-fanout.md, full-funnel-build.md) backed by routing and lint helpers.
1. 32 skills, 8 JSON schemas & 5 scheduled routines
At commit bd5aaed, the repository organizes agent marketing work around typed contracts rather than ad-hoc prompts:
- 32 modular skills (
skills/): Covers strategy, research, acquisition, and conversion (start-here,ads-incrementality-check, programmatic SEO, email sequences, landing pages, and positioning). - 8 structured JSON schemas (
_system/schemas/*.schema.json):ad-matrix,brand-manifest,campaign-brief,content-brief,email-sequence-summary,keyword-plan,voc, andvoice-profileso downstream skills read structured artifacts from upstream steps. - 5 automation routines (
automations/routines/):ai-citation-monitor.md,brand-health-check.md,monthly-performance-review.md,weekly-competitor-watch.md, andweekly-content-ritual.md. - 2 end-to-end workflows & helper scripts:
campaign-fanout.mdandfull-funnel-build.md, paired with_system/scripts/helpers (route.py,doctor.sh, andcheck_banned.sh) to verify environment readiness and catch banned cliché copy.
2. Install with npx skills or Git clone
1. Cross-agent CLI (npx skills):
npx skills add boringmarketer/boring-marketing-skills
2. Clone and run environment diagnostics (doctor.sh):
git clone https://github.com/boringmarketer/boring-marketing-skills.git
cd boring-marketing-skills
bash _system/scripts/doctor.sh
Start sessions with skills/start-here/SKILL.md so the router (_system/scripts/route.py) maps your goal to the right schema and playbook. Review Agent skill security vetting before enabling third-party scripts in shared repositories.
3. Optional paid connectors & script execution boundaries
- Free core vs. optional paid APIs: Built-in prompt workflows work without paid subscriptions using your agent's own web access; live SERP/scrape routines optionally integrate Exa, Firecrawl, or DataForSEO when their keys are provided.
- Local shell scripts:
_system/scripts/includes bash and Python utilities (route.py,doctor.sh,check_banned.sh); inspect scripts before running automated cron routines inside production repositories. - Claim hygiene: Automated SEO and competitor-watch outputs still require human verification of pricing, statistics, and brand claims prior to publishing.
Frequently asked questions
How many skills and schemas are in boringmarketer/boring-marketing-skills?
At commit bd5aaed, the repository contains 32 SKILL.md modules, 8 JSON schemas in _system/schemas/, 5 automation routines in automations/routines/, and 2 end-to-end workflows (campaign-fanout.md and full-funnel-build.md).
Do I need paid APIs like DataForSEO or Firecrawl to use Boring Marketing Skills?
No. Core positioning, brief creation, schema validation, and copywriting skills work free with an agent's built-in web and file capabilities. Exa, Firecrawl, and DataForSEO are optional connectors for live automated scraping and keyword lookups.
How do you install Boring Marketing Skills in Claude Code or Codex?
Run npx skills add boringmarketer/boring-marketing-skills, or clone the MIT repository and point your agent at skills/start-here/SKILL.md.