Skip to content
Back to search

serpwise

MarketplaceWorks with Claude CodeGitHub

SEO for AI coding agents, based on Google's own documentation. Agent Skill for Claude Code, Codex, Copilot and Antigravity.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sumitroajiprabowo--serpwise/badge.svg)](/listings/sumitroajiprabowo--serpwise)

HTML

<a href="/listings/sumitroajiprabowo--serpwise"><img src="/api/listings/sumitroajiprabowo--serpwise/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx serpwise                  # install for every supported agent on this machine
npx serpwise --project        # install into the current project only
npx serpwise@latest update    # npx may cache an old version, so ask for @latest
npx serpwise uninstall

The installer copies the skill to these places:

- `~/.claude/skills/serpwise` for Claude Code; - `~/.agents/skills/serpwise` for Codex, Copilot and similar agents; - `~/.gemini/config/skills/serpwise` for Antigravity.

It skips Claude Code or Antigravity if they aren't installed. Use `--agents claude,antigravity` to install for them anyway.

With `--project`, it writes `.claude/skills` and `.agents/skills` inside your project instead (Antigravity reads `.agents/skills` there), so you can commit them and share the skill with your team. Restart your agent after installing.

Other options:

| Method | Command | |---|---| | skills.sh | `npx skills add sumitroajiprabowo/serpwise` | | Claude Code plugin | `/plugin marketplace add sumitroajiprabowo/serpwise`, then `/plugin install serpwise@serpwise` | | No Node.js | `git clone https://github.com/sumitroajiprabowo/serpwise && ./serpwise/install.sh` | | Claude.ai | Zip `skills/serpwise` and upload it under Settings → Capabilities → Skills |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 26 lines
  1. {
  2. "name": "serpwise",
  3. "owner": {
  4. "name": "Sumitro Aji Prabowo",
  5. "url": "https://github.com/sumitroajiprabowo"
  6. },
  7. "metadata": {
  8. "description": "serpwise: SEO for AI coding agents.",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "serpwise",
  14. "source": "./",
  15. "description": "SEO for AI coding agents, based on Google's own documentation. Audit pages, fix indexing problems, write structured data, plan migrations and diagnose traffic drops.",
  16. "version": "1.0.0",
  17. "category": "productivity",
  18. "keywords": ["seo", "google-search", "structured-data", "technical-seo"],
  19. "author": {
  20. "name": "Sumitro Aji Prabowo",
  21. "url": "https://github.com/sumitroajiprabowo"
  22. },
  23. "homepage": "https://github.com/sumitroajiprabowo/serpwise"
  24. }
  25. ]
  26. }
README.md · README · 148 lines
  1. # serpwise
  2. [![npm](https://img.shields.io/npm/v/serpwise)](https://www.npmjs.com/package/serpwise)
  3. [![CI](https://github.com/sumitroajiprabowo/serpwise/actions/workflows/ci.yml/badge.svg)](https://github.com/sumitroajiprabowo/serpwise/actions/workflows/ci.yml)
  4. [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
  5. [![Agent Skills](https://img.shields.io/badge/Agent_Skills-compatible-8A2BE2)](https://agentskills.io)
  6. SEO for AI coding agents, based on Google's own documentation.
  7. serpwise is an [Agent Skill](https://agentskills.io) for Claude Code, Codex, GitHub Copilot, Antigravity and other agents that support the format. It gives your agent the guidance in [Google Search Central](https://developers.google.com/search/docs) and a set of commands for common SEO work. With it, your agent can:
  8. - audit a page;
  9. - fix indexing problems in your codebase;
  10. - write structured data;
  11. - plan a site migration;
  12. - work out why search traffic dropped.
  13. ```bash
  14. npx serpwise
  15. ```
  16. ![Before and after: without serpwise the agent finds the blockers but adds folklore such as fixed title lengths and cites almost no sources; with serpwise every finding has a severity and a Google rule](assets/before-after.svg)
  17. ## Why it exists
  18. Ask an AI agent about SEO and you get the internet's average opinion, including advice Google doesn't support, such as ideal title lengths, description lengths and word-count targets. serpwise points the agent at the source instead. Every finding is rated by severity (Critical, High, Medium, Low) and names the Google rule it comes from, so you know what to fix first and why.
  19. The agent also declines spam tactics such as buying links or mass-producing city pages, explains which Google policy they break, and suggests what to do instead.
  20. ## With and without serpwise
  21. We gave Claude Code the same broken landing page twice, once with serpwise and once with skills turned off, and asked for an SEO audit. Both runs found the obvious blockers, such as the `noindex` tag and the `<img>` that ends `<head>` early. A strong model catches those on its own. The difference was in the rest of the advice:
  22. | | Without serpwise | With serpwise |
  23. |---|---|---|
  24. | Title | "Aim for 50–60 characters" | Describe the page and include the brand. No character target, because Google sets none |
  25. | Meta description | "Write 140–160 characters" | Write something specific to the page, with concrete facts |
  26. | `<html lang>` | Listed as an SEO fix | Added for accessibility, with a note that Google detects language from the visible content |
  27. | Severity | Numbered list | Critical, High, Medium or Low for every finding |
  28. | Sources | A Google rule mentioned for 1 of 17 items | A Google rule for 18 of 19 findings |
  29. Both reports are in [`examples/`](examples/), unedited.
  30. ## How it differs from other SEO skills
  31. Every rule comes from Google Search Central. Advice Google doesn't support, such as meta keywords, fixed title lengths or an llms.txt file for AI Overviews, sits in a myths list, so the agent corrects it instead of repeating it.
  32. There are no accounts, API keys or paid data providers. The auditor needs nothing beyond the Python standard library, and the skill itself is plain Markdown that works in any agent that reads [Agent Skills](https://agentskills.io).
  33. It covers Google Search and nothing else. If you need keyword research, rank tracking or backlink data, use a tool built for that.
  34. ## Commands
  35. ```
  36. /serpwise list the commands
  37. /serpwise audit https://example.com/page audit a page
  38. /serpwise fix find and fix SEO issues in this repo
  39. /serpwise schema product.html write or validate JSON-LD
  40. /serpwise meta index.html write the title and meta description
  41. /serpwise robots https://example.com review robots.txt
  42. /serpwise sitemap https://example.com/sitemap.xml
  43. /serpwise hreflang set up a multilingual site
  44. /serpwise migrate plan a domain, HTTPS or URL change
  45. /serpwise drop diagnose a drop in Google traffic
  46. /serpwise content post.md review content quality
  47. ```
  48. In Codex, use `$serpwise` instead of `/serpwise`. You can also just describe the problem ("why isn't my site on Google?") and the agent will pick up the skill.
  49. ## Installation
  50. ```bash
  51. npx serpwise # install for every supported agent on this machine
  52. npx serpwise --project # install into the current project only
  53. npx serpwise@latest update # npx may cache an old version, so ask for @latest
  54. npx serpwise uninstall
  55. ```
  56. The installer copies the skill to these places:
  57. - `~/.claude/skills/serpwise` for Claude Code;
  58. - `~/.agents/skills/serpwise` for Codex, Copilot and similar agents;
  59. - `~/.gemini/config/skills/serpwise` for Antigravity.
  60. It skips Claude Code or Antigravity if they aren't installed. Use `--agents claude,antigravity` to install for them anyway.
  61. With `--project`, it writes `.claude/skills` and `.agents/skills` inside your project instead (Antigravity reads `.agents/skills` there), so you can commit them and share the skill with your team. Restart your agent after installing.
  62. Other options:
  63. | Method | Command |
  64. |---|---|
  65. | skills.sh | `npx skills add sumitroajiprabowo/serpwise` |
  66. | Claude Code plugin | `/plugin marketplace add sumitroajiprabowo/serpwise`, then `/plugin install serpwise@serpwise` |
  67. | No Node.js | `git clone https://github.com/sumitroajiprabowo/serpwise && ./serpwise/install.sh` |
  68. | Claude.ai | Zip `skills/serpwise` and upload it under Settings → Capabilities → Skills |
  69. ## Page auditor
  70. The skill includes a small page auditor with no dependencies beyond Python 3.8. Your agent runs it during an audit, and you can also run it yourself. It covers the parts of an audit that a script can check reliably:
  71. - status codes and redirects;
  72. - robots.txt rules as Googlebot reads them;
  73. - `noindex` and canonical tags;
  74. - titles and meta descriptions;
  75. - hreflang;
  76. - image alt text;
  77. - crawlable links;
  78. - JSON-LD syntax;
  79. - invalid elements in `<head>`;
  80. - Googlebot's 2 MB HTML limit.
  81. ```bash
  82. npx serpwise audit https://example.com
  83. npx serpwise audit index.html --base-url https://example.com/ --offline
  84. npx serpwise audit https://example.com --fail-on high # exit 1 if anything is High or Critical, for CI
  85. ```
  86. ![npx serpwise audit output: two Critical findings, a noindex tag and an <img> that ends the head early, followed by High, Medium and Low findings](assets/auditor.svg)
  87. It reads the HTML as served and doesn't run JavaScript. For single-page apps, check the rendered result with URL Inspection in Search Console.
  88. ## Tested agents
  89. We gave each agent the same task: audit a landing page with eight planted problems.
  90. | Agent | Version | Loaded the skill without being told | Problems found |
  91. |---|---|---|---|
  92. | Claude Code | 2.1 | Yes | 8 of 8 |
  93. | Codex CLI | 0.169 | Invoked with `$serpwise` | 8 of 8 |
  94. | Antigravity CLI | 1.5 | Yes | 8 of 8 |
  95. | GitHub Copilot CLI | 1.0 | Yes | 7 of 8 |
  96. ## Repository layout
  97. - `skills/serpwise/SKILL.md`: the instructions the agent loads first.
  98. - `skills/serpwise/commands/`: one playbook per command.
  99. - `skills/serpwise/references/`: condensed Google Search Central guidance that the agent reads when a task needs it.
  100. - `skills/serpwise/scripts/audit_page.py`: the page auditor.
  101. - `bin/serpwise.mjs`: the `npx serpwise` installer.
  102. ## Contributing
  103. Google changes its documentation often, so corrections are the most useful contribution. See [CONTRIBUTING.md](CONTRIBUTING.md) for how to send one, and [CHANGELOG.md](CHANGELOG.md) for release notes.
  104. ## License
  105. MIT. The reference material paraphrases Google Search Central documentation, which Google publishes under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). serpwise is not affiliated with or endorsed by Google.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.