geronimo-iia/llm-wiki-skills/spaces

Spaces

A space is a registered wiki repository. Each space has a name (used in wiki:// URIs), a local path, and an optional description. One space is marked as the default — all commands target it unless --wiki <name> is specified.

Use this skill to manage spaces after the initial setup. When called from a running server, create, remove, and set-default take effect immediately — no restart needed.

Repository layout

Each space is a git repository with a fixed structure:

<path>/                     ← repository root
├── wiki.toml               ← wiki identity + config
├── schemas/                ← JSON Schema per page type
├── inbox/                  ← drop zone for files to process
├── raw/                    ← immutable archive of originals
└── wiki/                   ← compiled knowledge (wiki root)

Page slugs are relative to <path>/wiki/.

List all wikis

wiki_spaces_list()

Returns all registered wikis with their paths and which is the current default.

[
  {
    "name": "research",
    "path": "/path/to/research",
    "description": "ML research knowledge base",
    "default": true
  }
]

Inspect a specific wiki

wiki_spaces_list(name: "<name>")

Returns the same structure filtered to the requested wiki. If the name is not found, returns an empty list.

{
  "name": "research",
  "path": "/path/to/research",
  "description": "ML research knowledge base",
  "default": true
}

Create a wiki

Ask the user for a name, path, and optional description.

wiki_spaces_create(path: "<path>", name: "<name>")

Add set_default: true only if the user wants to switch to it.

Register an existing repository

Use when the repository already has wiki.toml and pages — no files are created, no git commit is made:

wiki_spaces_register(path: "<path>")

Optional parameters:

• name — override the name from wiki.toml
• wiki_root — override wiki_root from wiki.toml (error if it conflicts with the value already in wiki.toml)

Validates that the wiki_root directory exists before completing. If the server is running, hot-mounts the space immediately — no restart needed.

Use wiki_spaces_create when starting from scratch. Use wiki_spaces_register when adopting an existing repository or syncing a cloned remote.

Switch default wiki

wiki_spaces_set_default(name: "<name>")

Atomicity guarantees

wiki_spaces_create, wiki_spaces_register, and wiki_spaces_set_default are atomic: if the disk write to wiki.toml fails after in-memory state is updated, the engine rolls back automatically. No manual recovery is needed.

Concurrent space mutations are serialised by an internal lock. A rebuild triggered by file-watcher events on a newly mounted space runs after the space is fully mounted and registered.

Remove a wiki

A wiki cannot be removed if it is the current default — switch default first if needed.

wiki_spaces_remove(name: "<name>")

Add delete: true only if the user explicitly wants to delete the local directory.