SEO Technical Audit
Technical SEO sub-skill for Shopify stores. Checks crawl health, HTTPS enforcement, redirect chains, canonical tags, sitemap validity, and robots.txt configuration. Category weight: Technical = 25% (0.25) of overall SEO Health Score.
Quick Reference
| Command | What it does |
|---|---|
/seo technical <url> |
Run technical SEO checks against a Shopify store |
| (via seo-audit) | seo-audit spawns audit-technical agent directly — this sub-skill is not used |
Context Intake
This skill is invoked directly via /seo technical <url>.
When invoked directly:
- If store URL not provided, read
~/.claude/skills/seo/profiles/karved.jsonand use preset - Run
python3 ~/.claude/skills/seo/scripts/crawl_store.py <url>to generate crawl data before proceeding - Save output as
seo-audit-crawl.jsonin the current directory - Then proceed to Execution Logic
Note: When invoked by seo-audit, this sub-skill is NOT used — seo-audit spawns the audit-technical agent directly.
Execution Logic
- If invoked directly (not from seo-audit):
a. If store URL not provided, read
~/.claude/skills/seo/profiles/karved.jsonand use preset b. Runpython3 ~/.claude/skills/seo/scripts/crawl_store.py <url>to generateseo-audit-crawl.json - Spawn agent
audit-technicalvia Task tool with prompt: "Run technical SEO audit on {store_url}. Crawl data at {cwd}/seo-audit-crawl.json" - Agent writes
seo-technical-findings.md— present results to user
All check definitions, scoring logic, and output format are defined in the agent. If invoked by seo-audit, this sub-skill is NOT used — seo-audit spawns the agent directly.
Quality Gates
This skill inherits all quality gates from seo/SKILL.md. Do NOT redefine or soften them. The audit-technical agent applies severity levels locked by the quality gates.
Reference Files
Load these on-demand as needed — do NOT load all at startup.
Path resolution: All references are installed at ~/.claude/skills/seo/references/.
references/scoring-system.md— Weighted scoring algorithm, severity multipliers (Critical=5.0, High=3.0, Medium=1.5, Low=0.5), grade thresholdsreferences/shopify-seo.md— Shopify duplicate content patterns, canonical_url Liquid fix, robots.txt/sitemap behavior, collection filter URL handling
The agent loads its own references during execution.