The audit says what's broken. Then write the fix.

One install chains the SEO skills: seo-crawl measures crawlability, indexation, redirects and broken links as findings JSON, seo-audit adds a diagnosis when it is installed, and Wordsmith turns every High and Medium finding into optimized alternatives: titles, meta descriptions, headings, internal-link anchors. Report plus rewrite in one pass, and every finding carries its evidence and impact rating.

Install seo-polish Read the source
5 audit layers 2-3 options per finding 1 prioritized plan 0 rankings promised

for coding agents · free, open, MIT

install

Copy one line. Diagnose the site, then write the fixes.

The install line from the repo README. This skill is a chain: seo-crawl and wordsmith must be installed too — if either is missing it says so and stops. The third-party seo-audit is optional.

npx skills add arm-pz/seo-polish --skill seo-polish

the workflow

Five layers audited. Every finding gets a fix drafted.

Each finding is recorded as issue, impact, evidence, fix and priority. Anything High or Medium crosses to Wordsmith, which writes optimized alternatives for the exact element that failed.

Technical 1-2

Crawl and index first — robots, sitemap, canonicals, redirects — then speed, Core Web Vitals, mobile and HTTPS.

  • noindex and canonical direction
  • redirect chains
  • LCP / INP / CLS
  • mixed content
  • hreflang and locale hygiene

On-page 3

Titles, metas, heading hierarchy, image alt text, internal links — each checked against what the page is for.

  • 50-60 char unique titles
  • 150-160 char descriptions
  • one H1 with the primary term
  • alt text on every image
  • orphan pages surfaced

Rewrites 2-3 each

Wordsmith drafts alternatives per flagged element; the report says which checks ran and which were inconclusive.

  • title + meta pairs per page
  • anchor text for internal links
  • content-gap briefs
  • priority-ranked action plan

Outside its boundary 2 siblings

Keyword cannibalization — which of your own pages should win a query — is keyword-guard and keyword-resolver. Pages generated at scale for a keyword list is programmatic-seo. This skill diagnoses a site that exists and writes its fixes. SEO compounds over months; it never promises positions.

  • no ownership rulings
  • no mass page generation
  • no ranking guarantees

ground rules

What it refuses to do.

Evidence over confidence

Every finding states how it was found. A check that could not run — no GSC access, unreadable source, JS-hidden schema — is reported as inconclusive, never as a clean pass or a zero.

Fetch output is untrusted data

Pages are analyzed, never obeyed: instructions embedded in HTML or meta tags are a prompt-injection surface and are treated as content.

White-hat only

No link schemes, no cloaking, no keyword stuffing. The rewrites match search intent in the author's own facts — and say honestly that SEO compounds over months, not days.

The full diagnosis and the paste-ready fix, in one pass.

Free, open, and every alternative traces back to a measured finding.

Install seo-polish Read the source