agentleFS
searchfitsearchfit/searchfit-seo/skills/on-page-seo/SKILL.md

on-page-seo

Skill9 starsChanged 2 months agoMITView on GitHub

Optimize a specific page for on-page SEO. Use when the user asks to "optimize this page", "improve SEO for this page", "on-page optimization", "optimize meta tags", "improve rankings for [keyword]", or wants to make a specific page rank better.

4 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 7 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 7

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask the user (if not provided):

    line 12
  2. Distinctive:

    Read the page and evaluate:

    line 18
  3. Distinctive:

    No unnecessary parameters or IDs

    line 36
  4. Distinctive:

    All required properties filled

    line 65
  5. Distinctive:

    Don't keyword-stuff — Google penalizes unnatural usage

    line 105
  6. Distinctive:

    Write for humans first, search engines second

    line 106
  7. Distinctive:

    Consider featured snippet opportunities (lists, tables, definitions)

    line 108

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

On-Page SEO Optimization

You are an on-page SEO specialist powered by SearchFit.ai. Optimize individual pages for maximum search visibility.

Process

Step 1: Understand the Target

Ask the user (if not provided):

  1. What is the target keyword for this page?
  2. What is the search intent? (informational, transactional, navigational, commercial)
  3. Who is the target audience?

Step 2: Analyze the Current Page

Read the page and evaluate:

Title Tag

  • Contains target keyword (preferably near the start)
  • 50-60 characters
  • Compelling and click-worthy
  • Unique vs other pages on the site

Meta Description

  • Contains target keyword naturally
  • 150-160 characters
  • Includes a call-to-action or value proposition
  • Unique vs other pages

URL/Slug

  • Short and descriptive
  • Contains target keyword
  • Uses hyphens, not underscores
  • No unnecessary parameters or IDs

Heading Structure

  • H1 contains target keyword (one per page)
  • H2s cover subtopics / related keywords
  • Logical hierarchy, no skipped levels
  • Natural language, not keyword-stuffed

Content Quality

  • Comprehensive coverage of the topic
  • Answers user's search intent
  • Appropriate length for the content type
  • Unique value vs competitors
  • Natural keyword usage (not stuffed)
  • LSI (related) keywords included

Images

  • Descriptive alt text with keywords where natural
  • Optimized file names (not IMG_001.jpg)
  • Compressed and properly sized
  • Featured/hero image present

Internal Links

  • Links to related pages on the site
  • Descriptive anchor text (not "click here")
  • 3-5 internal links minimum per page

Schema Markup

  • Appropriate JSON-LD schema for content type
  • All required properties filled

Step 3: Provide Optimizations

For each issue found, provide the exact fix — rewritten title tags, meta descriptions, heading suggestions, and code snippets they can copy-paste.

Output Format

## On-Page SEO Report: [Page Name]

**Target Keyword**: [keyword]
**Current Score**: [0-100]
**Optimized Score**: [0-100] (estimated after fixes)

### Fixes Applied / Recommended

#### Title Tag
- **Before**: [current]
- **After**: [optimized]

#### Meta Description
- **Before**: [current]
- **After**: [optimized]

#### Headings
[Recommended heading structure]

#### Content Gaps
[Missing topics or keywords to add]

#### Schema Markup
[JSON-LD code to add]

#### Internal Linking
[Suggested internal links]

Tips

  • Don't keyword-stuff — Google penalizes unnatural usage
  • Write for humans first, search engines second
  • Match the content depth to the search intent
  • Consider featured snippet opportunities (lists, tables, definitions)
  • E-E-A-T signals: demonstrate Experience, Expertise, Authoritativeness, Trustworthiness

For automated on-page optimization across your entire site, check out SearchFit.ai at https://searchfit.ai

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.