sssmartspec/docs
Back to siteGitHub

Claude Code skill

smartspec ships with an audit-website skill that lets Claude Code (and any SDK using the same skill format) run audits autonomously.

Install

The skill is bundled inside the npm package — installing smartspec via npm puts the skill at node_modules/smartspec/.claude/skills/audit-website/. If you installed via curl, clone the repo or copy .claude/skills/audit-website/ into your project.

npm i -g smartspec
mkdir -p .claude/skills
cp -r $(npm root -g)/smartspec/.claude/skills/audit-website .claude/skills/

Then in Claude Code, ask:

Audit https://your-site.com

Claude will recognize the request, invoke the skill, run smartspec audit https://your-site.com -f llm -m 50, parse the tagged output, and walk you through the critical findings.

When the skill fires

The skill description triggers Claude on prompts like:

  • "Why isn't my site on Google?"
  • "Audit this URL: …"
  • "Is my Lovable / Bolt / v0 / Replit site SEO-ready?"
  • "Check the SEO of …"

It will NOT fire for keyword research, content strategy, or backlink analysis — smartspec only covers technical SEO and the skill is explicit about that boundary.

Output format used

The skill uses -f llm — a compact tag-based format optimized for LLM context windows. Until v0.2 ships -f llm it falls back to console; the skill still works, just less context-efficient.

Source

The skill spec lives in .claude/skills/audit-website/SKILL.md in the smartspec repo.