# Semantic Core Builder

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

- **Type:** Skill
- **Install:** `agentstack add skill-sergekostenchuk-ui-ux-agent-skill-system-semantic-core-builder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sergekostenchuk](https://agentstack.voostack.com/s/sergekostenchuk)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [sergekostenchuk](https://github.com/sergekostenchuk)
- **Source:** https://github.com/sergekostenchuk/ui-ux-agent-skill-system/tree/main/core/skills/semantic-core-builder

## Install

```sh
agentstack add skill-sergekostenchuk-ui-ux-agent-skill-system-semantic-core-builder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

1. Read [references/semantic-core-contract.md](references/semantic-core-contract.md).
2. Load `reports/keyword-harvest.json` or a user-provided equivalent.
3. Cluster keywords by intent and topic; label any LLM grouping as `Inference`.
4. Produce cluster records: intent, priority, canonical URL candidate, page type, evidence, and confidence.
5. Write machine-readable `reports/semantic-core.json` and human-readable `docs/site-structure.md`.
6. 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

```text
Input path:
Clusters:
High-priority URLs:
Conflicts:
Evidence gaps:
Output paths:
Next skills: concept-prototyper, seo-llm-site-architect
```

## Validation

```bash
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
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sergekostenchuk](https://github.com/sergekostenchuk)
- **Source:** [sergekostenchuk/ui-ux-agent-skill-system](https://github.com/sergekostenchuk/ui-ux-agent-skill-system)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sergekostenchuk-ui-ux-agent-skill-system-semantic-core-builder
- Seller: https://agentstack.voostack.com/s/sergekostenchuk
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.