wiki-promote

Promotes staged wiki entries from _inbox/proposed/ into the live wiki with backlinks and reindexing.

Updated May 14, 2026
One-click install
npx skills add https://github.com/dadlabs-io/llm-wiki-bootstrap --skill wiki-promote-dadlabs-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wiki-promote
Source: https://github.com/dadlabs-io/llm-wiki-bootstrap/tree/main/bootstrap/skills/wiki-promote
Command: npx skills add https://github.com/dadlabs-io/llm-wiki-bootstrap --skill wiki-promote-dadlabs-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Staged wiki ingestion leaves new entries sitting in a holding area (_inbox/proposed/) until a human reviews them; this Skill is the review gate that moves approved entries into the live wiki, wires up their backlinks, and regenerates the index so nothing is published without approval. ## Core Features & Use Cases - Review and approval workflow: Lists pending staged entries with title, tier, and TL;DR, then lets the user promote all, pick one, or review each entry in detail before approving, rejecting, or skipping. - Mechanical promotion: Moves each approved entry to its target taxonomy folder, strips the proposed status, adds suggested backlinks to Related sections, deletes the metadata sidecar, normalizes bare-slug links, and regenerates INDEX. - Defensive validation: Holds back entries with missing, malformed, or folder-less sidecar metadata (exit code 4) instead of filing them at the wiki root, and offers a --check mode that validates staging without moving anything. - Use Case: After running a staged wiki update, invoke the skill with "all" to review the staged entries, approve them, and have each one filed under wiki/<target_folder>/ with backlinks added and the index rebuilt. ## Quick Start Ask the AI to run /wiki-promote to show what is currently staged in proposed and approve the entries you want moved into the live wiki.

Frequently Asked Questions about wiki-promote

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I promote staged wiki entries to the live wiki?▼

Run /wiki-promote to list everything in _inbox/proposed/, then approve entries individually, by filename, or with the all argument. Each approved entry is moved to its target folder, stripped of proposed status, backlinked, and reindexed.

What is the difference between staged and direct wiki ingestion?▼

Staged ingestion writes new entries to _inbox/proposed/ instead of publishing them directly, so a human reviews them first. The wiki-promote skill is the second half of that flow, moving approved entries into wiki/ with backlinks.

Why is a wiki entry held back during promotion?▼

An entry is held when its sidecar metadata file is missing, is not valid JSON, or names no target folder. It stays in _inbox/proposed/ with the reason printed and the run exits 4; fix the sidecar or supply a target folder, then re-run.

What happens to rejected wiki entries?▼

Rejected entries are moved to _inbox/rejected/ along with deletion of their metadata sidecar, never permanently deleted. This keeps an audit trail of everything that was reviewed and turned down.

Should I auto-verify entries at promote time with --verify?▼

Most entries should not be auto-verified at promote time because verification is a deliberate later step. Only pass --verify when the person reviewing the promotion can personally vouch for the entry's claims.