Details
Overview
SEO On-Page: Heading Structure Skill is an open-source Agent Skill from the kostja94/marketing-skills collection (MIT). It teaches AI coding agents focused marketing / SEO workflows so they can produce production-ready guidance instead of generic advice.
Guides heading (H1-H6) optimization for SEO and content structure.
Identify: 1. Page type: Homepage, article, product, etc. 2. Primary keyword: Target search query 3. Content outline: Main sections and subsections
Official skill id: heading-structure. Source path: skills/seo/on-page/heading.
Key Features
- H: 1 tag: One per page; clear headline; matches content; primary keyword near start
- H: eader tags (H1-H6): Logical hierarchy; keyword in headers; one idea per heading
- H: 1 recommendation (with keyword)
- H: 2-H6 outline for content
- H: ierarchy check
- R: eferences: Google headings
How to Use
- Use a Skill-compatible agent such as Claude Code, Cursor, or Codex.
- Install from the terminal (Node.js required):
npx skills add https://github.com/kostja94/marketing-skills --skill heading
Or paste the install prompt from this tool page into your agent and ask it to install for you. 3. Restart / reload the agent so the new Skill is loaded. 4. Invoke the Skill with its slash commands or by asking the agent to run the workflow described in Overview / Key Features. 5. Review outputs before publishing — treat model-generated copy, images, and data as drafts.
Pricing
| Plan | Billing | Price | Notes |
|---|---|---|---|
| Open source | — | Free | MIT license; install via npx skills add |
| Full pack | — | Free | Optional: install the entire marketing-skills repo |
No paid tiers. Check the GitHub repository for license and updates.
Best For
Marketers, indie hackers, ecommerce / SaaS founders, and SEO operators who want agents to execute a specific marketing task with structured best practices.
Trigger context from the skill author: When the user wants to optimize heading structure (H1-H6), fix heading hierarchy, or improve content structure. Also use when the user mentions "H1," "heading," "heading hierarchy," "content structure," "H2," "H3," "heading tags," "heading SEO," "multiple H1," or "heading structure." For SEO workflow, use seo-strategy.
FAQ
How do I install this skill?
npx skills add https://github.com/kostja94/marketing-skills --skill heading-structure
Or copy the skill folder into .cursor/skills/, .agents/skills/, or .claude/skills/.
Does this skill run code on my machine?
No. Skills in this collection are pure Markdown instructions for agents — no executable payloads.
Can I install only this skill instead of the full pack?
Yes. Prefer --skill heading-structure for a single task. Install 2–3 related skills per job rather than the entire library.
Where should I add project context?
Copy templates/project-context.md from the repo into .cursor/ or .claude/ and fill in product, audience, and brand details so outputs stay tailored.