cal/claude-configs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
9fd5539dc1
claude-configs/skills/_archive/save-doc/SKILL.md
Cal Corum 9fd5539dc1 Sync: update plugins, settings, archive skills, add new sessions and marketplaces 
- plugins: update installed_plugins, known_marketplaces, install-counts-cache, blocklist; add agent-toolkit and cal-claude-plugins marketplaces
- settings.json: significant config changes (129 insertions, -129 deletions net)
- CLAUDE.md: minor update
- skills: remove json-pretty and save-doc (archived to _archive/save-doc)
- sessions: remove 2 old sessions, add 4 new sessions
- add command-permissions.json, permission-audit.jsonl, tmp/permissions-audit.md
2026-03-20 02:00:59 -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