24081a1d6f
Claude Code's Bash permission checker rejects \${VAR} parameter
substitution in skill ! commands. Replace all occurrences with \$VAR
(identical shell expansion) across log, reflect-logs, and
distill-best-practices skills. Rewrite \${VAR:-default} to use
test -n / || pattern instead.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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. |
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 |