alfredolopez80/vault
.claude/skills/vault/SKILL.md
Living knowledge base management. Actions: search (query vault), save (store learning), index (update indices), compile (raw->wiki->rules graduation), init (create vault structure). Follows Karpathy pipeline: ingest->compile->query. Use when: (1) searching accumulated knowledge, (2) saving learnings, (3) compiling raw notes into wiki, (4) initializing a new vault. Triggers: /vault, 'vault search', 'knowledge base', 'save learning'.
$ install --global
skillsauthnpx skillsauth add alfredolopez80/multi-agent-ralph-loop vaultInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 6:07 PM7.1s1 file scanned
SKILL.md
- # VERSION:
- 3.0.0
- name:
- vault
- description:
- Living knowledge base management. Actions: search (query vault), save (store learning), index (update indices), compile (raw->wiki->rules graduation), init (create vault structure). Follows Karpathy pipeline: ingest->compile->query. Use when: (1) searching accumulated knowledge, (2) saving learnings, (3) compiling raw notes into wiki, (4) initializing a new vault. Triggers: /vault, 'vault search', 'knowledge base', 'save learning'.
- argument-hint:
- <action: search|save|index|compile|init|demote> [args]
- user-invocable:
- true
Vault — Living Knowledge Base v3.0
Karpathy-inspired knowledge pipeline: Ingest -> Compile -> Query.
Architecture
The vault is a PRIVATE directory OUTSIDE the public repo:
- Location:
$HOME/Documents/Obsidian/MiVault/(configurable) - Backup: private git repo (user creates their own)
- Viewer: Obsidian (optional, vault works as plain markdown + git)
This skill teaches HOW to use the vault (framework). It does NOT contain vault data.
Actions
/vault init
Create vault structure:
VAULT_DIR="${VAULT_DIR:-$HOME/Documents/Obsidian/MiVault}"
# 3-layer structure
mkdir -p "$VAULT_DIR"/{global/{raw/articles,raw/papers,raw/images,wiki,output,decisions},projects,_templates}
# Create vault index
echo "# Vault Index" > "$VAULT_DIR/_vault-index.md"
echo "# Project Index" > "$VAULT_DIR/projects/_project-index.md"
Or run: scripts/setup-obsidian-vault.sh
/vault save <classification> <content>
Save a learning to the vault:
| Classification | Destination | Example |
|---|---|---|
| GREEN | $VAULT_DIR/global/wiki/{category}/ | Generic patterns (TypeScript, React) |
| YELLOW | $VAULT_DIR/projects/{project}/wiki/ | Project-specific knowledge |
| RED | DISCARDED (never saved) | Contains secrets or sensitive info |
/vault search <query>
Search vault for relevant knowledge:
- Search in:
global/wiki/+projects/{current-project}/ - NEVER search in:
projects/{other-project}/(isolation) - Return: matching articles with relevance score
/vault index
Update all _index.md files in the vault:
- Scan all
.mdfiles inglobal/wiki/andprojects/*/wiki/ - Regenerate
_vault-index.mdandprojects/_project-index.md - Update backlinks between articles
/vault compile
Compile raw notes into wiki articles (Karpathy pipeline):
- Read
raw/andlessons/directories - LLM compiles new articles in
wiki/ - Update backlinks between articles
- Update
_index.md - Knowledge Graduation: promote high-confidence learnings to
.claude/rules/learned/
Graduation criteria:
- Confidence >= 0.7
- Confirmed in >= 3 sessions
- Format: rule text + source + confidence + last confirmed date
/vault demote <rule>
Revert a graduated rule back to vault if incorrect:
- Remove from
.claude/rules/learned/{category}.md - Mark source article with
status: demoted
Integration Points
| Component | Integration |
|---|---|
| session-accumulator.sh | PostToolUse hook captures learnings during session |
| vault-graduation.sh | SessionStart hook promotes high-confidence learnings to rules |
| /exit-review | End-of-session GREEN/YELLOW/RED classification |
| smart-memory-search.sh | Adds vault as 5th search source (parallel) |
| pre-compact-handoff.sh | Saves vault context before compaction |
Project Isolation
- A project ONLY reads:
global/wiki/+projects/{its-own-name}/ - NEVER reads
projects/{other-project}/directly - GREEN learnings from any project can be promoted to
global/wiki/ - SHA-256 deduplication prevents duplicate entries
Anti-Rationalization
| Excuse | Rebuttal | |---|---| | "The vault is just another notes system" | The vault graduates to rules. Notes don't change behavior. | | "I'll save it to memory instead" | Memory is ephemeral (25KB). Vault is curated knowledge. | | "Classification is overhead" | 3 seconds to classify saves hours of future searching. | | "RED content is useful for context" | RED = secrets. Never store. Period. |
Related Skills
alfredolopez80/spec
testing
VerifiedTrustedCommunity
Produce a verifiable technical specification before coding. 6 mandatory sections: Interfaces, Behaviors, Invariants (from Aristotle Phase 2), File Plan, Test Plan, Exit Criteria (executable bash commands + expected results). Use when: (1) before implementing features with complexity > 4, (2) as Step 1.5 in orchestrator workflow, (3) when requirements need formalization. Triggers: /spec, 'create spec', 'write specification', 'technical spec'.
121SKILL.mdUpdated Apr 15, 2026
alfredolopez80/ship
testing
VerifiedTrustedCommunity
Pre-launch shipping checklist orchestrating /gates, /security, /browser-test, /perf. Ensures nothing ships without passing all quality checks. Use when: (1) before deploying, (2) before merging to main, (3) before release. Triggers: /ship, 'ship it', 'ready to deploy', 'pre-launch check'.
121SKILL.mdUpdated Apr 15, 2026
alfredolopez80/perf
development
VerifiedTrustedCommunity
Performance optimization skill. Core Web Vitals via Lighthouse, bundle size analysis, metrics tracking over time. Use when: (1) optimizing frontend performance, (2) analyzing bundle size, (3) tracking metrics regression. Triggers: /perf, 'performance audit', 'core web vitals', 'bundle size'.
121SKILL.mdUpdated Apr 15, 2026
alfredolopez80/exit-review
development
VerifiedTrustedCommunity
End-of-session learning classification. Reviews accumulated learnings and classifies each as GREEN (generic, goes to global wiki), YELLOW (project-specific, goes to project wiki), or RED (sensitive, discarded). Triggered at session end via Stop hook. Use when: (1) session ending, (2) manual review of learnings. Triggers: /exit-review, 'review learnings', 'classify learnings'.
121SKILL.mdUpdated Apr 15, 2026