Skip to content

Skill Manifest

The skills that ship with pi-vault-mind and the agent role definitions.

Bundled skills

These live under skills/ in the package and are auto-loaded by pi when the extension is installed.

pi-vault-mind — the Manager

The primary skill. Loaded by default in any session that has pi-vault-mind installed. Provides the Manager agent with:

  • The "Fork & Review" architecture overview
  • When to call subagent() to fork a worker
  • The 5-agent roster (Manager, Miner, Broadcaster, Heavy-Lifter, Watcher)
  • High-level workflow guidance (Drop & Forget, daily patterns)

Location: skills/vault-mind/SKILL.md

vault-mind-miner — the Miner

Triggered by @agent-Miner, @agent-miner, @agent:research, or @agent:ingest markers. Loaded in forked sessions only.

Responsibilities:

  • Read source files (vault notes, ingested documents)
  • Extract entities and relations
  • Check for duplicates via wiki_search
  • Append to the appropriate collection via append_wiki
  • Optionally write synthesis markdown to Vault/Agent/Inbox/

Location: skills/vault-mind-miner/SKILL.md

vault-mind-broadcaster — the Broadcaster

Triggered by @agent-Broadcaster, @agent-broadcaster, or @agent:podcast markers. Loaded in forked sessions only.

Responsibilities:

  • Read vault sources
  • Upload to Google NotebookLM via MCP or nlm CLI
  • Trigger artifact generation (Audio Overview, study guide, quiz)
  • Poll until done
  • Download artifact back to Vault/Agent/Presentations/

Location: skills/vault-mind-broadcaster/SKILL.md

vault-mind-heavy-lifter — the Heavy-Lifter

Triggered by @agent-Heavy-Lifter, @agent-heavy-lifter, @agent:deep-analysis, or @agent:refactor markers. Loaded in forked sessions only.

Responsibilities:

  • Deep code investigation
  • Large-context-window analysis
  • Complex refactoring (uses git worktrees for isolation)
  • Delegates to external coding assistants (Claude Code, Gemini CLI) via ACP or CLI wrappers

Location: skills/vault-mind-heavy-lifter/SKILL.md

vault-mind-manager — the Manager agent persona

An alternate, lighter Manager persona focused on interactive orchestration without the wiki-specific tooling. Used for sessions where the user is chatting with the agent directly and wants the Manager to be the primary executor (not a dispatcher).

Location: skills/vault-mind-manager/SKILL.md

Auxiliary skills

vault-mind-setup

A setup-specific skill loaded on /wiki setup. Provides the wizard with the right prompts and validation steps.

Location: skills/vault-mind-setup/SKILL.md

Required external skills

These are not bundled with pi-vault-mind but are required for the Obsidian-side features. Install via the skills CLI:

DISABLE_TELEMETRY=1 yes y | npx -y skills add https://github.com/kepano/obsidian-skills \
  --skill obsidian-markdown --skill obsidian-bases \
  --skill json-canvas --skill obsidian-cli --skill defuddle \
  -g -a pi --copy -y
Skill Purpose
obsidian-markdown Wikilinks, callouts, embeds, properties
obsidian-bases .base file format (database views)
json-canvas JSON Canvas (.canvas) format
obsidian-cli Official Obsidian CLI reference
defuddle Clean markdown extraction from web pages

Optional: nlm-skill

Auto-loaded when notebooklm-mcp-cli is installed globally. Provides NotebookLM CLI and MCP tool guidance to the Broadcaster agent.

See also