Agent skill

Vault Groom

by pass-agent in pass-agent/loomkin

Audit and clean up knowledge base state — archive completed work, fix inconsistencies

MITAuto-check passedKnowledge Management

Install Vault Groom

skills CLI
$ npx skills add pass-agent/loomkin --skill vault-groom -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pass-agent/loomkin vault-groom --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pass-agent/loomkin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/vault-groom .claude/skills/vault-groom && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
vault-groom
GitHub stars
181
Token cost
~567 tokens
SKILL.md length
201 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Audit and clean up knowledge base state — archive completed work, fix inconsistencies

  • Tasks that involve Knowledge bases
  • SKILL.md covers Team Mode (Large Vaults), Audit, Check Task Board and Check Temporal Entries, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Vault Groom is an agent skill from pass-agent/loomkin. Audit and clean up knowledge base state — archive completed work, fix inconsistencies

Its SKILL.md is about 570 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Knowledge Management, covering Knowledge bases. The repository describes itself as: What if AI agents could form teams as fluidly as humans? Spawn specialists in milliseconds, share discoveries in real-time, review each other's work, and remember everything… The licence is MIT.

When your agent uses it

  • Tasks that involve Knowledge bases

Example prompts

  • “/vault-groom”

Requirements

  • Pre-approved tools (allowed-tools): vault_audit, vault_kanban, vault_update_entry, vault_search, vault_list, vault_dashboard, ask_user, team_spawn

What it can do on your machine

Read from SKILL.md and the folder at commit f769ae7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • vault_audit
    • vault_kanban
    • vault_update_entry
    • vault_search
    • vault_list
    • vault_dashboard
    • ask_user
    • team_spawn

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Vault Groom loads about 567 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 201 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~567

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pass-agent/loomkin at commit f769ae7, republished under its MIT licence (© pass-agent). 201 words, ~567 tokens.

Download SKILL.mdSave it as .claude/skills/vault-groom/SKILL.md (or your agent's skills folder).
name
vault-groom
description
Audit and clean up knowledge base state — archive completed work, fix inconsistencies
allowed-tools
vault_audit, vault_kanban, vault_update_entry, vault_search, vault_list, vault_dashboard, ask_user, team_spawn

Run a health check on the knowledge base and fix issues.

Team Mode (Large Vaults)

For large vaults (500+ entries), spawn a team to parallelize grooming:

team_spawn(
  team_name: "vault-grooming",
  purpose: "Audit, archive, and fix issues across a large vault",
  roles: [
    %{name: "vault-auditor", role: "researcher"},
    %{name: "vault-archiver", role: "coder"},
    %{name: "vault-fixer", role: "coder"}
  ]
)

Team roles:

  • vault-auditor: Runs vault_audit(scope: "full") and catalogs all issues. Shares the report with archiver and fixer.
  • vault-archiver: Processes completed task archival (vault_kanban(action: "archive")), archives old checkins, and moves stale entries.
  • vault-fixer: Applies approved metadata fixes, corrects frontmatter, resolves structural issues.

For smaller vaults, skip team mode and process single-agent.


Audit

vault_audit(scope: "full") — get the full quality report.

Check Task Board

vault_kanban(action: "list", filter_column: "done") — find completed tasks ready for archive. vault_kanban(action: "list", filter_column: "in_progress") — check for stale items (no activity in 7+ days).

Check Temporal Entries

vault_list(entry_type: "checkin") — find checkins older than 30 days for archiving.

Present Findings

Format as a structured report:

  • Task issues (missing metadata, stale items)
  • Completed tasks ready to archive
  • Old checkins ready to archive
  • Quality issues from vault_audit
  • OKR/milestone status inconsistencies

Interactive Fix

Use ask_user to confirm each category of fix:

  • "Archive these X completed tasks?"
  • "Archive these Y old checkins?"
  • "Fix these Z metadata issues?"

Apply Fixes

  • Archive tasks: vault_kanban(action: "archive")
  • Archive checkins: vault_update_entry(status: "archived") for each
  • Fix metadata: vault_update_entry(frontmatter_updates: "...") for each

Refresh

vault_dashboard(dashboard_type: "index") after all fixes.

© pass-agent, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/vault-groom of pass-agent/loomkin.

Open the folder on GitHubat commit f769ae7

Compare with similar skills

Vault Groom next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Vault Groom compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vault Groom this skillpass-agent/loomkin181—~567Automated safety check: PassMIT
Capture Conversationoutline/outline41k—~474Automated safety check: PassCustom licence
Find And Citeoutline/outline41k—~537Automated safety check: PassCustom licence
Xhs Virtual Productchenjin-cmd/xhs-virtual-product726—~862Automated safety check: PassMIT
OpenkbVectifyAI/OpenKB4.8k1 repos~2kAutomated safety check: WarnApache-2.0
Learn From Materialsdmoshehun-prog/learn-from-materials937—~7.9kAutomated safety check: PassMIT

Similar skills

  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Find And Cite

    outline/outline

    Answer questions from the Outline knowledge base with quotes and links to the source documents; use when the user asks what the team knows, documented, or decided about a topic.

    41k GitHub stars~537 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Xhs Virtual Product

    chenjin-cmd/xhs-virtual-product

    This skill helps plan, select, produce, and market Xiaohongshu (RED) virtual/digital products — templates, knowledge bases, test tools, study materials.

    726 GitHub stars~862 tokensUpdated 8 days ago
    Knowledge ManagementAuto-check passed
  • Openkb

    VectifyAI/OpenKB

    A skill your agent uses when the user asks about content in their OpenKB knowledge base — research topics, concepts compiled from their documents, cross-document synthesis — or mentions openkb, an…

    4.8k GitHub starsUsed in 1 repo~2k tokens
    Knowledge ManagementAuto-check: warnings
  • Learn From Materials

    dmoshehun-prog/learn-from-materials

    Turns books, PDFs, slides and web pages into a source-grounded knowledge base and an interactive learning page in English or Chinese, with quizzes, relationship maps and reusable methodology notes.

    937 GitHub stars~7.9k tokensUpdated 2 days ago
    Knowledge ManagementAuto-check passed
  • Onyx CLI

    onyx-dot-app/onyx

    Query the Onyx knowledge base using the onyx-cli command. An agent skill from onyx-dot-app/onyx.

    32k GitHub starsUsed in 1 repo~2.6k tokens
    Knowledge ManagementAuto-check passed

More from pass-agent/loomkin

All 14 skills in this repo
  • React Ink

    pass-agent/loomkin

    A skill your agent uses when building terminal user interfaces with React Ink - interactive CLI apps, terminal dashboards, progress displays, or keyboard-driven TUI components.

    181 GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • Clack

    pass-agent/loomkin

    Build and maintain interactive Node.js/Bun CLIs with Clack (@clack/prompts and @clack/core).

    181 GitHub stars~797 tokensUpdated 4 mo ago
    Auto-check passed
  • Modern CSS

    pass-agent/loomkin

    Specialized knowledge for writing modern high-quality CSS. An agent skill from pass-agent/loomkin.

    181 GitHub stars~3.8k tokensUpdated 4 mo ago
    Auto-check passed
  • Elixir Expert

    pass-agent/loomkin

    Expert in Elixir, Phoenix Framework, and OTP. An agent skill from pass-agent/loomkin.

    181 GitHub starsUsed in 1 repo~796 tokens
    Auto-check passed
  • Tui Design

    pass-agent/loomkin

    This skill should be used when designing terminal user interfaces, creating TUI layouts, choosing TUI color schemes, implementing keyboard navigation, building terminal dashboards, or working with…

    181 GitHub stars~5k tokensUpdated 4 mo ago
    Auto-check passed
  • Vault Meeting

    pass-agent/loomkin

    Process a meeting transcript — extract decisions, action items, and key discussion points into structured vault entries

    181 GitHub stars~1.5k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Vault Groom

What does Vault Groom do?

Audit and clean up knowledge base state — archive completed work, fix inconsistencies. Vault Groom is an agent skill from pass-agent/loomkin.

When should I use Vault Groom?

Vault Groom fits situations like: tasks that involve Knowledge bases.

How do I install Vault Groom in Claude Code?

Run `npx skills add pass-agent/loomkin --skill vault-groom -a claude-code`. Or copy the skill folder (.agents/skills/vault-groom in pass-agent/loomkin) into .claude/skills/vault-groom in your project. Claude Code loads it when a task matches its description.

How do I install Vault Groom in Codex?

Run `npx skills add pass-agent/loomkin --skill vault-groom -a codex`. Or copy the skill folder (.agents/skills/vault-groom in pass-agent/loomkin) into .agents/skills/vault-groom in your project. Codex loads it when a task matches its description.

Can I use Vault Groom in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pass-agent/loomkin --skill vault-groom -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vault-groom, .gemini/skills/vault-groom, .github/skills/vault-groom and .opencode/skills/vault-groom in your project.

What does Vault Groom need to run?

SKILL.md names no scripts, command-line tools or credentials: Vault Groom is instructions for the agent only. Its frontmatter pre-approves these tools: vault_audit, vault_kanban, vault_update_entry, vault_search, vault_list, vault_dashboard, ask_user, team_spawn.

Does Vault Groom access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Vault Groom safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Vault Groom use?

Vault Groom is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vault Groom use?

About 567 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Vault Groom?

Skills that share tags, products or a category with Vault Groom: Capture Conversation (outline/outline, 41k stars), Find And Cite (outline/outline, 41k stars), Xhs Virtual Product (chenjin-cmd/xhs-virtual-product, 726 stars) and Openkb (VectifyAI/OpenKB, 4.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vault Groom?

pass-agent (a GitHub organization) maintains it in pass-agent/loomkin, which has 181 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on May 17, 2026.

Source: pass-agent/loomkin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.