FarhanImtiaz

SEO Architect — Development skill for Claude Code

Development community

Claude Code skill for technical SEO and AEO: scored audits, cited best-practice patterns, and a guardian that flags risky SEO edits for review before they ship.

How to install SEO Architect

This entry records only its repository, not the path inside it, so there is no exact command to give. Open FarhanImtiaz/seo-architect and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What SEO Architect does

Claude Code skill for technical SEO and AEO: scored audits, cited best-practice patterns, and a guardian that flags risky SEO edits for review before they ship. Offline by default.

Alternatives in Development

Identify Assumptions Existing — Identify risky assumptions across Value, Usability, Viability, Feasibility 7.8k ★
Fast Jev Compaction — Claude Code plugin that replaces the compaction summary with Jev decisions: every tool call and result is scor 425 ★
Af Ship — Check $ARGUMENTS for flags before doing anything else 187 ★

README

SEO Architect

A Claude Code skill for technical SEO and AEO (answer-engine) engineering: auditing, planning, implementing, and validating search visibility across a codebase.

It is built around one constraint: **it never fabricates a ranking, a traffic number, a result, a client, a review, or a citation.** Every finding traces to something observed in your source code, a named and cited external source, or data you explicitly imported. When it doesn't have evidence, it says so instead of guessing.

See it work

This is the real output from the worked example in [`examples/worked-example-nextjs`](examples/worked-example-nextjs) — a small, deliberately flawed four-page Next.js fixture, not a cherry-picked demo.

$ claude
> /seo-architect audit

HIGH   jsonld        /product's Product schema has none of offers/review/aggregateRating —
                      Google requires at least one for rich-result eligibility
MEDIUM metadata      /about has no statically detectable title or description
MEDIUM images        /product's  has no alt attribute and no width/height
MEDIUM graph         /orphan has no inbound internal links
MEDIUM state         .claude/seo/keywords.md and strategy.md are still template-stub-only

Score: 58.3/100 (internal prioritization, not a ranking prediction — evidenced coverage 71%)

Ask it to fix the safe ones, and rescan:

Score: 73.2/100 (up from 58.3)   HIGH/CRITICAL findings: 0 (down from 1)

Full transcript, including exactly which fixes the Guardian classified as safe-to-auto-apply vs. review-first, is in [`examples/worked-example-nextjs/walkthrough.md`](examples/worked-example-nextjs/walkthrough.md).

Install

mkdir -p ~/.claude/skills
ln -s "$(pwd)/seo-architect" ~/.claude/skills/seo-architect

Then, in any project: `/seo-architect setup` once, then `/seo-architect audit`. Full options (per-project install, plugin packaging) in [INSTALL.md](INSTALL.md).