lumi-init

Create missing Lumina wiki directories and seed catalog and log files.

36|16|Updated May 1, 2026
One-click install
npx skills add https://github.com/tronghieu/lumina-wiki --skill lumi-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lumi-init
Source: https://github.com/tronghieu/lumina-wiki/tree/main/src/skills/core/init
Command: npx skills add https://github.com/tronghieu/lumina-wiki --skill lumi-init

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Lumina wiki workspaces can start incomplete or empty after installation, leaving missing folders and core pages that prevent ingestion and knowledge querying.

Core Features & Use Cases

  • Verifies configuration and installed packs by reading _lumina/config/lumina.config.yaml and _lumina/manifest.json to confirm what should exist.
  • Materializes the required directory structure using the engine initializer to create only missing folders (idempotent, safe to re-run).
  • Seeds core catalog and log pages by creating wiki/index.md (with lumina markers) and wiki/log.md (with the first init entry), then verifies correctness with lint.
  • Use case: You run the first setup (or re-run after moving folders) and want a clean, lint-green workspace ready for /lumi-ingest and /lumi-ask without manually creating wiki/ subdirectories.

Quick Start

Tell the assistant to initialize the wiki workspace by running the lumi-init skill.

Frequently Asked Questions about lumi-init

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

FAQPage Schema
How do I initialize a wiki workspace directory structure from scratch?

To initialize a wiki workspace, this skill reads configuration and manifest files to determine active packs, then materializes missing directories and seeds core catalog pages idempotently. It ensures a clean, lint-green state without overwriting existing user-authored content.

Can I re-run workspace scaffolding safely if some directories already exist?

Yes, workspace scaffolding is idempotent and safe to re-run. The initializer checks for existing folders and core pages, creating only the missing elements required for ingestion and querying while preserving any user-authored content already present.

What's the best way to fix an incomplete wiki workspace after moving folders?

Fixing an incomplete wiki workspace involves reading the config and manifest to verify active packs, then recreating missing directory structures and seeding core catalog and log files. This recovery process enforces lint validation to ensure the workspace is ready.

Does wiki initialization overwrite existing markdown files?

No, wiki initialization does not overwrite existing markdown files. The process only seeds core catalog and activity log pages like index.md and log.md if they are missing, ensuring your user-authored content remains untouched during setup or recovery.

Why does my wiki ingestion fail after a fresh installation?

Wiki ingestion fails after installation because required folders and core pages are missing. Running an initialization skill materializes the necessary directory structure and seeds the catalog, allowing ingestion and querying to proceed without manual file creation.