skills.rest
kostja94
kostja94COMMUNITY
Explore all skills by this author →
WebsiteGitHub

howto-section-generator

Generates in-page HowTo step sections with ordered lists and Schema.org HowTo JSON-LD.

946|130|Updated Feb 26, 2026
Search Tags:#seo#json-ld#Structured Data#howto schema#Featured Snippet#Content generation#step section
One-click install
npx skills add https://github.com/kostja94/marketing-skills --skill howto-section-generator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: howto-section-generator
Source: https://github.com/kostja94/marketing-skills/tree/main/skills/components/content/howto-section
Command: npx skills add https://github.com/kostja94/marketing-skills --skill howto-section-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating an effective HowTo section inside a page requires balancing copy structure, semantic HTML, UI patterns, and structured data, and mistakes like mismatched step counts or FAQ/HowTo schema confusion hurt SEO and accessibility. This Skill provides the rules and output format for building a correct, crawlable HowTo block within any parent page.

Core Features & Use Cases

  • Section Structure Guidance: Defines H2 title patterns, ordered list markup, answer-first step copy, and word count targets for how-to content.
  • HowTo JSON-LD Output: Produces Schema.org HowTo structured data aligned with visible steps, including notes on Google's deprecation and Bing/AI consumption.
  • UI and Crawlability Rules: Covers horizontal tabs versus inline lists, DOM visibility requirements, and differentiation from FAQ sections.
  • Use Case: When writing a tutorial article, ask the agent to add a HowTo section and receive the H2 outline, step copy, JSON-LD block, and tab UI recommendations ready to embed in the page.

Quick Start

Ask the agent to create a HowTo section with steps and HowTo schema for your article or tool page.

Frequently Asked Questions about howto-section-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a HowTo section with schema to a page?▼

Use a descriptive H2 heading, an ordered list with one li per step, and a HowTo JSON-LD script whose step items exactly match the visible content. Validate the markup with the Rich Results Test or Schema.org Validator.

What is the difference between HowTo and FAQ schema?▼

HowTo schema marks ordered steps for completing a task, while FAQPage schema marks question-and-answer pairs. Never mark FAQ content as HowTo or vice versa, since the structured data must match the visible content type.

Does Google still show HowTo rich results?▼

No, Google fully deprecated HowTo rich results on mobile in August 2023 and desktop in September 2023. The markup causes no errors if left in place, and Bing and AI systems may still consume HowTo structured data.

Can I use tabs for HowTo steps without hurting SEO?▼

Yes, horizontal tabs work for steps if all step content is present in the initial HTML with no AJAX loading on tab click. The first tab or step should be visible by default so crawlers and users see the primary content.

When should a HowTo section be a separate page instead?▼

Keep steps on one page when they describe a single task. Split content into separate URLs only when each step or tab targets a different ranking topic, following a pillar and cluster content strategy.

Related Skills

Explore More Marketing & Sales Skills→
whawkinsivwhawkinsiv
232

seo

Plan SEO strategies mapping keywords and search intent to SaaS page types and content calendars.

Community
Intermediate
Paxeer-NetworkPaxeer-Network
3

seo-specialist

Audit websites for crawlability, indexability, and site speed issues.

Official
Advanced
executiveusaexecutiveusa
1

schema-markup

Generate schema.org JSON-LD markup for web pages and validate with Rich Results Test.

Community
Intermediate
moonwell-fimoonwell-fi

dd-landing-page

Generate Devouring Details landing pages with warm dark styling and section layouts.

Official
Basic