Paul O'Reilly 7d7856a079 Update /log skill to use transcript backups via Sonnet subagent; add switch-mode
- skills/log/SKILL.md: pre-gathers unprocessed transcript metadata (compact
  JSON via list-transcripts-here.sh) rather than full content; spawns a
  Sonnet subagent (not Haiku — gotcha detection requires judgment) to read
  JSONL backups, write a companion -transcripts.md log, and mark backups
  processed in tracking.json; adds Agent and Bash(bash|pwd|python3) to
  allowed-tools
- skills/switch-mode/SKILL.md: add previously untracked skill to repo

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-13 14:06:20 +12:00

Custom Claude Skills

Reusable Claude Code skills shared across all projects.

Setup

# Clone and install
cd ~/dev/claude/custom-claude-skills
./scripts/install.sh

The install script creates symlinks from ~/.claude/skills/ to this repo, making all skills available in every project.

Available Skills

Skill Invocation Description
reflect /reflect M8 Milestone reflection — reviews conversation history, git log, and project docs to produce structured reflection artifacts across MEMORY.md, FUTURE.md, README.md, and CLAUDE.md
log /log End-of-session logging — captures decisions, gotchas, open questions to memory/log/. Prunes old reflected logs.
reflect-logs /reflect-logs Processes session logs into topic memory files, deduplicates, flags stale entries. Run periodically.
distill-best-practices /distill-best-practices Cross-project best practices distillation into claude-foundations/best-practices/. Interactive — proposes changes for approval.
context-load /context-load Reload project context (CLAUDE.md, MEMORY.md, etc.) after /clear or mid-session context loss
linter /linter Audit and manage project formatters/linters. Scan mode checks setup; run mode formats all files.
housekeeping /housekeeping Cross-project health check: git status, unreflected logs, skill validation, pipeline recommendations
decompose /decompose <task> Break a task into subtasks with dependency graph. Writes .agent-tasks.json for container agent orchestration.
orchestrate /orchestrate Check task state, launch container agents in git worktrees. Use /loop 2m /orchestrate for auto-polling.

Adding a New Skill

  1. Create skills/<skill-name>/SKILL.md with YAML frontmatter and instructions
  2. Run ./scripts/install.sh to create the symlink
  3. Update this README's skill table

How Skills Work

Skills are Claude Code's extensibility mechanism. Each skill is a markdown file with:

  • YAML frontmatter — metadata, tool restrictions, execution mode
  • Dynamic context injection!command`` blocks run at load time to pre-fetch data
  • Structured instructions — what Claude should do when the skill is invoked

Skills in ~/.claude/skills/ are available across all projects (personal scope).

Scripts

Script Purpose When to run
scripts/install.sh Symlinks all skills into ~/.claude/skills/ After cloning or adding new skills
Description
Reusable Claude Code skills shared across projects
Readme 117 KiB
Languages
Shell 100%