36aa3d26ee
Session isn't finished until delivered work is written back to the project's canonical planning store (cp-cli / local checkout / offline staging), and roll-up docs are checked for contradictions. Motivated by the agent-runtimes work-items repo drifting 6 weeks behind delivered reality.
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
- Create
skills/<skill-name>/SKILL.mdwith YAML frontmatter and instructions - Run
./scripts/install.shto create the symlink - 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 |