Rampify SEO Audit Skill

A free, open-source Claude Skill for comprehensive single-page SEO audits. Built by the Rampify team as a gift to the Claude Code/Cursor community.

What It Does

Performs instant SEO audits on individual pages, checking:

• Meta Tags - Title, description, Open Graph, Twitter Cards
• Schema.org - Structured data validation (JSON-LD, Microdata, RDFa)
• Heading Structure - H1-H6 hierarchy and optimization
• Images - Alt text, file sizes, lazy loading
• Links - Internal/external link analysis
• Content Quality - Word count, readability, keyword density
• Mobile - Responsiveness indicators
• Performance - Page speed signals

Installation

Prerequisites

• Claude Code or Cursor installed
• Node.js 18+ (for local development only)

Quick Install

# Clone the repository
git clone https://github.com/rampify-dev/rampify-seo-audit-skill.git
cd rampify-seo-audit-skill

# Install dependencies (if using TypeScript version)
npm install

Add to Claude Code

1. Open Claude Code settings
2. Navigate to Skills section
3. Click "Add Skill from Directory"
4. Select the rampify-seo-audit-skill folder

Add to Cursor

1. Open Cursor settings
2. Go to Skills configuration
3. Click "Import Skill"
4. Choose the cloned directory

Usage

Once installed, the Skill activates automatically when you work with web pages.

Basic Audit

Open any HTML, JSX, MDX, or similar file and ask:

"Audit this page for SEO"
"Check SEO issues on this page"
"What SEO problems does this have?"

Specific Checks

Request targeted analysis:

"Check the meta tags"
"Validate the schema markup"
"Analyze heading structure"
"Check image optimization"

Example Output

SEO Audit Report: /blog/how-to-use-claude-for-seo

Critical Issues (2):
  ❌ Missing meta description
  ❌ Invalid Article schema: missing "datePublished" property

Warnings (4):
  ⚠️  Title too short (42 chars, recommend 50-60)
  ⚠️  No alt text on 3 images
  ⚠️  H2 heading appears before H1
  ⚠️  No canonical tag specified

Info (2):
  ℹ️  Word count: 847 (good for blog post)
  ℹ️  Internal links: 5, External links: 2

Recommendations:
  1. Add meta description (150-160 chars, include target keyword)
  2. Fix Article schema:
     Add: "datePublished": "2025-12-05T10:30:00Z"
  3. Extend title to 50-60 chars: "How to Use Claude for SEO Audits | Developer Guide"
  4. Add alt text to images: /images/claude-seo-1.png, /images/claude-seo-2.png
  5. Move H1 above first H2
  6. Add canonical: <link rel="canonical" href="https://yoursite.com/blog/how-to-use-claude-for-seo">

Priority Order:
  1. Fix schema (impacts rich results)
  2. Add meta description (impacts CTR)
  3. Fix title length (impacts CTR)
  4. Add canonical tag (prevents duplicate content)
  5. Fix heading structure (minor UX/SEO impact)

What This Skill Does NOT Do

This Skill is designed for single-page audits. It does not:

• Track issues across multiple pages
• Monitor for regressions over time
• Integrate with Google Search Console
• Prioritize by traffic impact
• Remember previous audits
• Run automatically on deployment
• Alert when new issues appear

When you outgrow this Skill, check out UPGRADE.md for guidance on systematic SEO intelligence.

Customization

Adjust Severity Levels

Edit config/rules.json to change what counts as critical vs warning:

{
  // Severity levels: critical, warning, info
  "meta_description_missing": "critical",  // Change to "warning" if desired
  "title_too_short": "warning",
  "alt_text_missing": "info"
}

Add Custom Checks

Create new rules in src/checks/:

// src/checks/custom-check.ts
export function checkCustomRule(page: Page): Issue[] {
  const issues: Issue[] = [];

  // Your custom logic here

  return issues;
}

Modify Output Format

Update src/formatter.ts to change how results are displayed.

Examples

See examples/ directory for sample pages and their audit results:

• examples/blog-post/ - Blog post with common issues
• examples/product-page/ - E-commerce product page
• examples/landing-page/ - Marketing landing page
• examples/documentation/ - Technical documentation

Contributing

Contributions welcome! This is a community resource.

Adding New Checks

1. Fork the repository
2. Create a new check in src/checks/
3. Add tests in src/checks/__tests__/
4. Update README.md with the new check
5. Submit a pull request

Reporting Issues

Found a bug or false positive? Open an issue

Architecture

rampify-seo-audit-skill/
├── src/
│   ├── index.ts              # Main Skill entry point
│   ├── checks/               # Individual SEO checks
│   │   ├── meta-tags.ts
│   │   ├── schema.ts
│   │   ├── headings.ts
│   │   ├── images.ts
│   │   ├── links.ts
│   │   └── content.ts
│   ├── utils/
│   │   ├── parser.ts         # HTML/JSX parsing
│   │   ├── validator.ts      # Schema validation
│   │   └── scorer.ts         # Issue severity scoring
│   └── formatter.ts          # Output formatting
├── config/
│   └── rules.json            # Configurable rules
├── examples/
│   ├── blog-post/
│   ├── product-page/
│   └── landing-page/
├── __tests__/
│   └── checks/
├── skill.json                # Claude Skill definition
├── package.json
├── tsconfig.json
├── README.md
├── UPGRADE.md
├── CONTRIBUTING.md
└── LICENSE

When to Upgrade

This Skill is perfect for:

• Learning SEO best practices
• Auditing pages during development
• Spot-checking specific pages
• Pre-publish validation

You'll need more when:

• Managing 20+ pages
• Deploying changes frequently
• Working with multiple sites
• Needing historical tracking
• Wanting automated monitoring

See UPGRADE.md for your options.

License

MIT License - Use it however you want!

Credits

Built with ❤️ by the Rampify team.

Want systematic SEO intelligence?

• Rampify MCP Server - Site-wide audits in your editor
• Rampify Platform - Full monitoring with dashboard

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: Rampify Docs
• Community: Join our Discord