cal/claude-configs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
b464a10964
claude-configs/skills/save-doc/SKILL.md
Cal Corum b464a10964 Sync config: add save-doc skill, update agents/skills/plugins, clean sessions 
- Add skills/save-doc/ skill
- Add sessions/2121928.json
- Delete cognitive-memory skill, memory-saver agent, save-memories command
- Update CLAUDE.md, pr-reviewer, issue-worker agents
- Update mcp-manager, create-scheduled-task, paper-dynasty skills
- Update plugins (blocklist, installed, known_marketplaces, marketplaces)
- Remove old session files

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 02:00:54 -05:00

3.0 KiB
Raw Blame History

allowed-tools description user-invocable
Read,Write,Edit,Glob,Grep,Bash Save documentation to the knowledge base true

Save learnings, fixes, release notes, and other documentation to the claude-home knowledge base. Files are auto-committed and pushed by the sync-kb systemd timer (every 2 hours), which triggers kb-rag reindexing.

Frontmatter Template

Every .md file MUST have this YAML frontmatter to be indexed:

---
title: "Short descriptive title"
description: "One-sentence summary — used for search ranking, so be specific."
type: <type>
domain: <domain>
tags: [tag1, tag2, tag3]
---

Valid Values

type (required): reference, troubleshooting, guide, context, runbook

domain (required — matches repo directory):

Domain Directory Use for
networking networking/ DNS, Pi-hole, firewall, SSL, nginx, SSH
docker docker/ Container configs, compose patterns
vm-management vm-management/ Proxmox, KVM, LXC
tdarr tdarr/ Transcoding, ffmpeg, nvenc
media-servers media-servers/ Jellyfin, Plex, watchstate
media-tools media-tools/ yt-dlp, Playwright, scraping
monitoring monitoring/ Uptime Kuma, alerts, health checks
productivity productivity/ n8n, automation, Ko-fi
gaming gaming/ Steam, Proton, STL
databases databases/ PostgreSQL, Redis
backups backups/ Restic, snapshots, retention
server-configs server-configs/ Gitea, infrastructure
workstation workstation/ Dotfiles, fish, tmux, zed
development development/ Dev tooling, CI, testing
scheduled-tasks scheduled-tasks/ Systemd timers, Claude automation
paper-dynasty paper-dynasty/ Card game project docs
major-domo major-domo/ Discord bot project docs
tabletop tabletop/ Tabletop gaming
tcg tcg/ Trading card games

tags: Free-form, lowercase, hyphenated. Reuse existing tags when possible.

File Naming

  • Lowercase, hyphenated: pihole-dns-timeout-fix.md
  • Release notes: release-YYYY.M.DD.md or database-release-YYYY.M.DD.md
  • Troubleshooting additions: append to existing {domain}/troubleshooting.md when possible

Where to Save

Save to /mnt/NV2/Development/claude-home/{domain}/. The file will be auto-committed and pushed by the sync-kb timer, triggering kb-rag reindexing.

Workflow

  1. Identify what's worth documenting (fix, decision, config, incident, release)
  2. Check if an existing doc should be updated instead (kb-search or Glob)
  3. Write the file with proper frontmatter to the correct directory
  4. Confirm to the user what was saved and where

Examples

See examples/ in this skill directory for templates of each document type:

  • examples/troubleshooting.md — Bug fix / incident resolution
  • examples/release-notes.md — Deployment / release changelog
  • examples/guide.md — How-to / setup guide
  • examples/runbook.md — Operational procedure