All skills
inhouseseo avatar

/write-content

@bdb4922

Use when writing a complete SEO article. Includes the full anti-AI-slop ruleset (banned vocabulary, banned phrases, banned structural patterns) and voice rules. The agent researches the SERP itself if needed — no keyword data exports required.

Use this Skill: https://skilld.dev/gh/inhouseseo/superseo-skills/write-content

This session only. Nothing lands on disk.

referencescontent-typeshow-to.md

≈1.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Technique 18: How-To / Tutorial Articles

What It Is

Informational content that guides users through accomplishing a specific task. Captures "how to [action]" and "[action] tutorial" searches.

When to Use

Informational intent -- user wants to accomplish a specific task. High PAA presence, strong featured snippet opportunity.

Structure Template

H1: "How to [Action] [Qualifier]"
    (e.g., "Hoe je zonnepanelen installeert in 2026")

H2: Quick answer / TL;DR
    40-60 words, optimized for featured snippet (paragraph or list format)

H2: What you need / Prerequisites
    Materials, tools, knowledge required

H2: Step-by-step instructions
    H3: Step 1: [Action verb] [specific outcome]
        Visual per step (screenshot, photo, diagram)
    H3: Step 2: ...
    H3: Step N: ...

H2: Common mistakes to avoid
    Practical, specific mistakes (not generic warnings)

H2: Tips from experience
    First-person insights that demonstrate E-E-A-T

H2: FAQ
    3-5 questions from People Also Ask data

H2: Next steps / Related guides
    Internal links to related content

Word Count

1,500-3,000 words (intent-dependent -- simple tasks shorter, complex tasks longer)

Schema Markup

  • Primary: HowTo (with step-by-step structured data)
  • Secondary: FAQ (for the FAQ section)

Featured Snippet Strategy

  • Format: Ordered list snippet (46.91% of "how" queries)
  • Target: Place numbered steps as an ordered list after the relevant H2
  • Quick answer: 40-60 word paragraph answer directly after H1 for paragraph snippet

CTA Placement

  • Mid-article (after step 3-4): related tool, product, or service
  • End of article: deeper guide, consultation, or conversion page

Internal Linking Strategy

  • Link to definition pages for technical jargon
  • Link to related how-tos (next steps)
  • Link to relevant product/service pages for tools mentioned
  • Link to pillar page for the topic cluster
  • Receive links from pillar page and FAQ hubs

Key Success Factors

  1. Front-load the answer: The quick answer section must appear before the detailed steps
  2. One action per step: Each step should describe exactly one thing the reader does
  3. Visual evidence: Screenshots, photos, or diagrams per step demonstrate Experience
  4. Specific measurements: "Drill a 6mm hole 3cm from the edge" not "drill a hole"
  5. Common mistakes are gold: These differentiate from generic guides and signal experience

Common Mistakes

  • Burying the answer below a long introduction
  • Missing the quick-answer paragraph (loses featured snippet opportunity)
  • Not including visuals per step (text-only how-tos underperform)
  • Generic steps that could apply to any topic (Horoscope Test failure)
  • Missing prerequisites section (frustrates readers mid-process)

Anti-AI Focus

Most effective anti-AI signal for tutorials: mention specific error messages, version numbers, and unexpected behaviors that only someone who actually did this would know.

How-to articles are one of the content types most vulnerable to AI-generated imitation because the step-by-step format is easy to replicate structurally. What AI cannot replicate is the texture of real experience. To make your tutorials unmistakably human-authored:

  • Include specific error messages and edge cases. When you describe a step, mention the exact error a user might encounter ("If you see 'Error 0x80070005: Access Denied', right-click and run as administrator"). Only someone who has actually performed the process knows these details.
  • Reference version numbers and dates. State the exact software version, firmware revision, or product model you used. AI tends to generalize; specificity signals authenticity.
  • Document unexpected behaviors. Describe what happened that the official documentation does not mention -- the step that took longer than expected, the setting that was in a different location than described, the workaround you had to improvise.
  • Show your environment. Include screenshots of your actual screen, photos of your workspace, or terminal output with timestamps. These artifacts are nearly impossible to fabricate convincingly.
  • Mention what did NOT work. Describing failed approaches before arriving at the working solution is a strong experience signal. AI-generated content almost never includes false starts or dead ends.

Example Topics by Niche

  • Energy comparison: "Hoe kies je de beste energieleverancier"
  • Local services: "Hoe vind je een betrouwbare loodgieter in Amsterdam"
  • SaaS: "How to set up automated email workflows"
  • E-commerce: "Hoe retourneer je een bestelling bij Bol.com"
  • Finance: "Hoe vraag je hypotheekrenteaftrek aan"

Source: SKILL.md on GitHub

No alerts16d3 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill provides a detailed multi-phase framework for researching and generating SEO-optimized articles while minimizing common AI writing patterns. It ingests and processes external data from search engine results and competitor web pages, creating a standard indirect prompt injection surface area. No malicious behaviors, obfuscation, or unauthorized access patterns were detected.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

Signed by skilld at bdb4922. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated last month

README badge

README badge for inhouseseo/superseo-skills/write-content