nanobot-runtime/skills/wiki-compile/SKILL.md

name, description

name	description
wiki-compile	Idempotent wiki source compilation — drain pending raw sources into the wiki. Use when the cron drain goal fires or the user explicitly says "compile now" / "zkompiluj". Handles duplicate detection, ambiguous sources, idempotent skip, and graph regeneration. Do NOT trigger on a plain "add this to my wiki" request — that is capture-only (see llm-wiki skill).

Wiki Compile

Idempotent compile of pending raw sources into the LLM wiki. Runs as a background drain (cron) or on explicit user request ("compile now" / "hned").

When to use

• Cron drain goal fires (background batch compile)
• User explicitly requests synchronous compile ("compile now", "zkompiluj wiki", "do it now")
• NOT for plain "add this" / "save this" requests — those are capture-only (write to cml/raw/, stop)

Prerequisites

• Wiki must be initialized (cml/wiki/SCHEMA.md exists)
• Read SCHEMA.md first — it defines page types, naming rules, and ingest customizations
• Read index.md to know what pages already exist

Steps

1. List pending sources

Scan cml/raw/ for regular .md files (ignore _done/, _hard/, assets/ subdirectories).

If empty → nothing to do, stop.

2. Batch all pending sources

Process all pending sources in one batch — one index/graph update for many sources is more efficient than one-by-one.

3. For each source, check idempotency

Read the source slug from the filename (e.g., cml/raw/my-source.md → slug my-source).

Check if cml/wiki/sources/<slug>.md already exists:

• Exists → already compiled. Move cml/raw/<slug>.md to cml/raw/_done/, skip re-processing, log "skip (already compiled)".
• Does not exist → proceed to duplicate check.

4. Duplicate URL detection

If the source content is a URL (single-line URL or frontmatter url: field), check whether any existing source page in cml/wiki/sources/ already references that same URL:

• Duplicate found → move the raw file to cml/raw/_hard/, append entry to log.md noting "duplicate URL — same as ", skip compilation.
• No duplicate → proceed to ambiguous/conflict check.

5. Ambiguous / conflicting source check

If the source content is unclear, contradictory, or cannot be reliably summarized (e.g., garbled text, empty content, conflicting metadata):

• Move to cml/raw/_hard/
• Append entry to log.md with reason (e.g., "ambiguous — garbled content", "conflicting — title mismatch")
• Skip compilation

6. Compile the source

Follow the standard ingest workflow (see references/ingest-workflow.md in the llm-wiki skill):

1. Read the source (chunked if large)
2. Write a source-summary page at cml/wiki/sources/<slug>.md with full frontmatter and citations
3. Identify existing entity/concept pages this source touches → surgically update relevant sections
4. Create new entity/concept pages for novel topics, linking from related pages
5. Update index.md (or relevant shard) with new pages
6. Append a single line to log.md: date, operation, source title

7. Move processed source

After successful compilation, move cml/raw/<slug>.md to cml/raw/_done/.

Every source must leave cml/raw/ — either _done/ (success/skip) or _hard/ (held back). Never leave a source in the inbox after processing.

8. Regenerate graph (if applicable)

If the wiki has a graph layer (cml/wiki/graph/ontology.yaml exists) and this batch added any pages with graph: frontmatter metadata:

uv run skills/llm-wiki/scripts/wiki_graph_lint.py cml/wiki/
uv run skills/llm-wiki/scripts/wiki_graph_extract.py cml/wiki/

If no graph layer exists, skip this step entirely.

9. Summary

Report what happened in one concise line, e.g.:

• "Compiled 3 sources, skipped 1 (already done), held 1 (duplicate URL)."
• "Nothing to compile — inbox empty."

Key rules

• Idempotent: re-running on the same source is a no-op (skip + move to _done/)
• No force-compiling ambiguous sources: move to _hard/ and log why
• Batch efficiency: one index update + one graph regeneration per batch, not per source
• Graph scripts require wrapper: if workspace safety guard blocks direct execution, write a tmp/ wrapper script using uv run --script with inline dependency metadata
• Language: wiki content is in Czech; compile output and log entries may be in English for consistency with existing logs