cal/claude-plugins
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
51fe634ff5
claude-plugins/plugins/save-doc/commands/save.md
Cal Corum 51fe634ff5 refactor: convert 5 more skills to commands, update transcriber defaults 
Convert backlog, project-plan, save-doc, youtube-transcriber, and
z-image from skills/ to commands/ so they appear as user-invocable
slash commands with plugin name prefixes.

Update youtube-transcriber: switch default model from gpt-4o-transcribe
to gpt-4o-mini-transcribe (OpenAI's current recommendation, half cost)
and fix cost estimates that were 4-7x too high.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 14:41:37 -05:00

3.0 KiB
Raw Blame History

description allowed-tools
Save documentation to the knowledge base with proper frontmatter Read,Write,Edit,Glob,Grep,Bash

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 plugin 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