Details
Overview
Components: HowTo Section 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 HowTo as an in-page section: a block of ordered steps (and optional HowTo JSON-LD) embedded inside article, documentation, tool, or landing pages. Not a standalone page type—parent page structure and templates come from article-page-generator, docs-page-generator, tools-page-generator, landing-page-generator, etc. Distinct from FAQ (Q&A → FAQPage) and from full article body drafting alone (article-content). schema-markup remains the source for exhaustive Schema.org property rules and type-wide tables; this skill owns section-level placement, copy, HTML, and HowTo-vs-FAQ decisions.
Do not mark FAQ content as HowTo or vice versa; schema must match visible content.
Official skill id: howto-section-generator. Source path: skills/components/content/howto-section.
Key Features
- A: void a bare “Steps” or “Instructions” as the only H2 text when you can name the outcome—screen reader and scan users lose context.
- C: ount in the title: If you use “3 steps” / “In 4 steps” in the H2, tabs, or subheads, the on-page list and HowTo schema must show the same number of steps (no extra steps only in JSON-LD).
- V: olatile UIs: If step count may change with releases, prefer non-count titles (“How to …”) and put “three main steps” in body copy if needed.
- L: anguage: Mirror the query (e.g. “How to …” for EN informational intent); localized pages: same intent in
inLanguageas the visible heading. - S: teps: Use semantic ordered list
<ol>with<li>per step; bold the step title inside the<li>if needed. - S: ub-steps: Nested
<ol>or H3 under a step when the step is long.
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 howto-section
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 create, optimize, or audit a HowTo section block—an in-page block of ordered steps with optional Schema.org HowTo JSON-LD. Also use when the user mentions "HowTo section," "how-to section," "steps section," "quick start," "walkthrough," "tutorial block," "3 steps," "N steps," "simple steps,"…
FAQ
How do I install this skill?
npx skills add https://github.com/kostja94/marketing-skills --skill howto-section-generator
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 howto-section-generator 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.