Workspace vault maintainer
Skill guoyongchang/worktree-manager-obsidian-bridge/skills/workspace-vault-maintainer
Use when working from a workspace root that is backed by a Vault or Obsidian wiki and you need to restore local runtime files, rebuild a `.vault/` linked-docs layer, match the workspace through a registry, or ingest durable knowledge back into the right workspace wiki pages after meaningful work.From its SKILL.md
npx -y skills add guoyongchang/worktree-manager-obsidian-bridge --skill workspace-vault-maintainerAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
4.1 KB, as published. Nobody here has run it
Workspace Vault Maintainer
Overview
This skill maintains a two-way workflow between a local workspace runtime and a Vault-backed workspace wiki.
Use it for two related jobs:
restore: rebuild or repair the local workspace runtime from the Vault-backed definitioningest: update the workspace wiki after new durable knowledge appears during work
This skill is designed to support both Codex and Claude Code. Keep the shared workspace model consistent, and treat tool-specific plugin behavior as an implementation detail.
When To Use This Skill
Use this skill when one or more of these are true:
- you are standing in a workspace root, not just a single repo
- the workspace uses a Vault or Obsidian wiki as the source of truth
- the workspace has local runtime files such as
AGENTS.md,CLAUDE.md,.ai/*, or.vault/ - you need to restore a missing or stale
.vault/linked-docs layer - you need to identify which workspace definition in the Vault matches the current directory
- you need to update the workspace wiki after meaningful implementation, debugging, review, or architecture work
Workflow Decision
- Identify the current workspace
- Find structured state first
- Decide whether this is
restoreoringest - Touch only the minimum useful pages or runtime files
- Report what changed and what still needs confirmation
Prefer declared state over guesswork:
- workspace registry
- local
.ai/desired-state.json - local
.ai/restore.md - local
.vault/ - workspace
index.md,log.md,ingest.md
Restore Workflow
Use restore when the local runtime is missing, stale, or incomplete.
Restore checklist:
- Identify the workspace from the current directory and registry
- Load the workspace definition from the Vault
- Check local runtime files such as:
AGENTS.mdCLAUDE.md.ai/restore.md.ai/desired-state.json.ai/bootstrap-prompt.md.ai/local-overrides.example.json
- Rebuild or repair the local
.vault/linked-docs layer - Restore declared Claude Code, Codex, skill, and MCP expectations
- Summarize the result
Full restore should normally create or repair .vault/. If .vault/ is not restored, call that out as incomplete unless the user explicitly asked for a lightweight setup.
For detailed restore rules, read references/restore-workflow.md.
Ingest Workflow
Use ingest when the work produced durable knowledge that future sessions should remember.
Typical ingest triggers:
- architecture changes
- new constraints or invariants
- new dev, build, or release commands
- API changes
- debugging conclusions that future sessions would benefit from
- changes to workspace structure or repo roles
Ingest checklist:
- Read the workspace
index.md,log.md, andingest.md - Inspect the recent work and relevant source material
- Update only the most relevant wiki pages
- Avoid duplicating existing content
- Append a concise entry to the workspace
log.md
For detailed ingest rules, read references/ingest-workflow.md.
Claude Code And Codex
The shared workspace model should stay the same across both tools:
- same workspace identification
- same Vault-backed source of truth
- same
.vault/linked-docs layer - same ingest targets
Tool-specific differences:
- Claude Code usually needs plugin enablement and project MCP checks
- Codex usually needs project plugin declarations, skills, marketplace, or local plugin surfaces
For the structured state model, read references/registry-schema.md.
Output Style
- reply in the user's preferred language
- keep summaries short and structured
- clearly distinguish confirmed facts from inference
- separate restore results from ingest results