Apply practical marketing knowledge to AI coding agents
When refining landing page copy or diagnosing SEO issues, this repository helps AI tools understand marketing context and apply appropriate frameworks. It is a collection of markdown files for AI agents performing marketing tasks, designed to work across various agent environments without dependency on specific products or frameworks. It is useful for marketers or founders with a technical background who want to integrate AI tools naturally into their marketing workflows.
v2.0 Update and Structural Changes
The recent update to version v2.0 changed 17 skill names and merged some features. For example, two skills that handled page and form conversion rates were combined into a single cro skill. If you are currently using an existing v1.x version, an old version folder may remain in your installation directory, so it is recommended to clean it up using the commands provided in the README before reinstalling. Additionally, while the location and name of the product marketing context file have changed, the system supports the previous path and filename as a fallback, ensuring that operations do not stop even without migration.
Skill Interconnection and Product Marketing Context
Each skill does not operate in isolation but references others based on shared context. All skills first check the product-marketing skill before starting a task to understand the product, target audience, and positioning. This ensures that individual tasks such as copywriting, conversion rate optimization, and A/B testing are performed under a consistent brand tone and strategy. The skills are categorized by area, including SEO, content, paid advertising, growth, and sales, and a dependency map between related skills helps identify how one task connects to another.
Installation Methods and Agent Compatibility
It can be used with various agents that support the Agent Skills specification, such as Claude Code, OpenAI Codex, Cursor, and Windsurf. The most recommended method is to run the npx skills add coreyhaines31/marketingskills command, which automatically detects installed agents and places files in the appropriate location. For Claude Code, files are installed in the .claude/skills/ directory, while for generic agents, they are placed in .agents/skills/. If the command is executed within an agent session, it operates non-interactively and may only install to the generic directory, so it is safer to explicitly specify the agent using the -a claude-code option. Various installation options are also provided, including customization via Git submodules or forks.
Scope of Application and Partnership Structure
This repository is released under the MIT license and can be used freely, with maintenance supported through partnerships. Partnerships provide integrations for verified tools but maintain neutrality so as not to influence recommendations in core skills. The partner list includes marketing-related tools such as conversion tracking and AI website builders, with integration guides provided for each. Contributions are welcome, and pull requests and issues for skill improvements or new skill additions are accepted. If marketers want to learn how to effectively use AI in marketing, they can refer to the 'Coding for Marketers' guide or related educational materials provided with this repository.
