Agent skill

Marketing Os

by Yuzzyuk in Yuzzyuk/marketing-os

A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.

MITAuto-check passedMarketing & SEO

Install Marketing Os

skills CLI
$ npx skills add Yuzzyuk/marketing-os --skill marketing-os -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Yuzzyuk/marketing-os marketing-os --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Yuzzyuk/marketing-os.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/marketing-os .claude/skills/marketing-os && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
marketing-os
GitHub stars
540
Token cost
~2.5k tokens
SKILL.md length
927 words
Files
20 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.

  • Works in 3 steps: Score everything. Findings without a… → Ship artifacts, not advice. Write the… → State what you couldn't determine. Every…
  • ANY marketing task — audit
  • SKILL.md covers Setup — always do this first, Routing, Subagent fan-out and Shared output standards, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Marketing Os is an agent skill from Yuzzyuk/marketing-os. A complete marketing department in one skill. Website and landing-page audits with weighted 0-100 scores, copywriting with panel scoring and AI-slop removal, an 18-tactic ad hook engine, GEO/AEO for getting cited by ChatGPT/Perplexity/AI Overviews, paid-ads creative diagnosis and production briefs, email sequences, LinkedIn/X writing, launch playbooks, positioning and offer design, competitor teardowns, app store optimization, honest analytics and test design. Use for ANY marketing task — audit, write, rewrite…

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including reference files (for example `brand-context.template.md`, `references/ads-diagnostics.md` and `references/analytics.md`).

It sits in Marketing & SEO, covering AI search optimization, Copywriting and Landing pages. It works with OpenAI, Perplexity and LinkedIn. The repository describes itself as: An entire marketing department as one Claude skill. 14 modules: audits scored 0-100, an 18-tactic hook engine, copy graded before you see it, ad diagnosis, GEO, email, launches… The licence is MIT.

When your agent uses it

  • ANY marketing task — audit
  • Analyze — whenever the user mentions marketing
  • Says my landing page sucks
  • Nobodys converting

Example prompts

  • “my landing page sucks”
  • “nobody”
  • “why are my CPMs up”
  • “/marketing-os”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Score everything. Findings without a number are hard to act on and easy to argue with. Every audit ends in a weighted 0-100.
  2. Ship artifacts, not advice. Write the replacement headline, the JSON-LD block, the email, the screenshot caption. "Your headline is vague"…
  3. State what you couldn't determine. Every report ends with an explicit gaps section. A stated gap is credible; a silently filled one…

What it can do on your machine

Read from SKILL.md and the folder at commit bb67dff. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Marketing Os loads about 2.5k tokens when it runs, and up to ~32k if it reads all its reference files. Until then it costs about 259 tokens; SKILL.md has 927 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~259
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~32k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Yuzzyuk/marketing-os at commit bb67dff, republished under its MIT licence (© Yuzzyuk). 927 words, ~2,479 tokens.

Download SKILL.mdSave it as .claude/skills/marketing-os/SKILL.md (or your agent's skills folder). This skill also uses 19 other files; get the full folder from GitHub.
name
marketing-os
description
A complete marketing department in one skill. Website and landing-page audits with weighted 0-100 scores, copywriting with panel scoring and AI-slop removal, an 18-tactic ad hook engine, GEO/AEO for getting cited by ChatGPT/Perplexity/AI Overviews, paid-ads creative diagnosis and production briefs, email sequences, LinkedIn/X writing, launch playbooks, positioning and offer design, competitor teardowns, app store optimization, honest analytics and test design. Use for ANY marketing task — audit, write, rewrite, diagnose, score, plan, launch, position, price, analyze — whenever the user mentions marketing, growth, conversion, copy, ads, hooks, CPM, ROAS, SEO, GEO, email, social, landing pages, funnels, launches, competitors, brand, positioning, pricing, or app stores, or says "my landing page sucks", "nobody's converting", "why are my CPMs up", "AI doesn't recommend us", "write me 20 hooks". Route via the table inside; fan out subagents for multi-dimensional work. Not for pure engineering, legal, or finance.
license
MIT
metadata.author
marketing-os
metadata.version
1.1

Marketing OS

One skill, fourteen modules, the full surface a working marketer touches. Built by tearing down the most-starred marketing skill repos on GitHub (44K-star collections down to 100-star craft pieces), keeping what worked, and fixing what every one of them got wrong.

Three rules hold across every module, because they are what the existing ecosystem uniformly lacks:

  1. Score everything. Findings without a number are hard to act on and easy to argue with. Every audit ends in a weighted 0-100.
  2. Ship artifacts, not advice. Write the replacement headline, the JSON-LD block, the email, the screenshot caption. "Your headline is vague" is worthless; the rewritten headline is the deliverable.
  3. State what you couldn't determine. Every report ends with an explicit gaps section. A stated gap is credible; a silently filled one destroys the document.

Setup — always do this first

Read brand-context.md if it exists (working directory, .claude/, or .agents/). It holds the product, ICP, positioning, proof, voice and constraints, and it changes nearly every judgement below. If absent: proceed, say the output is un-contextualised, and offer to generate the file from what you learn — brand-context.template.md in this skill is the blank.

Identify the task type, then open ONLY the module file(s) needed. Do not load all references — the routing below exists so you load ~1 file, not 13.

Routing

The user wants to...ModuleAlso often needed
Audit/review/score/roast a website, landing page, funnel; "why isn't this converting"references/audit.mdaudit-rubric.md
Get cited by ChatGPT/Perplexity/AI Overviews; GEO, AEO, llms.txt, "AI doesn't recommend us"references/geo.mdgeo-engines.md
Write/rewrite anything: headlines, ads, pages, "make this punchier", "sounds AI-written"references/copy.mdcopy-frameworks.md, slop-patterns.md
Hooks for ads/video: "write me 20 hooks", thumbstop problems, hook batches per segmentreferences/hooks.mdpaid-ads.md, slop-patterns.md
Diagnose paid ads: CPM up, ROAS down, fatigue, "what to test next", competitor's adsreferences/paid-ads.mdads-diagnostics.md, hooks.md
Email: welcome/nurture/launch sequences, subject lines, deliverabilityreferences/email.mdslop-patterns.md
LinkedIn/X posts, personal brand, content that doesn't read as AIreferences/social.mdslop-patterns.md
Launch a product, feature, or Product Hunt runreferences/launch.mdcopy.md
Positioning, category, offer design, pricing page strategyreferences/positioning.md—
Tear down a competitor: site, ads, positioningreferences/competitive.mdpaid-ads.md
App Store / Google Play: listing, screenshots, keywords, install ratereferences/app-store.mdstore-specs.md
Read performance data honestly, design a test, "did this work?"references/analytics.md—

Multi-part requests load multiple modules. "Audit my site and rewrite the homepage" = audit.md then copy.md, carrying the audit findings forward rather than re-researching.

Every de-slop pass — copy, email, social — runs slop-patterns.md before delivery. No exceptions. A reader who clocks output as AI-written discounts the claim, not just the prose.

Subagent fan-out

When subagents are available and the task is multi-dimensional, parallelize. This is the difference between a 15-minute audit and a 2-hour one.

Full marketing audit — spawn six, one per scoring dimension (messaging, conversion, search, competitive, trust, growth), each with the URL set and its slice of audit-rubric.md. Synthesize their sub-scores into the weighted total yourself; never delegate the synthesis, because the pattern across dimensions is the product.

GEO audit — spawn one per target question to query engines and record who gets cited, plus one for on-page extractability.

Competitor teardown — one per competitor.

Copy generation — one per angle family (problem/outcome/contrarian/identity/mechanism/offer) generating 3-4 variants each; you run the scoring panel on the merged set.

Paid ads — one per concept cluster for classification; you do the fatigue diagnosis on the merged concept table.

Rules for fan-out: give each subagent its exact reference slice and output schema; launch all in one turn; never let a subagent write the final report. If subagents are unavailable, work the dimensions sequentially in the order listed — the sequence is deliberate.

Show full SKILL.md (333 more words)Show less

Shared output standards

Reports follow this skeleton, adapted per module:

# [Deliverable] — [subject]
[date] · Score: XX/100 (where applicable) · Basis: [what you had access to]

## The one thing
[The pattern behind the findings, one paragraph. If they read nothing else.]

## Scorecard / Findings
## Do these first
[3-5 items, each with the actual fix written out, effort S/M/L, confidence H/M/L]

## What's already working
[Never skip. All-negative reports read as generated.]

## What I couldn't determine

Write reports to files ([module]-[subject]-[date].md), not into the chat — these are documents people forward.

Copy deliverables lead with the copy, reasoning after. Recommended option first, scored runners-up, then the single sharpest test contrast.

Honesty spine — applies to every module

  • All scores are heuristics from marketing judgement, not measured performance or anyone's internal ranking data. Say so in the report, every time.
  • Never invent proof. No fabricated statistics, testimonials, customer names, or case studies — not as placeholders. Write [NEED: figure] and flag it. A plausible fake number in marketing copy is how a client ships a false-advertising claim.
  • Never declare winners on small samples. If the data can't support the claim, say the result is directional and state what volume would settle it. analytics.md has the discipline.
  • Do not anchor on scores, numbers, or conclusions the user supplies. Form an independent read first, then compare and say where you differ.
  • Say when the problem isn't the deliverable. If the offer is weak or the positioning is undifferentiated, better copy won't fix it. One uncomfortable sentence saves a wasted quarter.
  • Verify anything time-sensitive (platform rules, character limits, engine behavior, crawler user-agents) with search before shipping it, when search is available. These change on a scale of weeks.
  • Never handle credentials or touch live campaigns/accounts. Diagnose and prescribe; the human executes in-platform.

Module directory

references/
├── audit.md              Website & funnel audit workflow
├── audit-rubric.md       Scoring bands for the six dimensions
├── geo.md                AI-search citability workflow
├── geo-engines.md        Per-engine behavior (Google AI, ChatGPT, Perplexity), llms.txt, crawlers
├── copy.md               Generate wide → panel-score → de-slop
├── copy-frameworks.md    Awareness stages, 12 angles, headline groups, offer construction, channel limits
├── hooks.md              Hook engine: 3-component spec, 18 tactics, diagnostic funnel, fidelity ladder
├── slop-patterns.md      AI-tell catalogue — run before delivering any prose
├── paid-ads.md           Concept classification, fatigue, coverage gaps, production briefs
├── ads-diagnostics.md    The fatigue decision table & honest data reads
├── email.md              Sequence architecture, subject lines, deliverability
├── social.md             LinkedIn/X writing that survives the feed
├── launch.md             Launch playbook incl. Product Hunt
├── positioning.md        Positioning, offer design, pricing strategy
├── competitive.md        Competitor teardown protocol
├── app-store.md          ASO: diagnosis, metadata, screenshots, reviews
├── store-specs.md        App Store vs Play field rules (they invert)
└── analytics.md          Test design, sample honesty, attribution traps

Chaining

Modules feed each other. Common chains, in order:

  • audit → copy (audit found messaging problems; now write the fixes)
  • audit → geo (page ranks but is never cited)
  • paid-ads → hooks → copy (brief → hooks written to spec → body copy)
  • paid-ads → production (an ad-generation MCP is connected, e.g. Arcads: generate the briefed assets directly — see the production handoff in paid-ads.md)
  • competitive → hooks (cluster their hooks to read their strategy) → positioning (the open flank)
  • positioning → copy → launch (new positioning cascades outward)
  • app-store → copy (listing copy needs real work)

When chaining, carry evidence forward. Re-researching what a previous module established wastes the user's tokens and your coherence.

© Yuzzyuk, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 19 other files (references) in skills/marketing-os of Yuzzyuk/marketing-os.

  • SKILL.md
  • brand-context.template.md
  • references/ads-diagnostics.md
  • references/analytics.md
  • references/app-store.md
  • references/audit-rubric.md
  • references/audit.md
  • references/competitive.md
  • references/copy-frameworks.md
  • references/copy.md
  • references/email.md
  • references/geo-engines.md
  • references/geo.md
  • references/hooks.md
  • references/launch.md
  • references/paid-ads.md
  • references/positioning.md
  • references/slop-patterns.md
  • references/social.md
  • references/store-specs.md

Open the folder on GitHubat commit bb67dff

Compare with similar skills

Marketing Os next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Marketing Os compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Marketing Os this skillYuzzyuk/marketing-os540—~2.5kAutomated safety check: PassMIT
SEO Geo OptimizerNeverSight/learn-skills.dev2171 repos~2.6kAutomated safety check: PassMIT
SEO AgiLeoYeAI/openclaw-master-skills2.2k—~6.4kAutomated safety check: NotesMIT
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT
Geoliangdabiao/GEO-Content-Optimizer-Skill2051 repos~2.3kAutomated safety check: NotesMIT
Ad Creativecoreyhaines31/marketingskills54k—~6.3kAutomated safety check: PassMIT

Similar skills

  • SEO Geo Optimizer

    NeverSight/learn-skills.dev

    Comprehensive SEO/GEO/AEO analysis toolkit for optimizing content visibility across traditional search engines (Google, Bing), AI platforms (ChatGPT, Perplexity, Claude, Gemini, Grokipedia), answer…

    217 GitHub starsUsed in 1 repo~2.6k tokens
    Marketing & SEOAuto-check passed
  • SEO Agi

    LeoYeAI/openclaw-master-skills

    Write SEO pages that rank in Google AND get cited by LLMs (ChatGPT, Perplexity, Claude).

    2.2k GitHub stars~6.4k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check: notes
  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • Geo

    liangdabiao/GEO-Content-Optimizer-Skill

    完整的 GEO(生成式引擎优化)服务流水线:给一个产品官网 URL 和介绍材料, 做站点诊断与 AI 答案采样、生成带验收标准的执行工单、产出可直接部署的资产 (llms.txt / JSON-LD / 定义块 / FAQ / 内容大纲与初稿)、自动验收工单是否闭环、 并打包成可直接发给客户的交付物。可按周期复跑,做长期 GEO 运营与月报。

    205 GitHub starsUsed in 1 repo~2.3k tokens
    Marketing & SEOAuto-check: notes
  • Ad Creative

    coreyhaines31/marketingskills

    When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform.

    54k GitHub stars~6.3k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Geo Optimizer

    liangdabiao/GEO-Content-Optimizer-Skill

    GEO (Generative Engine Optimization) 全流程优化工具。帮助品牌内容被 ChatGPT、Perplexity、Gemini 等 AI 搜索引擎引用。

    205 GitHub stars~1.1k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed

Categories

Questions about Marketing Os

What does Marketing Os do?

A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os. Marketing Os is an agent skill from Yuzzyuk/marketing-os. A complete marketing department in one skill.

When should I use Marketing Os?

Marketing Os fits situations like: ANY marketing task — audit; analyze — whenever the user mentions marketing; says my landing page sucks; nobodys converting.

How do I install Marketing Os in Claude Code?

Run `npx skills add Yuzzyuk/marketing-os --skill marketing-os -a claude-code`. Or copy the skill folder (skills/marketing-os in Yuzzyuk/marketing-os) into .claude/skills/marketing-os in your project. Claude Code loads it when a task matches its description.

How do I install Marketing Os in Codex?

Run `npx skills add Yuzzyuk/marketing-os --skill marketing-os -a codex`. Or copy the skill folder (skills/marketing-os in Yuzzyuk/marketing-os) into .agents/skills/marketing-os in your project. Codex loads it when a task matches its description.

Can I use Marketing Os in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Yuzzyuk/marketing-os --skill marketing-os -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/marketing-os, .gemini/skills/marketing-os, .github/skills/marketing-os and .opencode/skills/marketing-os in your project.

What does Marketing Os need to run?

SKILL.md names no scripts, command-line tools or credentials: Marketing Os is instructions for the agent only.

Does Marketing Os access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Marketing Os safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Marketing Os use?

Marketing Os is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Marketing Os use?

About 2.5k tokens (SKILL.md is roughly 9.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 29k tokens, read only when the agent opens those files.

What are the alternatives to Marketing Os?

Skills that share tags, products or a category with Marketing Os: SEO Geo Optimizer (NeverSight/learn-skills.dev, 217 stars), SEO Agi (LeoYeAI/openclaw-master-skills, 2.2k stars), Geo Fundamentals (wasp-lang/wasp, 19k stars) and Geo (liangdabiao/GEO-Content-Optimizer-Skill, 205 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Marketing Os?

Yuzzyuk (a GitHub user) maintains it in Yuzzyuk/marketing-os, which has 540 GitHub stars. The repository was last updated on August 17, 2026.

Source: Yuzzyuk/marketing-os on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.