marketing-skills

Marketing Skills: Marketing & SEO Workflows for AI Agents

Marketing Skills is an open-source library of reusable marketing and SEO workflows for AI agents. Install the skills your task needs, provide real product context, and get structured work grounded in explicit methods, checks, and source rules.

The library covers technical and on-page SEO, research, content, channels, paid advertising, launch and commercial strategy, and platforms. Page construction routes to Pagina; interface component construction routes to Bricks; analytics methods and execution route to Open Analytics.

Marketing methods for agents. Project truth stays with the project.

Quick start

Install a focused set of skills for the task:

npx skills add kostja94/marketing-skills \
  --skill seo-strategy keyword-research content-strategy

Then give your agent a real assignment:

Use seo-strategy to create a prioritized SEO plan for this product.
Read {project}.md and the current website first. Separate verified facts,
assumptions, opportunities, and next actions.

Other useful commands:

# Browse available entries
npx skills add kostja94/marketing-skills --list

# Install the complete library
npx skills add kostja94/marketing-skills

Install two or three relevant skills when the task is known instead of loading the entire library into one task. The CLI installs skills only; clone the repository when you also need templates/ or the full documentation set.

Choose a workflow

Goal	Start with
Build an SEO roadmap	seo-strategy
Fix crawling, indexing, sitemap, or canonical issues	robots-txt, indexing, xml-sitemap, canonical-tag
Audit or implement page metadata end to end	page-metadata
Improve one title, description, schema, or internal-link concern	title-tag, meta-description, schema-markup, internal-links
Audit citations, third-party destinations and embeds in Blog articles	outbound-links
Research keywords, competitors, or content opportunities	keyword-research, competitor-research, content-strategy
Expand, cluster, prioritize, or map keywords	keyword-discovery, keyword-clustering, keyword-opportunity, keyword-mapping
Plan launch, positioning, pricing, or acquisition	product-launch, gtm-strategy, pricing-strategy, cold-start-strategy
Plan paid acquisition	paid-ads-strategy plus the relevant platform skill
Track search and AI traffic	Open Analytics: analytics-tracking, google-search-console, ai-traffic-tracking
Build a complete page	Pagina page-builder
Build an interface component	Bricks component-builder

See the full prompt-to-skill mapping and skill reference.

What Agent Skills add

An Agent Skill is a version-controlled directory with a SKILL.md file containing discovery metadata and procedural instructions. It differs from a one-off prompt by giving agents a reusable workflow they can load when a matching task appears.

Marketing Skills packages:

• task scope and routing rules;
• step-by-step methods and decision criteria;
• required inputs and missing-information checks;
• output structures and verification steps;
• boundaries between adjacent skills and repositories;
• reference rules for claims that require current external evidence.

The skills do not replace product facts, professional judgment, platform access, or human approval. Results still depend on the task, evidence, agent, tools, and review process.

Library scope

The repository currently contains 170+ installable entries across 9 top-level categories. That total includes active marketing skills and compatibility entries for page, component, and analytics names maintained in Pagina, Bricks, and Open Analytics.

Category	Maintained responsibility
SEO	Technical, on-page, content, off-page, local, programmatic, entity, and SERP workflows
Content	Articles, copywriting, translation, video, podcast, and visual content
Paid Ads	Cross-platform strategy plus platform and format guidance
Channels	Affiliate, email, influencer, referral, directories, community, and PR
Platforms	X, Reddit, LinkedIn, TikTok, YouTube, Medium, Pinterest, GitHub, and Grokipedia
Strategies	Launch, brand, SEO structure, pricing, domain, localization, GEO, GTM, and PMF
Analytics	Compatibility entries; traffic, tracking, Search Console, SEO monitoring, and AI traffic are maintained in Open Analytics
Pages	Compatibility entries routing complete page construction to Pagina
Components	Compatibility entries routing interface components to Bricks; brand visual, favicon, and URL slug remain here

The machine-discoverable list is available through npx skills add kostja94/marketing-skills --list. Detailed ownership and dependencies live in docs/skills-reference.md.

How the ecosystem fits together

Contextus
durable product and project truth
        ↓
Marketing Skills
SEO · content · channels · ads · strategy
        ├── complete page construction → Pagina
        ├── interface component construction → Bricks
        └── analytics methods and execution → Open Analytics

Project	Single source of truth
Contextus	Durable organization, product, audience, brand, website, technical, decision, and change context
Marketing Skills	Reusable marketing, SEO, channel, platform, and strategy methods
Pagina	Complete page responsibilities, composition, states, and verification
Bricks	Interface component responsibilities, variants, boundaries, and verification
Open Analytics	Analytics methods, data contracts, source adapters, workflows, and reporting

These repositories work independently. Compatibility entries preserve old skill names without creating duplicate page, component, or analytics guidance.

Project context

Tailored marketing work needs real product facts. Contextus is the recommended maintained source, with a root {project}.md as the standard entry. Substitute the stable project slug, or follow the project README pointer and verify the subject in the manifest.

Marketing Skills reads only task-relevant context. It does not create a second context schema or silently promote agent research into confirmed product truth. Without Contextus, provide sufficient project documents or facts in the task; the skills remain usable and should ask only for missing information that would materially change the result.

npx skills add kostja94/contextus --skill contextus

Legacy project-context.md files remain readable as fallback material. The compatibility entry under templates is not a second maintained context system.

Installation and compatibility

Method	Use when
npx skills add ...	Your agent is supported by the skills CLI and you want all or selected skills
Clone or copy	You need templates, documentation, or direct control over the repository layout
Git submodule	You want to track this repository inside another project
Paste or reference Markdown	The tool accepts text context but does not natively discover Agent Skills

Agent Skills-aware tools can discover installed SKILL.md files and activate them from metadata. Other AI tools may still use the Markdown instructions manually, but automatic discovery, routing, tool access, and path behavior depend on the host.

Platform paths, native-support notes, copy instructions, and usage examples are maintained in docs/usage.md. The file format follows the Agent Skills specification.

Evidence and limitations

SkillsBench is one independent benchmark, not a guarantee for this repository. Its 2026 v4 evaluation covers 87 tasks across 8 domains and 18 model-harness configurations. Curated Skills increased average pass rate from 33.9% to 50.5% (+16.6 percentage points); focused Skills with at most three modules outperformed larger bundles in that evaluation.

This supports focused, task-relevant installation and review—not the claim that every skill or agent output is automatically production-ready. See skill authoring for how this repository applies those lessons.

Representative use cases include product-site SEO, technical audits, launch planning, content research, paid acquisition, analytics, and authoring your own skills. Detailed scenarios are in docs/usage.md.

Security

This repository ships Markdown instructions and templates, not executable skill code. The published audit checks for hidden instructions, prompt-injection patterns, executable URL schemes, and credential-exfiltration directives.

Individual marketing workflows may still require web research or external platforms. Permissions, credentials, data access, and side effects remain controlled by the host agent and user. Review Skills as trusted context before installation. See the security model and audit commands.

Build with the library

Building a vibe-coding product, an AI marketing agent, or an SEO learning experience? The skills can serve as maintained workflow references or integration inputs.

Contact the maintainer to discuss collaboration. To add or improve skills, read CONTRIBUTING.md and the Agent Skills writing guide.

If the library is useful, starring or sharing it helps other teams discover the project.

Documentation

Document	Purpose
Usage	Installation, platform behavior, use cases, and roadmap
Skills reference	Maintained skill inventory, ownership, and dependency maps
Skill authoring	Format, naming, writing, and quality rules
Security	Threat model, audit checklist, and verification commands
Templates	Context compatibility entry and task tracker
Changelog	Repository changes and migrations

License

MIT

Maintained by kostja · Human-facing marketing guides · Changelog