{"id":48725581,"url":"https://github.com/rampify-dev/rampify-seo-audit-skill","last_synced_at":"2026-04-11T22:04:07.954Z","repository":{"id":327701293,"uuid":"1110415061","full_name":"rampify-dev/rampify-seo-audit-skill","owner":"rampify-dev","description":"Free Claude Skill for comprehensive single-page SEO audits","archived":false,"fork":false,"pushed_at":"2025-12-05T07:13:35.000Z","size":51,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-08T14:39:15.940Z","etag":null,"topics":["ai-tools","claude","claude-code","developer-tools","mcp","seo","seo-audit","seo-tools"],"latest_commit_sha":null,"homepage":"https://rampify.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rampify-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-05T06:48:35.000Z","updated_at":"2025-12-05T07:13:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rampify-dev/rampify-seo-audit-skill","commit_stats":null,"previous_names":["rampify-dev/rampify-seo-audit-skill"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/rampify-dev/rampify-seo-audit-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rampify-dev%2Frampify-seo-audit-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rampify-dev%2Frampify-seo-audit-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rampify-dev%2Frampify-seo-audit-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rampify-dev%2Frampify-seo-audit-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rampify-dev","download_url":"https://codeload.github.com/rampify-dev/rampify-seo-audit-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rampify-dev%2Frampify-seo-audit-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31696762,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-11T21:17:31.016Z","status":"ssl_error","status_checked_at":"2026-04-11T21:17:24.556Z","response_time":54,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","claude","claude-code","developer-tools","mcp","seo","seo-audit","seo-tools"],"created_at":"2026-04-11T22:04:06.864Z","updated_at":"2026-04-11T22:04:07.945Z","avatar_url":"https://github.com/rampify-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rampify SEO Audit Skill\n\nA free, open-source Claude Skill for comprehensive single-page SEO audits. Built by the [Rampify](https://www.rampify.dev) team as a gift to the Claude Code/Cursor community.\n\n## What It Does\n\nPerforms instant SEO audits on individual pages, checking:\n\n- **Meta Tags** - Title, description, Open Graph, Twitter Cards\n- **Schema.org** - Structured data validation (JSON-LD, Microdata, RDFa)\n- **Heading Structure** - H1-H6 hierarchy and optimization\n- **Images** - Alt text, file sizes, lazy loading\n- **Links** - Internal/external link analysis\n- **Content Quality** - Word count, readability, keyword density\n- **Mobile** - Responsiveness indicators\n- **Performance** - Page speed signals\n\n## Installation\n\n### Prerequisites\n\n- [Claude Code](https://claude.ai/code) or [Cursor](https://cursor.sh) installed\n- Node.js 18+ (for local development only)\n\n### Quick Install\n\n```bash\n# Clone the repository\ngit clone https://github.com/rampify-dev/rampify-seo-audit-skill.git\ncd rampify-seo-audit-skill\n\n# Install dependencies (if using TypeScript version)\nnpm install\n```\n\n### Add to Claude Code\n\n1. Open Claude Code settings\n2. Navigate to Skills section\n3. Click \"Add Skill from Directory\"\n4. Select the `rampify-seo-audit-skill` folder\n\n### Add to Cursor\n\n1. Open Cursor settings\n2. Go to Skills configuration\n3. Click \"Import Skill\"\n4. Choose the cloned directory\n\n## Usage\n\nOnce installed, the Skill activates automatically when you work with web pages.\n\n### Basic Audit\n\nOpen any HTML, JSX, MDX, or similar file and ask:\n\n```\n\"Audit this page for SEO\"\n\"Check SEO issues on this page\"\n\"What SEO problems does this have?\"\n```\n\n### Specific Checks\n\nRequest targeted analysis:\n\n```\n\"Check the meta tags\"\n\"Validate the schema markup\"\n\"Analyze heading structure\"\n\"Check image optimization\"\n```\n\n### Example Output\n\n```\nSEO Audit Report: /blog/how-to-use-claude-for-seo\n\nCritical Issues (2):\n  ❌ Missing meta description\n  ❌ Invalid Article schema: missing \"datePublished\" property\n\nWarnings (4):\n  ⚠️  Title too short (42 chars, recommend 50-60)\n  ⚠️  No alt text on 3 images\n  ⚠️  H2 heading appears before H1\n  ⚠️  No canonical tag specified\n\nInfo (2):\n  ℹ️  Word count: 847 (good for blog post)\n  ℹ️  Internal links: 5, External links: 2\n\nRecommendations:\n  1. Add meta description (150-160 chars, include target keyword)\n  2. Fix Article schema:\n     Add: \"datePublished\": \"2025-12-05T10:30:00Z\"\n  3. Extend title to 50-60 chars: \"How to Use Claude for SEO Audits | Developer Guide\"\n  4. Add alt text to images: /images/claude-seo-1.png, /images/claude-seo-2.png\n  5. Move H1 above first H2\n  6. Add canonical: \u003clink rel=\"canonical\" href=\"https://yoursite.com/blog/how-to-use-claude-for-seo\"\u003e\n\nPriority Order:\n  1. Fix schema (impacts rich results)\n  2. Add meta description (impacts CTR)\n  3. Fix title length (impacts CTR)\n  4. Add canonical tag (prevents duplicate content)\n  5. Fix heading structure (minor UX/SEO impact)\n```\n\n## What This Skill Does NOT Do\n\nThis Skill is designed for **single-page audits**. It does not:\n\n- Track issues across multiple pages\n- Monitor for regressions over time\n- Integrate with Google Search Console\n- Prioritize by traffic impact\n- Remember previous audits\n- Run automatically on deployment\n- Alert when new issues appear\n\n**When you outgrow this Skill**, check out [UPGRADE.md](UPGRADE.md) for guidance on systematic SEO intelligence.\n\n## Customization\n\n### Adjust Severity Levels\n\nEdit `config/rules.json` to change what counts as critical vs warning:\n\n```jsonc\n{\n  // Severity levels: critical, warning, info\n  \"meta_description_missing\": \"critical\",  // Change to \"warning\" if desired\n  \"title_too_short\": \"warning\",\n  \"alt_text_missing\": \"info\"\n}\n```\n\n### Add Custom Checks\n\nCreate new rules in `src/checks/`:\n\n```typescript\n// src/checks/custom-check.ts\nexport function checkCustomRule(page: Page): Issue[] {\n  const issues: Issue[] = [];\n\n  // Your custom logic here\n\n  return issues;\n}\n```\n\n### Modify Output Format\n\nUpdate `src/formatter.ts` to change how results are displayed.\n\n## Examples\n\nSee `examples/` directory for sample pages and their audit results:\n\n- `examples/blog-post/` - Blog post with common issues\n- `examples/product-page/` - E-commerce product page\n- `examples/landing-page/` - Marketing landing page\n- `examples/documentation/` - Technical documentation\n\n## Contributing\n\nContributions welcome! This is a community resource.\n\n### Adding New Checks\n\n1. Fork the repository\n2. Create a new check in `src/checks/`\n3. Add tests in `src/checks/__tests__/`\n4. Update `README.md` with the new check\n5. Submit a pull request\n\n### Reporting Issues\n\nFound a bug or false positive? [Open an issue](https://github.com/rampify-dev/rampify-seo-audit-skill/issues)\n\n## Architecture\n\n```\nrampify-seo-audit-skill/\n├── src/\n│   ├── index.ts              # Main Skill entry point\n│   ├── checks/               # Individual SEO checks\n│   │   ├── meta-tags.ts\n│   │   ├── schema.ts\n│   │   ├── headings.ts\n│   │   ├── images.ts\n│   │   ├── links.ts\n│   │   └── content.ts\n│   ├── utils/\n│   │   ├── parser.ts         # HTML/JSX parsing\n│   │   ├── validator.ts      # Schema validation\n│   │   └── scorer.ts         # Issue severity scoring\n│   └── formatter.ts          # Output formatting\n├── config/\n│   └── rules.json            # Configurable rules\n├── examples/\n│   ├── blog-post/\n│   ├── product-page/\n│   └── landing-page/\n├── __tests__/\n│   └── checks/\n├── skill.json                # Claude Skill definition\n├── package.json\n├── tsconfig.json\n├── README.md\n├── UPGRADE.md\n├── CONTRIBUTING.md\n└── LICENSE\n```\n\n## When to Upgrade\n\n**This Skill is perfect for:**\n- Learning SEO best practices\n- Auditing pages during development\n- Spot-checking specific pages\n- Pre-publish validation\n\n**You'll need more when:**\n- Managing 20+ pages\n- Deploying changes frequently\n- Working with multiple sites\n- Needing historical tracking\n- Wanting automated monitoring\n\n**See [UPGRADE.md](UPGRADE.md) for your options.**\n\n## License\n\nMIT License - Use it however you want!\n\n## Credits\n\nBuilt with ❤️ by the [Rampify](https://www.rampify.dev) team.\n\n**Want systematic SEO intelligence?**\n- [Rampify MCP Server](https://www.rampify.dev/docs/mcp-server) - Site-wide audits in your editor\n- [Rampify Platform](https://www.rampify.dev) - Full monitoring with dashboard\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/rampify-dev/rampify-seo-audit-skill/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/rampify-dev/rampify-seo-audit-skill/discussions)\n- **Documentation**: [Rampify Docs](https://www.rampify.dev/docs)\n- **Community**: [Join our Discord](https://discord.gg/rampify)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frampify-dev%2Frampify-seo-audit-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frampify-dev%2Frampify-seo-audit-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frampify-dev%2Frampify-seo-audit-skill/lists"}