| name | seo-technical |
| description | Shopify technical SEO audit sub-skill. Checks crawl health, HTTPS status, redirects, canonical tags, sitemap.xml, and robots.txt. Use when user runs /seo technical or when seo-audit delegates technical checks.
|
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.json and use preset
- Run
python3 ~/.claude/skills/seo/scripts/crawl_store.py <url> to generate crawl data before proceeding
- Save output as
seo-audit-crawl.json in 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.json and use preset
b. Run python3 ~/.claude/skills/seo/scripts/crawl_store.py <url> to generate seo-audit-crawl.json
- Spawn agent
audit-technical via 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.
