All skills
inhouseseo avatar

/improve-content

@bdb4922

Use when rewriting or refreshing an existing page that's underperforming. The agent fetches the URL, analyzes the current content, researches the SERP, and rewrites using the full anti-AI-slop ruleset — no data exports needed.

Use this Skill: https://skilld.dev/gh/inhouseseo/superseo-skills/improve-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

1 warning16d3 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill provides a comprehensive framework for SEO content optimization and rewriting. The analysis identified a low-risk indirect prompt injection surface because the agent fetches and processes content from external URLs without explicit security boundaries. No other security concerns such as obfuscation, malicious code, or data exfiltration were found.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: MEDIUM · 1 issue

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/improve-content