Skip to content

feat(v13.14.0): add SEO/AEO discoverability mode to the audit skill - #153

Merged
arzafran merged 2 commits into
mainfrom
feat/audit-seo-mode
Aug 18, 2026
Merged

feat(v13.14.0): add SEO/AEO discoverability mode to the audit skill#153
arzafran merged 2 commits into
mainfrom
feat/audit-seo-mode

Conversation

@arzafran

Copy link
Copy Markdown
Member

What this does

Turns the SEO and AEO work we shipped on satus and the darkroom site into a reusable audit: /audit seo now scans any project against the 17 checks those PRs taught us, so client sites get the same discoverability fixes without rediscovering the bugs.

Summary

  • New Mode: SEO in the audit skill (eighth mode, rides the Shared Contract — CONFIRMED/PLAUSIBLE findings, stable IDs, report to docs/audits/). Asks "will this site be found, ranked, and cited?" — search engines and answer engines both.
  • references/seo-checks.md carries the checks (S1–S17), each with a mechanical detection command and the destination-shape fix. Distilled from satus #348/#405/#413 and website chore: retire upstream-sync cron, sync manifest to 2.1.161 #40/chore(deps): drop yaml and @inquirer/confirm for Bun built-ins #65 — the two repos converged independently, which is the evidence these are destination shapes, not one-off fixes. Highest-value check: curl every sitemap URL and assert 200 (the sitemap never verifies reachability; satus shipped a 404 factory this way).
  • The audit description is compressed to fit the new mode under the 1024-char per-skill cap and the 12 KiB index budget; dropped trigger phrases are ones whose routing keyword survives in the remaining text.
  • Version 13.14.0 across the four version-bearing files; changelog entry added.

Review order: references/seo-checks.md (the substance), then the Mode: SEO section in SKILL.md; the rest is counters and description compression.

Test Plan

  • bun run lint:skills → 0 errors, 0 warnings
  • bun test → 0 fail (includes the four-file version-sync test)
  • bun run typecheck → clean

Encodes the discoverability architecture satus and website converged on
(satus #348/#405/#413, website #40/#65) as 17 mechanical checks with
detection commands, so any client project can be audited against the
destination shape. The audit description is compressed to fit the new
mode under the per-skill and index byte caps.
…ross-model review

- S3/S4: drop grep -P (BSD grep rejects it), use curl -fsS so a missing
  sitemap fails loudly, treat an empty URL set as its own finding
- S15: split search/citation crawlers from training-consent tokens;
  Google-Extended is a consent token, not a crawler, and doesn't affect
  Search — report absence as an owner question, never a defect
- S11: microdata is valid structured data per Google; downgrade presence
  to a migration suggestion, keep the unescaped-< XSS check as the finding
@arzafran
arzafran merged commit 2b858c9 into main Aug 18, 2026
15 checks passed
@arzafran
arzafran deleted the feat/audit-seo-mode branch August 18, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant