Agent skill · writing content · kostja94
howto-section-generator
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," "tutorial steps," "step-by-step block," "HowTo schema," "HowTo JSON-LD," "instruction steps," "numbered steps SEO," "horizontal tabs for steps," or "procedure section." This skill is for a section inside a page, not a full page template—use article-page-generator, docs-page-generator, or tools-page-generator for page-level layout. For FAQ Q&A blocks, use faq-page-generator. For structured data details beyond HowTo, use schema-markup. For article body copy only, use article-content.
Why this skill is useful
Provides structured guidance for creating HowTo sections with specific SEO and schema considerations that the AI wouldn't reliably generate on its own.
What it needs
About 7k tokens when loaded. Last updated 2026-06-09. 860 stars on the source repository.
What this skill does
Components: HowTo Section 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. When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output. HowTo Section vs FAQ Section Dimension HowTo section FAQ section ----------- --------------- ------------- Intent User follows ordered steps to complete a task User reads Q&A pairs for doubts Structure Steps (1→2→3), optional tools/time/supplies Question → answer per item Schema HowTo (Schema.org) FAQPage UI Often horizontal tabs for steps; or numbered list in flow Often vertical accordion Skill howto-section-generator (this) faq-page-generator Do not mark FAQ content as HowTo or vice versa; schema must match visible content. Placement Within the Parent Page This section is always part of a larger page. Typical positions: Location When ---------- ------ After intro (and optional TL;DR / Key Takeaways) Article: context first, then solution = steps As the main middle of the page Tutorial-heavy article where the HowTo block carries most of the value After product/tool context Tool or LP: short context → How to use steps → FAQ/CTA Narrative: Align with PAS for how-to articles—Problem in intro; Agitation in brief context; Solution = the HowTo section. Answer-first still applies per step (see below). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills kostja94/howto-section