SEO + AI Search Audit

An evidence-based, portable Agent Skill for comprehensive traditional SEO and AI-search/GEO/AEO audits. It preserves an immutable baseline, audits source and production behavior, implements justified fixes, and produces reproducible before-and-after evidence without inventing rankings, traffic, or citation outcomes.

The skill uses the open SKILL.md format and is not tied to a specific AI agent or coding assistant.

One-line install

Install the published npm package with:

npx @robertdevore/audit-seo-ai-search

npx downloads the current package from npm, runs the installer, and does not require a permanent global installation.

By default, the installer copies the skill to ~/.agents/skills/audit-seo-ai-search. To install for a product that uses a different skills directory, pass its directory explicitly:

npx @robertdevore/audit-seo-ai-search --target /path/to/your/agent/skills

You can also set AGENT_SKILLS_HOME to change the default skills directory. Restart or reload your agent after installation so it discovers the skill.

Then ask your agent to use the skill, using whatever invocation syntax that client supports. For example:

Use $audit-seo-ai-search to audit this site, implement safe fixes, and verify the result.

Installer options

audit-seo-ai-search [install] [--target <skills-directory>] [--force] [--dry-run]
audit-seo-ai-search doctor [--target <skills-directory>]
audit-seo-ai-search path [--target <skills-directory>]

An existing installation is never overwritten implicitly. --force first renames it to a timestamped backup.

What the skill covers

• Immutable local and production baselines
• Crawlability, indexability, canonicals, redirects, sitemaps, and robots
• Metadata, content quality, entity clarity, internal links, and schema
• Media, accessibility, performance, authority, and historical URL handling
• AI crawler access, AI citation benchmarks, GEO/AEO readiness, and current primary-source research
• Safe remediation, rebuilds, production checks, and before/after artifacts
• CDN, DNS, WAF, 4xx/5xx, and redirect diagnostics when infrastructure is in scope

Development and release

Requirements: Node.js 18+ and Python 3 for the skill's audit scaffold.

npm test
npm run pack:check
python3 /path/to/skill-creator/scripts/quick_validate.py skills/audit-seo-ai-search

To publish a new npm release, update the package version first, then run:

npm login
npm whoami
npm publish --access public

License

MIT