skills.rest
cbrostrom
cbrostromCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

higgins

Search, read, and update a git-backed Markdown knowledge vault via MCP tools and CLI.

Updated Nov 25, 2024
Search Tags:#markdown#cli#mcp#session management#agent memory#knowledge vault#fts5 search
One-click install
npx skills add https://github.com/cbrostrom/dotfiles --skill higgins-cbrostrom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: higgins
Source: https://github.com/cbrostrom/dotfiles/tree/main/stow/agents/.agents/skills/higgins
Command: npx skills add https://github.com/cbrostrom/dotfiles --skill higgins-cbrostrom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents lose hard-won context between sessions and re-derive the same facts repeatedly. This Skill defines the protocol for the Higgins vault, a git-backed Markdown knowledge base, so agents can search, load, and deposit durable facts through a consistent MCP tool surface instead of ad-hoc file edits. ## Core Features & Use Cases - Scoped FTS5 search: Query the vault with BM25 ranking, tier hints (personal, projects, modules, infra), and a privacy default that keeps personal notes out of results unless explicitly requested. - On-earn deposit discipline: Write gotchas, decisions, and state changes the moment they are discovered, with provenance tags and supersedes markers for corrections. - Session lifecycle tools: Use current/next/gotcha/done/save/wrap to manage project state, and INDEX.md navigation to avoid expensive blind searches. - Use Case: After tracing why a service behaves unexpectedly, immediately record the finding with a gotcha deposit so the next session retrieves it via search instead of re-debugging. ## Quick Start Ask the agent to search the Higgins vault for a specific technical fact, such as "search the vault for the Paseo relay configuration".

Frequently Asked Questions about higgins

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search the Higgins vault from an agent?▼

Use the MCP search tool with 3-5 specific technical terms, an optional tier hint like projects or infra, and a max_tokens budget. The default scope is ai only; personal notes require scope me or all explicitly.

When should I use load versus search in the vault?▼

Use search when you need one specific fact, since load dumps the full project brain at roughly 1,700 tokens. Reserve load for tasks that genuinely need complete project context or when the user explicitly asks.

Can agents edit vault Markdown files directly?▼

No, only the higgins CLI or MCP tools may write to the vault. Direct file edits are forbidden; deposits go through gotcha, current, next, save, or wrap with provenance source tags.

Why does vault search not return personal notes by default?▼

The MCP search tool defaults to scope ai, which excludes the personal Me/ root as a deliberate privacy boundary. Personal content only surfaces when scope is explicitly set to me or all.

How do I correct an outdated fact already in the vault?▼

Search for the existing claim first, then append the correction with a supersedes marker quoting the old claim's key phrase. Never leave both the old and new statements standing unmarked.

Related Skills

Explore More Software Engineering Skills→
swarm-ai-safetyswarm-ai-safety
39

vault-init

Initialize a SWARM Research OS vault with directory structure and templates.

Official
Advanced
SamyakJhaveriSamyakJhaveri

dream

Consolidate and index CLAUDE auto-memory files into durable memories.

Community
Advanced
vaughnangoyvaughnangoy

session-backup

Save Copilot Chat sessions as Obsidian Markdown files organized by workspace and date.

Community
Advanced
brikkoAIbrikkoAI
1

obsidian

Automate Obsidian vault note management, wikilink updates, and content search via CLI.

Official
Intermediate