Agent skill

Improve Content

by inhouseseo in inhouseseo/superseo-skills

A skill your agent uses when rewriting or refreshing an existing page that's underperforming.

Apache-2.0Auto-check passedMarketing & SEO

Install Improve Content

skills CLI
$ npx skills add inhouseseo/superseo-skills --skill improve-content -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install inhouseseo/superseo-skills improve-content --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/inhouseseo/superseo-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/improve-content .claude/skills/improve-content && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
improve-content
GitHub stars
352
Token cost
~1.5k tokens
SKILL.md length
737 words
Files
26 (incl. references)
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when rewriting or refreshing an existing page that's underperforming.

  • Works in 4 steps: Read the Current Content → Research the SERP → Update Interview → …
  • Refreshing an existing page thats underperforming
  • SKILL.md covers Input, Role, Step 1: Read the Current Content and Step 2: Research the SERP, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Improve Content is an agent skill from inhouseseo/superseo-skills. 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.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 27 other files, including reference files (for example `references/anti-slop-ruleset.md`, `references/content-freshness.md` and `references/content-types-overview.md`).

It sits in Marketing & SEO. The repository describes itself as: 11 Claude skills for SEO: page audits, linkbuilding, article writing, E-E-A-T audits, semantic gap analysis, link building. Methodology from Koray Tuğberk, Kyle Roof, and Lily…. The licence is Apache-2.0.

When your agent uses it

  • Refreshing an existing page thats underperforming

Example prompts

  • “/improve-content”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Read the Current Content
  2. Research the SERP
  3. Update Interview
  4. Rewrite

What it can do on your machine

Read from SKILL.md and the folder at commit 9cf22cc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Improve Content loads about 1.5k tokens when it runs, and up to ~43k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 737 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~43k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from inhouseseo/superseo-skills at commit 9cf22cc, republished under its Apache-2.0 licence (© inhouseseo). 737 words, ~1,495 tokens.

Download SKILL.mdSave it as .claude/skills/improve-content/SKILL.md (or your agent's skills folder). This skill also uses 25 other files; get the full folder from GitHub.
name
improve-content
description
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.

Improve Content

Rewrites an existing page so it outranks competitors — better structure, deeper expertise, and a voice that actually sounds human. Uses the same anti-slop ruleset as write-content.

Input

URL of the page to improve. If the fetch fails, ask the user to paste the page content directly.

Role

You are a senior content writer and SEO specialist with 10+ years improving underperforming pages.

Step 1: Read the Current Content

Fetch the URL and read the full rendered page. Note title, meta, H1/H2s, word count, internal links, schema. Identify the apparent primary keyword from the content.

Step 2: Research the SERP

Google the primary keyword. Read the top 5 results. Note:

  • What formats are ranking
  • Content gaps where the current page falls short
  • Angles competitors take that this page doesn't
  • Any featured snippet / PAA opportunities

This is a lightweight check, not a full page audit. Just enough to know what's missing.

Step 3: Update Interview

Ask 2-3 quick questions adapted for content updates, one at a time:

  • "What's changed since you published this? New data, new experience, market shifts?"
  • "What results did this content get? Traffic, leads, feedback?"
  • "Knowing what you know now, what would you add or cut?"

If the user can't answer — autonomous run, or they skip — go straight to the rewrite and note where fresh first-party input would strengthen it.

Step 4: Rewrite

Produce the complete rewritten article in clean markdown. Apply ALL writing rules:

Voice

Practitioner to a peer. Take positions. Use "you" and "I/we." Specific numbers, names, dates — but only real ones, taken from the existing page, the SERP research, or the user's answers. Never invent a number, name, or citation; cut the claim instead. Contractions. Show thinking changing. Shift registers — after technical explanation, drop into casual aside. Uniform register = AI tell.

Rhythm

Vary sentence length dramatically (5 to 30+ words). Vary paragraph length. Fragments. Parenthetical asides. Break the topic-sentence-support pattern. Cover sections asymmetrically. No section summaries.

Show, don't state

Brief scenarios instead of flat claims. "You click a search result. Three seconds pass. Still loading. You hit back." narrates; "page speed affects UX" states.

Anti-slop

NEVER use: delve, landscape (metaphorical), testament, leverage, utilize, robust, seamless, furthermore, moreover, additionally, pivotal, multifaceted, harness, embark, navigate (metaphorical), showcase, streamline, paramount, culminate, spearhead, commence, endeavor, vibrant, innovative, comprehensive (as adjective).

NEVER use: "It's worth noting", "In today's [anything]", "Let's dive in", "In conclusion", "plays a crucial/vital role", "It goes without saying".

Avoid: rule-of-three groupings, synonym cycling, em-dash chains (max 1-2 per 1,000 words), binary contrasts, participial tack-ons.

SEO

Primary keyword in H1, first 100 words, 2-3 H2s. ~2% density, naturally distributed. 40-60 word direct answer after the most important H2 (featured snippet). Weave PAA questions as H2/H3 headings. 3-5 internal links per 1,000 words. Front-load value.

Show full SKILL.md (279 more words)Show less
Content type

Detect from the existing page + SERP. Load references/content-types-overview.md for the decision table, then load the specific template from references/content-types/<type>.md for the full rewrite structure. 19 templates bundled: how-to, definition, comparison, listicle, pillar-page, faq-page, landing-page, service-page, case-study, statistics-page, news-article, glossary-page, alternatives-page, buying-guide, product-page, category-page, integration-page, location-page, programmatic-page.

  • How-to: 40-60 word quick answer, then numbered steps with "what goes wrong"
  • Comparison: verdict first, then detail
  • Definition: "[Term] is..." in the first sentence
  • Case study: result number first, then the story
Final checks
  1. "So what?" test per section — could anyone have written this for anyone? If yes, inject specific knowledge.
  2. Self-check: scan for blacklisted words, topic-sentence patterns, section summaries. Fix before delivering.
Output

Clean markdown. Title + rewritten article content. Nothing else.

Language

Write in the same language as the existing page content.

Bundled references

Load from references/ only when needed — don't preload the whole folder.

Content type templates (references/content-types/) — load one in Step 4:

  • Common: how-to.md, definition.md, comparison.md, listicle.md, pillar-page.md, faq-page.md, landing-page.md, service-page.md, case-study.md
  • Content and news: statistics-page.md, news-article.md, glossary-page.md
  • Commercial: alternatives-page.md, buying-guide.md, product-page.md, category-page.md, integration-page.md, location-page.md, programmatic-page.md
  • references/content-types-overview.md for the decision table across all 23 content types (load this FIRST if unsure which type to pick)

Rewriting technique modules (references/) — load when a rule calls for more depth:

  • anti-slop-ruleset.md — full tiered banned vocab + structural tells (load when the inline anti-slop block isn't catching everything in the current page)
  • voice-injection-playbook.md — how to inject voice into a flat existing page without rewriting from scratch
  • content-freshness.md — decay signals and what to refresh vs. leave alone (the core of Step 3's update interview)
  • writing-pipeline.md — the research → rewrite → edit loop adapted for updates
  • quality-scoring.md — scoring rubric to run before delivering the rewrite

© inhouseseo, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 25 other files (references) in skills/improve-content of inhouseseo/superseo-skills.

  • SKILL.md
  • references/anti-slop-ruleset.md
  • references/content-freshness.md
  • references/content-types-overview.md
  • references/content-types/alternatives-page.md
  • references/content-types/buying-guide.md
  • references/content-types/case-study.md
  • references/content-types/category-page.md
  • references/content-types/comparison.md
  • references/content-types/definition.md
  • references/content-types/faq-page.md
  • references/content-types/glossary-page.md
  • references/content-types/how-to.md
  • references/content-types/integration-page.md
  • references/content-types/landing-page.md
  • references/content-types/listicle.md
  • references/content-types/location-page.md
  • references/content-types/news-article.md
  • references/content-types/pillar-page.md
  • … and 7 more

Open the folder on GitHubat commit 9cf22cc

Compare with similar skills

Improve Content next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Improve Content compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Improve Content this skillinhouseseo/superseo-skills352—~1.5kAutomated safety check: PassApache-2.0
Ad CreativeLeoYeAI/openclaw-marketing-skills1k8 repos~3.4kAutomated safety check: PassCustom licence
SEO Keyword ClusteringAgriciDaniel/claude-seo19k2 repos~3.3kAutomated safety check: PassMIT
SEO Content Brief GeneratorAgriciDaniel/claude-seo19k2 repos~2.6kAutomated safety check: PassMIT
Amazon Listing Optimizationnexscope-ai/Amazon-Skills7411 repos~4.3kAutomated safety check: PassMIT
Canghe Post To Xfreestylefly/canghe-skills4614 repos~1.7kAutomated safety check: WarnNone

Similar skills

  • Ad Creative

    LeoYeAI/openclaw-marketing-skills

    When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform.

    1k GitHub starsUsed in 8 repos~3.4k tokens
    Marketing & SEOAuto-check passed
  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    19k GitHub starsUsed in 2 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    19k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • Amazon Listing Optimization

    nexscope-ai/Amazon-Skills

    Amazon listing builder and optimizer for sellers. An agent skill from nexscope-ai/Amazon-Skills.

    741 GitHub starsUsed in 1 repo~4.3k tokens
    Marketing & SEOAuto-check passed
  • Canghe Post To X

    freestylefly/canghe-skills

    Posts content and articles to X (Twitter). An agent skill from freestylefly/canghe-skills.

    461 GitHub starsUsed in 4 repos~1.7k tokens
    Marketing & SEOAuto-check: warnings
  • GEO Content E-E-A-T Scorer

    zubair-trabzada/geo-seo-claude

    Scores a page's content against Google's E-E-A-T framework and AI-citability structure, then writes a scored gap-analysis report.

    11k GitHub starsUsed in 2 repos~4k tokens
    Marketing & SEOAuto-check: notes

More from inhouseseo/superseo-skills

All 11 skills in this repo
  • Content Brief

    inhouseseo/superseo-skills

    A skill your agent uses when planning a new article. An agent skill from inhouseseo/superseo-skills.

    352 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Eeat Audit

    inhouseseo/superseo-skills

    A skill your agent uses when auditing a page for E-E-A-T signals.

    352 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Expert Interview

    inhouseseo/superseo-skills

    A skill your agent uses when extracting first-party expertise from a subject-matter expert before writing content.

    352 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Featured Snippet Optimizer

    inhouseseo/superseo-skills

    A skill your agent uses when you want to win a featured snippet for a keyword you already rank for.

    352 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check passed
  • Keyword Deep Dive

    inhouseseo/superseo-skills

    A skill your agent uses when planning to rank for a specific keyword.

    352 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Linkbuilding

    inhouseseo/superseo-skills

    A skill your agent uses when planning link acquisition. An agent skill from inhouseseo/superseo-skills.

    352 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Improve Content

What does Improve Content do?

A skill your agent uses when rewriting or refreshing an existing page that's underperforming. Improve Content is an agent skill from inhouseseo/superseo-skills. Use when rewriting or refreshing an existing page that's underperforming.

When should I use Improve Content?

Improve Content fits situations like: refreshing an existing page thats underperforming.

How do I install Improve Content in Claude Code?

Run `npx skills add inhouseseo/superseo-skills --skill improve-content -a claude-code`. Or copy the skill folder (skills/improve-content in inhouseseo/superseo-skills) into .claude/skills/improve-content in your project. Claude Code loads it when a task matches its description.

How do I install Improve Content in Codex?

Run `npx skills add inhouseseo/superseo-skills --skill improve-content -a codex`. Or copy the skill folder (skills/improve-content in inhouseseo/superseo-skills) into .agents/skills/improve-content in your project. Codex loads it when a task matches its description.

Can I use Improve Content in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add inhouseseo/superseo-skills --skill improve-content -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/improve-content, .gemini/skills/improve-content, .github/skills/improve-content and .opencode/skills/improve-content in your project.

What does Improve Content need to run?

SKILL.md names no scripts, command-line tools or credentials: Improve Content is instructions for the agent only.

Does Improve Content access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Improve Content safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Improve Content use?

Improve Content is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Improve Content use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 41k tokens, read only when the agent opens those files.

What are the alternatives to Improve Content?

Skills that share tags, products or a category with Improve Content: Ad Creative (LeoYeAI/openclaw-marketing-skills, 1k stars), SEO Keyword Clustering (AgriciDaniel/claude-seo, 19k stars), SEO Content Brief Generator (AgriciDaniel/claude-seo, 19k stars) and Amazon Listing Optimization (nexscope-ai/Amazon-Skills, 741 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Improve Content?

inhouseseo (a GitHub user) maintains it in inhouseseo/superseo-skills, which has 352 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 3, 2026.

Source: inhouseseo/superseo-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.