TWISTEdBRACKETS

Quality & review

SEO

seo

Checks and fixes on-page and technical SEO for this site's routes and MDX posts, grounded in a maintained checklist and in the metadata helpers this project already has - sitemap.js, robots.js, site-metadata.js, and structured-data.js. It's not a from-scratch setup: the job is to check specific pages/posts against those existing conventions and against on-page best practice, then fix what's missing by reusing the existing helpers rather than hand-rolling new ones.

What it does

  • Resolves the named page(s) or post(s) to route/content files
  • Checks metadata exports, title/description length, and canonical resolution
  • Confirms new static routes are listed in sitemap.js and allowed in robots.js
  • Verifies heading structure, image alt text, and internal link anchor text
  • Adds or fixes structured data using the existing generators in structured-data.js
  • Reports issues by severity when asked to audit, or fixes directly when asked to

Report format example

The shape of the findings this skill reports back when asked to audit rather than fix directly.

text
### /guides/widget-setup - 2 issues

Blocker - page.js
No generateMetadata() export; the page falls back to the root layout's default title and description.
Guideline: Titles & meta descriptions - every route needs a unique title/description.
Fix: add generateMetadata() built on buildSocialMetadata() from site-metadata.js.

Major - page.js
Article content with no matching JSON-LD; structured-data.js already has generateArticleSchema.
Guideline: Structured data - use an existing generator before writing a new schema.
Fix: call generateArticleSchema() and render it via <script type="application/ld+json">.

How it flows

  1. 01Resolve target page(s)/post(s) to route or content files
  2. 02Read the maintained checklist in references/seo-guidelines.md
  3. 03Check metadata, sitemap/robots presence, headings, images, and links
  4. 04Reuse or extend structured-data.js generators for JSON-LD
  5. 05Report findings by severity, or implement the requested fix directly

Example prompt

“/seo Check the pricing page for missing structured data and fix the meta description.”

Install

sh
npx dot-skills add levi-putna/twistedbrackets.com/seo