seo

name	seo
description	SEO composite — technical audit, content creation, keyword research, and rank monitoring with persistent domain memory. Replaces 9 fragmented SEO skills.
argument-hint	[audit|create|research|monitor] [target URL or keyword]

seo

Domain-aware SEO pipeline with shared memory across sessions. Audits sites for technical and content SEO issues, creates optimized content, researches keywords with competitive analysis, and monitors ranking changes. Learns from past executions — run #10 benefits from everything learned in runs #1-9.

Replaces: seo-audit, seo-competitor-analysis, seo-content-writer, seo-ops, agentic-seo, ai-seo, on-page-seo-auditor, programmatic-seo, technical-seo-checker

Actions

Action	What	When to Use
audit [url]	Full technical + content + competitor SEO audit	Before optimization work. Monthly cadence.
create [type] [keyword]	Generate SEO-optimized content (article, meta, schema, alt text)	When publishing new content
research [keyword]	Keyword + competitor + SERP research with intent classification	Before content creation or strategy planning
monitor	Check rank changes, detect regressions, compare to history	Weekly or after major changes

Routing

1. Parse action from first argument. Default to audit if ambiguous.
2. Load domain memory from ~/.productionos/domains/seo/
3. If no profile exists: run first-time setup (ask niche, competitors, target keywords)
4. Dispatch to sub-skills/{action}.md
5. After completion: score against evaluation/rubric.yml, update memory, log to history

Domain Memory

Stored at ~/.productionos/domains/seo/:

File	What	Updated When
profile.yml	Niche, target audience, competitors, preferred tone, tech stack	First run + manual updates
keyword-bank.jsonl	Researched keywords with volume, difficulty, intent, position	After every research action
audit-history.jsonl	Past audit scores, issues found, issues fixed	After every audit action
content-log.jsonl	Published content with target keywords and performance	After every create action
learnings.jsonl	Patterns that improved rankings, content that performed	Extracted from audit deltas

Memory Loading

On invocation, load: profile + last 5 audit scores + top keywords + recent learnings. This gives the sub-skill domain context without overwhelming the context window.

First-Time Setup

If no profile.yml exists, ask (one at a time):

1. "What's your site URL and niche?" (e.g., "entropyandco.com, AI video production")
2. "Who are your top 3 competitors?" (auto-suggest from SERP if possible)
3. "What keywords matter most?" (seed list, expanded via research)

Evaluation

Every action scored against evaluation/rubric.yml. See evaluation/rubric.yml for dimensions. Score logged to audit-history.jsonl or content-log.jsonl.

Inputs

Parameter	Values	Default	Description
action	audit, create, research, monitor	audit	Which sub-skill to run
target	URL, keyword, or content type	required for audit/research	What to operate on
depth	quick, standard, deep	standard	How thorough

Error Handling

Scenario	Action
No profile exists	Run first-time setup before proceeding
Target URL unreachable	Report error, suggest checking URL
No keyword data available	Fall back to competitor analysis to discover keywords
Audit finds 0 issues	Suspicious — re-run with deeper checks. Report "clean" with confidence level
Memory directory missing	Create it. Initialize with empty files

Guardrails

1. Never fabricate metrics. All numbers come from tools or declared as estimates.
2. Cite sources. Every recommendation links to the evidence (page URL, tool output, competitor example).
3. Memory is append-only. Never delete past audit results. History enables trend analysis.
4. Profile is user-controlled. Never change niche, competitors, or target keywords without asking.
5. Evaluation is mandatory. Every action gets scored. No silent completion.