Semantic Core Builder
This skill turns raw keyword/search inputs into a structured semantic core. It hands the result to seo-llm-site-architect, concept-prototyper, and later design/implementation skills.
Operating Modes
build: createreports/semantic-core.jsonanddocs/site-structure.md.merge: merge existing-site keywords, user-provided terms, and harvested demand.audit: review a semantic core for missing provenance, duplicate clusters, or weak intent mapping.
Required Workflow
- Read references/semantic-core-contract.md.
- Load
reports/keyword-harvest.jsonor a user-provided equivalent. - Cluster keywords by intent and topic; label any LLM grouping as
Inference. - Produce cluster records: intent, priority, canonical URL candidate, page type, evidence, and confidence.
- Write machine-readable
reports/semantic-core.jsonand human-readabledocs/site-structure.md. - Hand off to
concept-prototyperandseo-llm-site-architect.
Safety And Evidence
- Do not invent search volume or SERP facts.
- If no real SERP/source evidence exists, label the output as
ManualorInference. - Do not bury conflicts; record cannibalization, unclear intent, or missing evidence.
Handoff Shape
Input path:
Clusters:
High-priority URLs:
Conflicts:
Evidence gaps:
Output paths:
Next skills: concept-prototyper, seo-llm-site-architect
Validation
python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/semantic-core-builder
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/semantic-core-builder