# SEO Technical

> 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.

- Skill: `karvedconcepts/seo-technical` (Agent Skill)
- Install (CLI): `npx skillmds@latest add karvedconcepts/seo-technical`
- Raw SKILL.md: https://api.skillmd.com/api/skills/karvedconcepts/seo-technical/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: karvedconcepts (https://skillmd.com/u/karvedconcepts)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/karvedconcepts/seo-technical

---


# 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

1. 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`
2. Spawn agent `audit-technical` via Task tool with prompt:
   "Run technical SEO audit on {store_url}. Crawl data at {cwd}/seo-audit-crawl.json"
3. 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 thresholds
- `references/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.