Marketing Skills OS is an open-source Marketing OS for AI agents.
It gives Claude Code, OpenAI Codex, Cursor, Windsurf, and other Agent Skills-compatible tools a complete operating layer for marketing strategy, workflows, tool references, CLI helpers, scorecards, reviews, launch assets, and execution loops.
The repo includes 76 skills, 347 integration guides, 62 CLI tools, templates, workflows, dashboards, and validation. You keep the open-source install path, then run marketing work through a structured local OS instead of scattered prompts.
The canonical public skill source is this repository's skills/ directory. Private AIOS workflow notes and installed runtime copies serve different purposes and are not competing product sources. See Skill Sources And Runtime Layers before adding or syncing skills.
Support this work
Marketing Skills OS was researched, designed, and built by one person. If it saves you time, helps you ship better marketing, or gives your agent capabilities it did not have before, consider supporting the work that made it possible.
☕ Buy me a coffee — buymeacoffee.com/dorcelusalain
CashApp — $AlainDorcelus
Every contribution directly funds new skills, improved frameworks, and continued maintenance of Marketing Skills OS.
Created and maintained by Alain Dorcelus · ScayverGraphix
Star this repo if you want AI agents that can do more than write code.
Marketing Skills OS gives Claude Code, OpenAI Codex, Cursor, Windsurf, and other Agent Skills-compatible tools a full marketing operating system:
- Strategy skills for positioning, launches, pricing, research, and business planning.
- Revenue skills for CRO, email, sales copy, RevOps, referrals, churn, and analytics.
- Content skills for SEO, blogs, LinkedIn, Instagram, ecommerce, PR, education, and customer support.
- Tool references for 347 platforms, APIs, CLIs, WordPress plugins, CRMs, email tools, automation tools, LMS platforms, and more.
If this saves you time, star it so more builders can find it.
| Use Case | Start With | What You Get |
|---|---|---|
| Launch a SaaS product | product-marketing, launch, email-marketing |
Positioning, launch plan, emails, social content, and PR assets |
| Improve a landing page | landing-page-cro, copywriting, ab-testing |
Audit, rewritten page sections, CTA tests, and FAQ schema |
| Build SEO traffic | seo-content-strategy, seo-blog-writer, schema |
Keyword map, content briefs, long-form posts, and structured data |
| Grow local leads | local-seo, customer-service, social-content-planner |
City pages, review replies, Google Business Profile copy, and local posts |
| Sell ecommerce products | ecommerce-content, email-marketing, ads |
Product pages, launch emails, ad hooks, and upsell copy |
| Build founder authority | linkedin-strategy, brand-storytelling, pr-communications |
Profile copy, thought leadership posts, founder story, and media pitches |
| Automate marketing ops | revops, analytics, tools/REGISTRY.md |
CRM fields, pipeline logic, reporting, and platform API references |
The public brand is Marketing Skills OS. The install path remains scayver/marketing-skills for compatibility with existing users, scripts, repo links, and Agent Skills tooling.
You ask your agent to "write copy for this landing page." It produces something that sounds reasonable, hits no specific framework, and could apply to any product in any industry.
You ask it to "write a press release." It returns a generic document that no journalist would open.
You ask it to "plan a LinkedIn content strategy." It lists five tactics you already knew.
The problem is not the agent. The problem is that the agent has no domain depth. It has broad knowledge but no structured process for marketing work specifically.
Marketing Skills OS gives the agent that process. Each skill is a markdown file that tells the agent exactly how to approach a specific marketing task: what questions to ask first, what framework to apply, how to structure the output, and what a good result actually looks like. The agent reads the skill and works from it while the OS connects context, workflow, tooling, measurement, and review.
Install Marketing Skills OS into your project. Your agent picks up the skills, workflow docs, integration guides, CLI helpers, and local .marketing-os/ workspace pattern.
When you describe a marketing task, the agent matches your request to the right skill and follows its process. You do not have to name the skill. You do not have to prompt engineer. You describe what you need and the agent does the work.
Every skill includes three things.
A trigger definition. The skill tells the agent exactly which requests it handles, including the specific phrases and task descriptions that activate it. When you say "respond to this Google review," the agent activates customer-service without any instruction from you.
A process. Each skill defines a step-by-step approach to the task. The pr-communications skill tells the agent to identify the media angle before writing a single line of the press release, produce the output table, then deliver the full press release with a wire summary and a social version. It does not let the agent skip steps.
An output standard. Every skill in Marketing Skills OS enforces the same content rules. Active voice. Short sentences. Direct address. No buzzwords. Dynamic depth based on the skill and task, from concise tactical answers to complete deliverables. The agent delivers structured, readable work that you can act on immediately.
Before using any other skill, run product-marketing once in your project.
It creates a context document that every other skill reads before doing any work. Your product name, target audience, positioning, value proposition, and competitive differentiation live there. You enter it once. Every skill uses it automatically. The copywriting skill does not ask you to re-explain your product. The cro skill does not ask who your users are. The email-marketing skill does not ask what you sell.
This is the dependency that makes the whole OS coherent.
For the shortest path from install to first workflow, read docs/GETTING_STARTED.md.
product-marketing is the root context skill. It should run first for any new product, offer, or business because the other skills depend on that positioning context.
product-marketing
├── Operating system
│ ├── marketing-os
│ ├── skill-security-auditor
│ └── env-secrets-manager
├── SEO and discovery
│ ├── seo-audit
│ ├── ai-seo
│ ├── site-architecture
│ ├── programmatic-seo
│ ├── schema
│ ├── aso
│ ├── seo-blog-writer
│ └── seo-content-strategy
├── Conversion optimization
│ ├── cro
│ ├── signup
│ ├── onboarding
│ ├── a11y-audit
│ ├── popups
│ ├── paywalls
│ └── landing-page-cro
├── Content and copy
│ ├── copywriting
│ ├── copy-editing
│ ├── cold-email
│ ├── emails
│ ├── email-marketing
│ ├── sms
│ ├── sales-copywriting
│ ├── social
│ ├── social-content-planner
│ ├── podcast-pipeline
│ ├── yt-competitive-analysis
│ ├── instagram-carousel
│ ├── content-repurposing
│ ├── content-humanizer
│ ├── ecommerce-content
│ ├── customer-service
│ ├── video
│ └── image
├── Paid media and measurement
│ ├── ads
│ ├── ad-creative
│ ├── social-media-analyzer
│ ├── ab-testing
│ └── analytics
├── Growth and retention
│ ├── referrals
│ ├── free-tools
│ ├── churn-prevention
│ ├── community-marketing
│ ├── lead-magnets
│ ├── co-marketing
│ └── directory-submissions
├── Sales and go-to-market
│ ├── revops
│ ├── prospecting
│ ├── prospect-research
│ ├── sales-enablement
│ ├── launch
│ ├── pricing
│ ├── competitors
│ └── competitor-profiling
├── Strategy and research
│ ├── marketing-ideas
│ ├── marketing-psychology
│ ├── market-research
│ ├── competitive-teardown
│ ├── customer-research
│ └── business-strategy
└── Brand and creator systems
├── brand-storytelling
├── brand-guidelines
├── linkedin-strategy
├── pr-communications
├── ai-image-creator
└── education-content
Cross-skill dependencies:
copywriting <-> cro <-> ab-testing
revops <-> sales-enablement <-> cold-email
prospect-research -> cold-email, linkedin-strategy, revops
seo-audit <-> schema <-> ai-seo
seo-blog-writer <-> seo-content-strategy
customer-research -> copywriting, cro, competitors
brand-storytelling -> linkedin-strategy, pr-communications
email-marketing <-> landing-page-cro <-> sales-copywriting
local-seo <-> seo-audit <-> seo-content-strategy
education-content -> content-repurposing, email-marketing
ai-image-creator -> instagram-carousel, social-content-planner
These skills follow the Agent Skills spec. They work in any agent that supports it.
| Agent | Supported |
|---|---|
| Claude Code | Yes |
| OpenAI Codex | Yes |
| Cursor | Yes |
| Windsurf | Yes |
| Any Agent Skills-compatible agent | Yes |
Skills install to .agents/skills/ by default. Claude Code also reads from .claude/skills/. The install command handles both locations automatically.
Install Marketing Skills OS with all 76 skills:
npx skills add scayver/marketing-skillsSpecific skills only:
npx skills add scayver/marketing-skills --skill email-marketing linkedin-strategy pr-communicationsSee what is available before you install:
npx skills add scayver/marketing-skills --listInstall globally (available in every project on your machine):
npx skills add scayver/marketing-skills --globalInstall across multiple agents at once with SkillKit:
npx skillkit install scayver/marketing-skillsAdd as a git submodule (pulls updates with your repo):
git submodule add https://github.com/scayver/marketing-skills.git .agents/marketing-skills
git submodule update --remote .agents/marketing-skillsClone and copy manually:
git clone https://github.com/scayver/marketing-skills.git
cp -r marketing-skills/skills/* .agents/skills/Fork and customize:
Fork this repo, modify skills for your product or voice, then install from your fork:
npx skills add YOUR_GITHUB_USERNAME/marketing-skillsInstall the full library, then try one of these requests in your agent:
Use product-marketing to build the positioning context for my SaaS.
Use landing-page-cro to audit this page and rewrite the hero, benefits, CTA, and FAQ section.
Use email-marketing to create a 5-email lead magnet nurture sequence for this offer.
Use local-seo to write a city page for HVAC repair in Austin, TX.
Use tools/REGISTRY.md to find the right CRM integration guide, then show me the contact sync API pattern.
More examples live in examples/README.md.
| Skill | Description |
|---|---|
marketing-os |
Root orchestration skill for building a full marketing operating system across strategy, demand, conversion, pipeline, retention, measurement, and assets |
skill-security-auditor |
Audit Agent Skills, imported skill files, scripts, prompts, and tool references for safety, routing, and repo policy risks |
env-secrets-manager |
Manage environment variables, API keys, secret rotation, deployment config, and credential hygiene |
| Skill | Description |
|---|---|
seo-audit |
Full technical, on-page, content, and off-page SEO audit with a scored action list |
ai-seo |
Optimize content for AI search engines: ChatGPT, Perplexity, Claude, and AI Overviews |
site-architecture |
Page hierarchy, navigation design, URL structure, and internal linking |
programmatic-seo |
SEO pages at scale using templates and structured data |
schema |
JSON-LD schema markup for rich snippets and AI search citation |
content-strategy |
Topic clusters, content pillars, editorial calendar, and distribution plan |
aso |
App Store and Google Play listing optimization: keywords, screenshots, reviews |
seo-blog-writer |
Long-form SEO blog production with keyword planning, outline approval, and multi-platform repurposing |
seo-content-strategy |
Keyword strategy, SERP analysis, content briefs, meta optimization, and blog-to-social repurposing |
local-seo |
City pages, service area content, Google Business Profile descriptions, and local review responses |
| Skill | Description |
|---|---|
cro |
Funnel analysis, friction diagnosis, ICE scoring, hypothesis writing, and A/B test design |
signup |
Signup and free trial flow optimization: fields, friction, and abandonment diagnosis |
onboarding |
Post-signup activation: aha moment, onboarding checklist, and time-to-value |
a11y-audit |
Accessibility audits for marketing pages, forms, checkout flows, dashboards, and UI components |
popups |
Exit intent, scroll triggers, lead capture, and announcement banners |
paywalls |
In-app upgrade screens, feature gates, and freemium-to-paid conversion |
landing-page-cro |
Landing page audits, hero rewrites, CTA optimization, FAQ schema, and feature-to-benefit conversion |
| Skill | Description |
|---|---|
copywriting |
AIDA, PAS, FAB, and Before/After/Bridge frameworks for any marketing page |
copy-editing |
Copy review, improvement, and content refresh for existing pages |
cold-email |
B2B cold outreach: subject lines, opening lines, sequences, and reply rate optimization |
emails |
Welcome sequences, nurture flows, re-engagement campaigns, and trigger-based emails |
sms |
SMS and MMS marketing strategy, opt-in flows, STOP and HELP handling, A2P 10DLC planning, and lifecycle texts |
social |
LinkedIn, X, Instagram, TikTok: posts, threads, carousels, and short-form video scripts |
image |
AI image generation, prompt writing, product mockups, OG images, and compression |
video |
AI video production, explainer scripts, demo structure, and distribution |
sales-copywriting |
Long-form sales letters, VSLs, direct response copy, and value proposition writing across 10 formats |
content-repurposing |
Transform one piece of content into six platform-native formats with humanization and topic generation |
content-humanizer |
Rewrite stiff or AI-pattern drafts into clearer, more specific, more natural, brand-aligned content |
podcast-pipeline |
Turn podcasts, interviews, webinars, and transcripts into show notes, clips, newsletters, blog posts, and social assets |
yt-competitive-analysis |
Analyze YouTube competitors, outlier videos, packaging patterns, content gaps, titles, and thumbnails |
instagram-carousel |
Slide-by-slide Instagram carousel scripts with captions, hashtags, and visual direction |
social-content-planner |
Instagram and Facebook content strategy with funnel-mapped weekly planning and Reels scripts |
customer-service |
Phone, chat, and email scripts; feedback responses; FAQ content; and help center articles |
ecommerce-content |
Product descriptions, category pages, Amazon listings, feature highlights, and comparison pages |
| Skill | Description |
|---|---|
ads |
Google, Meta, LinkedIn, and TikTok campaigns: targeting, bidding, and optimization |
ad-creative |
Hook writing, bulk creative generation, and creative testing frameworks |
analytics |
GA4 setup, event tracking, UTM parameters, tag management, and attribution |
social-media-analyzer |
Analyze social media performance, engagement quality, content patterns, channel ROI, and next tests |
ab-testing |
Hypothesis writing, sample size calculation, test design, and experimentation programs |
| Skill | Description |
|---|---|
referrals |
Referral programs, affiliate programs, and viral loop design |
free-tools |
Calculators, graders, and generators as a marketing and SEO channel |
churn-prevention |
Cancellation flows, save offers, dunning, payment recovery, and win-back |
community-marketing |
Community strategy, Discord and Slack management, ambassador programs |
lead-magnets |
Ebooks, templates, checklists, and Notion docs for email capture |
co-marketing |
Partner identification, joint campaigns, and integration partnerships |
directory-submissions |
Startup, SaaS, AI, and review directory submissions for backlinks and discovery |
| Skill | Description |
|---|---|
revops |
Lead scoring, routing, pipeline stages, CRM automation, and marketing-to-sales handoff |
prospecting |
Build qualified prospect lists with SaaS, B2B, developer-intent, partner, and local SMB research workflows |
prospect-research |
Account research, GitHub stargazer and fork signals, firmographic targeting, Apollo/ZoomInfo/Sales Nav mapping, local SMB research, and compliance screening |
sales-enablement |
Pitch decks, one-pagers, objection handling, demo scripts, and battle cards |
launch |
Product launches: pre-launch prep, Product Hunt, launch day checklist, and post-launch |
pricing |
Pricing models, tier structure, value metrics, and pricing page design |
competitors |
Comparison pages and alternative pages for SEO and sales positioning |
competitor-profiling |
Competitor research dossiers: positioning, pricing, messaging, and channels |
email-marketing |
Cold email, abandoned cart, lead magnet delivery, newsletter generation, and campaign repurposing |
| Skill | Description |
|---|---|
product-marketing |
Positioning, ICP, messaging hierarchy, and the context file all skills read first |
marketing-ideas |
Channel ideas, growth loops, underused tactics, and experiment prioritization |
marketing-psychology |
Anchoring, social proof, loss aversion, scarcity, and other biases applied to marketing |
market-research |
Market sizing, TAM SAM SOM, segmentation, category research, surveys, interviews, and demand validation |
competitive-teardown |
Deep competitor teardowns across positioning, UX, pricing, reviews, SEO, content, hiring, and roadmap signals |
customer-research |
Customer interviews, JTBD, review mining, surveys, and research-to-messaging translation |
ecommerce-product-opportunity-researcher |
Evidence-aware product discovery, opportunity scoring, unit economics, risk gates, and validation sprints |
business-strategy |
Business idea generation, full business plan development, and customer journey mapping across 7 stages |
| Skill | Description |
|---|---|
brand-storytelling |
Brand voice audits, About Pages, customer avatars, value propositions, and brand story writing |
brand-guidelines |
Create or audit brand guidelines, voice rules, messaging standards, visual identity rules, and channel examples |
linkedin-strategy |
LinkedIn posts, profile optimization, connection messages, DM sequences, and company page content |
pr-communications |
Press releases, media pitches, crisis communications, executive quotes, and PR repurposing |
ai-image-creator |
Image prompt generation, content asset maps, Instagram carousel and Story slide production |
education-content |
Course descriptions, Bloom's Taxonomy objectives, module outlines, workshop descriptions, and curriculum maps |
The tools/ directory gives your agent standalone platform references it can use beside the skills.
tools/
clis/ 62 JavaScript CLI tools
integrations/ 347 standalone platform integration guides
composio/ Composio marketing tool references
REGISTRY.md Full tool index
CLI tools include: GA4, Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, Klaviyo, Mailchimp, HubSpot, Segment, Mixpanel, Amplitude, Ahrefs, SEMrush, Hotjar, Intercom, Paddle, GitHub prospecting, and more.
Integration docs cover: direct APIs, authentication, common agent operations, key fields, parameters, rate limits, and relevant skills for each platform. They are independent platform references, not connector-specific setup notes.
The original Bit Integrations source list is preserved at tools/integrations/bit-integrations-registry.md, while the individual platform docs now live directly in tools/integrations/.
Create a working marketing command center inside any project:
npm run os:init -- --target ../my-projectThis creates a local .marketing-os/ folder with product context, campaign brief, command center, scorecard, experiment backlog, compliance checklist, customer learning log, workflow recipes, and the machine-readable Marketing OS manifest.
Preview the OS inventory:
npm run os:summaryActivate a workflow in a project workspace:
npm run os:run -- --target ../my-project --workflow saas-launch --forceCreate a weekly review from the active workflow:
npm run os:review -- --target ../my-project --date 2026-05-28 --forceCheck the workspace status:
npm run os:status -- --target ../my-projectPersist the current OS state for future agent sessions:
npm run os:snapshot -- --target ../my-project --date 2026-05-28 --forceCreate an inspectable run record before execution:
npm run os:run-record -- create --target ../my-project --workflow saas-launch --request "Prepare the launch plan" --dry-run
npm run os:run-record -- create --target ../my-project --workflow saas-launch --request "Prepare the launch plan"
Inspect, resume, export, or trace a run:
npm run os:run-status -- --target ../my-project --run-id <run-id>
npm run os:resume -- --target ../my-project --run-id <run-id>
npm run os:export -- --target ../my-project --run-id <run-id> --format markdown
npm run os:lineage -- --target ../my-project --run-id <run-id>
Generate the dashboard:
npm run os:dashboardRegenerate the outcome index after changing workflows, skills, integrations, or CLI helpers:
npm run os:indexThis repo now includes a validation layer so agents and contributors can trust the package before installing it.
npm run validateThe validator checks skill frontmatter, mandatory skill sections, integration registry coverage, CLI syntax, local documentation links, required community files, and current package counts. GitHub Actions runs the same validation on every push and pull request.
Test the package in a Claude Code-style sandbox:
npm run test:claude-codeKeep the generated sandbox for manual Claude Code prompts:
npm run test:claude-code -- --keepUseful docs:
- Getting started.
- Example workflows.
- Documentation index.
- Marketing OS docs.
- Claude Code testing guide.
- Marketing OS manifest.
- Marketing Skills OS dashboard.
- Static HTML dashboard.
- Marketing Skills OS outcome index.
- Marketing OS initializer templates.
- Command center template.
- Social posting kit.
- Demo walkthrough.
- Social post library.
- Compliance reference.
- Validation guide.
- Security policy.
Every skill enforces the same rules on every word of output. There are no exceptions.
Output length is dynamic. The agent matches the depth to the task: concise answers for quick checks, structured tables for audits or plans, and full detailed deliverables when the request calls for a complete artifact.
Every sentence uses active voice. Passive constructions are not allowed.
The agent addresses you directly. "You" and "your" appear throughout. Generic third-person advice does not.
No em dashes. No hidden Unicode characters. Commas, semicolons, and periods replace them.
No hashtags, emojis, or asterisks in any strategy or long-form output. Social media repurposed formats use platform-appropriate formatting only.
No AI buzzwords. The agent does not write "leverage," "unlock," "game-changer," "dive into," "cutting-edge," or any variation of these.
No filler phrases. "In conclusion," "in summary," and "in a world where" do not appear.
Every section ends with a specific, actionable next step. No section closes with vague advice.
Unreleased — Consolidated the canonical Marketing Skills folder and added five skills: brand review, campaign brief generator, customer story builder, paid ads operations, and ecommerce product opportunity research. The repository now contains 76 skills with one public source of truth and explicit runtime-layer documentation.
v1.7.0 (2026-05-28) — Added Marketing OS workflow index, command-center template, machine-readable OS manifest, and npm run os:summary.
v1.6.0 (2026-05-28) — Added the marketing-os orchestration skill plus Marketing OS architecture docs, playbooks, and scorecards.
v1.5.0 (2026-05-28) — Added a generated social post library with one post for every skill, integration guide, and CLI tool, plus mixed category campaign posts for launch and education.
v1.4.0 (2026-05-27) — Added repository validation automation, GitHub Actions CI, security and conduct docs, compliance and demo docs, expanded issue templates, .gitignore, and CLI index coverage.
v1.3.0 (2026-05-27) — Added prospect-research for SaaS developer-intent signals, B2B trigger-event research, local SMB website classification, and outreach compliance checks. Added github-prospects.js plus a standalone GitHub integration guide for stargazers, forks, and watcher research.
v1.2.0 (2026-05-15) — Tool system expansion and cleanup. The project now includes 346 standalone integration guides, 61 JavaScript CLI tools, and a regenerated tools registry. The former Bit Integrations tool docs were flattened into tools/integrations/ and rewritten as independent platform references.
v1.1.0 (2026-05-15) — 17 new skills added by Alain Dorcelus: sales-copywriting, instagram-carousel, social-content-planner, brand-storytelling, business-strategy, content-repurposing, landing-page-cro, customer-service, ecommerce-content, seo-blog-writer, ai-image-creator, education-content, email-marketing, linkedin-strategy, local-seo, pr-communications, seo-content-strategy. Total skill count: 57.
v1.0.0 (2026-05-15) — Initial release. 40 skills, 63 CLI tools, 80+ integration docs. All skills enforce mandatory content standards. Compatible with Claude Code, OpenAI Codex, Cursor, Windsurf, and all Agent Skills-compatible agents.
Full release history: CHANGELOG.md.
Marketing Skills OS was created and is maintained by Alain Dorcelus (ScayverGraphix).
The 17 custom skills added in v1.1.0 represent original instructional design work covering email marketing, brand storytelling, LinkedIn strategy, public relations, local SEO, e-commerce content, education content development, AI image creation, and more. Each skill was researched, structured, and written from scratch to meet the same output standards as the original library.
If Marketing Skills OS saves you hours of prompting, gives your agent new capabilities, or ships better marketing for your business, consider supporting the work directly.
Support Alain's work:
- ☕ buymeacoffee.com/dorcelusalain
- 💸 CashApp: $AlainDorcelus
Marketing Skills OS also draws on the Agent Skills spec published by vercel-labs/skills.
Start with the docs/README.md documentation index.
The most important docs are:
docs/GETTING_STARTED.mdfor first-run setup.docs/MARKETING_OS.mdfor the operating model, workflows, playbooks, and scorecards.docs/ROADMAP.mdfor planned improvements.docs/FAQ.mdfor quick answers.
AGENTS.mdtells coding agents how to use and extend the repo.CONTRIBUTING.mdexplains how to add skills, tools, and docs.VALIDATION.mdlists the local checks to run before pushing.examples/README.mdgives copy-paste prompts for new users.tools/REGISTRY.mdindexes every standalone integration guide.
Open a pull request with a new or improved skill. The only requirements are a SKILL.md with valid frontmatter and instructional content that follows the output standards above. Include a one-sentence description of what the skill does and when it activates.
For bugs or questions, open an issue on GitHub.
MIT. Copyright 2026 Alain Dorcelus (ScayverGraphix). See LICENSE for the full text.