# paddleNET Website Skills And Scripts

This public inventory lists the project-specific skills and deterministic scripts used to build, validate, and publish the static website and AI-readable discovery layers.

## Skills
- **AI Index Discovery Materialization** (`/skills-scripts/ai-index-discovery-materialization-skill.md`): Create the machine-readable ai-index.json discovery and routing layer from markdown, chunks.json, qa.json, and existing index structure.
- **Author Content Structuring** (`/skills-scripts/author-content-structuring-skill.md`): Add lightweight semantic structure, front matter, chunk markers, and stable identifiers to human-authored markdown content.
- **CIS-Guided Semantic Chunk Materialization** (`/skills-scripts/cis-guided-semantic-chunk-generation-skill.md`): Create chunks.json semantic retrieval artifacts using the project-selected subset of the CIS envelope.
- **Discovery Files Materialization** (`/skills-scripts/discovery-files-materialization-skill.md`): Create the final public discovery files: robots.txt, sitemap.xml, llms.txt, agents.md, and skills.md.
- **Execute Content Structuring Process Overview** (`/skills-scripts/execute-content-structuring-process-overview-skill.md`): Guide the overall manual workflow for authoring, structuring, chunking, QA generation, HTML rendering, and discovery materialization.
- **Html Semantic Artifacts Checker Skill** (`/skills-scripts/html-semantic-artifacts-checker-skill.md`): Run this simple skill after each Hugo render, inspect every generated HTML page to verify
- **Semantic QA Materialization** (`/skills-scripts/semantic-qa-materialization-skill.md`): Create qa.json semantic interaction artifacts from chunks.json and source markdown.

## Scripts
- **build_ai_index.py** (`/skills-scripts/build_ai_index.py`): Build public/ai-index.json from content and semantic artifacts.
- **build_discovery_files.py** (`/skills-scripts/build_discovery_files.py`): Build public discovery files for paddlenet.earth.
- **materialize_step3_semantic_artifacts.py** (`/skills-scripts/materialize_step3_semantic_artifacts.py`): Materialize README step 3 semantic artifacts for the current paddleNET pages.
- **publish_hugo_output.py** (`/skills-scripts/publish_hugo_output.py`): Copy Hugo-rendered HTML output into the repo public directory.
- **sync_content_to_hugo.py** (`/skills-scripts/sync_content_to_hugo.py`): Sync author markdown content into the Hugo HTML builder.

## Typical Build Order

1. Structure source markdown content.
2. Generate `chunks.json` and `qa.json` semantic artifacts.
3. Run `sync_content_to_hugo.py`.
4. Run Hugo from `hugo-html-builder/`.
5. Run `build_ai_index.py`.
6. Run `build_discovery_files.py`.