| name | semantic-core-builder |
| description | Build an evidence-labeled semantic core and crawlable site structure from keyword harvests, existing content, or user-provided search-demand data. Use before SEO/LLM site architecture, concept prototypes, paid traffic planning, IA, or public-site redesign decisions. |
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: create reports/semantic-core.json and docs/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.json or 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.json and human-readable docs/site-structure.md.
- Hand off to
concept-prototyper and seo-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
Manual or Inference.
- 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
