Skip to content
Skills Library
Management & product · Tool integration

setup

/setup

Set up Showrunner for the current project - connect an Obsidian vault, scaffold the status board, project hubs and agent protocol, wire CLAUDE.md and agents, run the first sync. Use when the user runs /showrunner:setup or asks to connect Obsidian as the team's backlog.

Licence
MIT
Last repository change
01.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 01.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Set up Showrunner for the current project - connect an Obsidian vault, scaffold the status board, project hubs and agent protocol, wire CLAUDE.md and agents, run the first sync. Use when the user runs /showrunner:setup or asks to connect Obsidian as the team's backlog.

Original author description

Set up Showrunner for the current project - connect an Obsidian vault, scaffold the status board, project hubs and agent protocol, wire CLAUDE.md and agents, run the first sync. Use when the user runs /showrunner:setup or asks to connect Obsidian as the team's backlog.

How it works

  1. 1. Find the vault
  2. 2. Write .claude/showrunner.json
  3. 3. Scaffold the vault
  4. 4. Wire Claude
  5. 5. First sync and check
Original SKILL.md headings · 49 lines, 493 words
SKILL.md preview
---
name: setup
description: Set up Showrunner for the current project - connect an Obsidian vault, scaffold the status board, project hubs and agent protocol, wire CLAUDE.md and agents, run the first sync. Use when the user runs /showrunner:setup or asks to connect Obsidian as the team's backlog.
---

# Showrunner setup

Talk to the user in their language. Ask only what you can't detect. Never overwrite an existing file without showing it and asking.

## 1. Find the vault

- Obsidian keeps its vault list in `obsidian.json`: `%APPDATA%\obsidian\` (Windows), `~/Library/Application Support/obsidian/` (macOS), `~/.config/obsidian/` (Linux). Offer the vaults found there; otherwise ask for a folder (a new empty folder is fine, the user opens it in Obsidian later).
- Service names (`Status.md`, `Projects/`, `System/`, `Templates/`) stay in English. Note content can be in the user's language; if their `status` values are not English, list the active ones in `health.active_statuses`.

## 2. Write `.claude/showrunner.json`

```json
{
  "vault": "<absolute path, forward slashes>",
  "projects": { "<folder or unique substring in tool paths>": "<Project hub name>" },
  "rules": { "max_depth": 3, "exclude": [] },
  "mirror": { "agents": true, "skills": true, "rules": true, "memory": true, "sessions": true },
  "inject_status": true,
  "inject_limit": 4000,
  "board": true,
  "health": { "stale_days": 7, "active_statuses": ["in progress", "waiting for owner"] }
}
```

- `projects`: one entry per top-level folder that is a separate project. Sessions that touched it get linked to its hub. Ask the user to confirm the names.
- `rules.exclude`: folders with third-party `CLAUDE.md` files (cloned repos, examples).
- Add `.claude/.showrunner-cache.json` to `.gitignore` if the project uses git.

## 3. Scaffold the vault

Copy `${CLAUDE_PLUGIN_ROOT}/templates/vault/` into the vault, skipping files that already exist. Then for each project in `projects`, create its hub from the task template (`type: project`) with sections Now, Decisions, Files. Fill what you already know from the repo (README, CLAUDE.md, recent files); leave the rest short. Don't invent history. Start every hub and task note with the folded summary callout from the template. Suggest the Kanban community plugin if the user wants the board as cards.

If the project already has a status/backlog file (`STATUS.md`, `TODO.md`, `backlog.md`), offer to move it: copy it into the vault's archive folder, rebuild the status board from it, and replace the original with a one-line pointer to the vault.

## 4. Wire Claude

- Append `${CLAUDE_PLUGIN_ROOT}/templates/snippets/CLAUDE.md` to the project's `CLAUDE.md`, with the vault path filled in.
- Show the user `${CLAUDE_PLUGIN_ROOT}/templates/snippets/agent.md` and offer to append it to their agents in `.claude/agents/` and `~/.claude/agents/`. Skip agents that already have it.
- If agents run with restricted tools or the vault is outside the project, suggest adding the vault to `permissions.additionalDirectories` in `.claude/settings.json`. The user approves settings changes themselves.

## 5. First sync and check

Run `bash "${CLAUDE_PLUGIN_ROOT}/scripts/run.sh" --inject` from the project root. Expect the status board printed and `System/` filled with agents, skills, rules, memory and sessions. Grep the generated session notes for anything that looks like a secret; if one slipped through, tell the user and add a pattern to `SECRETS` in `sync.py`.

Optional: the Obsidian MCP server (community plugin Local REST API) gives heading-level reads and frontmatter queries. Everything works without it.

Finish with a short summary: vault path, what was created, what the user should open first (`00 Home.md`).

Versions

RepositoryScoreLicence
This page · cmwname/obsidian-showrunner100MIT
HwangSlater/harness-fit100MIT
nesquikm/dev-process-toolkit100MIT
userKael/rastro100MIT
als-apg/osprey100BSD-3-Clause
dedujeong/gemba100Apache-2.0
eigenwise/eigenwise-toolshed100MIT
awrshift/agent-memory-kit100MIT
lifecycle-innovations-limited/claude-ops100MIT

Database snapshot: 13.11.2026 · package version 6cf97d231cc7 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90showrunner
    Keep the project's Obsidian vault (status board, decisions, versions, journal) in sync with the work. Use at the start of a session to get oriented, after finishing a task or getting the owner's verdict at a checkpoint, when the owner asks "what's the status", "what did we…
  • 100obsidian-mcp-agent-vault-integration
    Use this skill when integrating autonomous AI agents with an Obsidian vault via the Model Context Protocol (MCP) server.
  • 100oh-my-obsidian-setup
    Use this skill when the user wants to initialize oh-my-obsidian, create or attach an Obsidian vault, configure persistent vault resolution, or prepare Obsidian Git integration.
  • 95obsidian-github-sync
    Automated GitHub synchronization for Obsidian vault with conflict detection and notification. Use when the user wants to: - Sync their Obsidian vault to a GitHub repository - Set up automatic daily synchronization - Handle git conflicts in Obsidian vault - Configure git-based…
  • 100obsidian-planner
    Maintain durable technical plans and forkable agent task packets in the user's local Obsidian vault. Use when asked to plan a project, create or refine a backlog, hand work to later agents, coordinate parallel worktrees, record substantial investigation findings, or run an ongoing planning agent.
  • 100obsidian-vault-setup
    Configure a new Obsidian vault interactively. Use when setting up a vault from scratch, personalizing vault structure, or creating initial CLAUDE.md and slash commands. Vault初期設定。Vault 初始化。

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.