Inspired by 9arm-skills.
Source: 9arm-skillsReverse-engineered from real GitHub workflow.
Build a lightweight skill management system for Claude Code agents to load and organize reusable prompt-based skills with automation.
I want you to build a skill management system for Claude Code. This is a personal toolkit that loads prompt-based agent skills on demand.
The core idea: I have a collection of reusable "skills" — each one is a prompt that teaches Claude how to do something specific (like debugging methodology, writing postmortems, doing code reviews). These skills live in a directory structure, organized by category. I want a way to:
1. Store each skill as its own folder with a SKILL.md file that has YAML frontmatter (name and description fields) plus the actual skill prompt/instructions
2. Organize skills into categories: engineering (daily coding work), productivity (workflow tools), personal (my own setup), in-progress (drafts), deprecated (old stuff), and misc (random)
3. Provide two simple shell scripts: one that symlinks all shippable skills into ~/.claude/skills/ so Claude Code can load them automatically, and another that lists all SKILL.md files in the repo as a quick reference
The skills I want to create as examples:
- debug-mantra: A four-step debugging discipline (reproduce → trace → falsify → cross-reference) that recites verbatim at session start
- post-mortem: A format for writing canonical engineering records of fixed bugs with root cause, mechanism, fix, validation
- scrutinize: An outsider-perspective review skill for plans, PRs, and code changes that questions intent and traces actual code paths
- management-talk: Rewrite engineer content for leadership audiences across different channels (JIRA, Slack, email, etc.)
Use shell scripts to automate the symlink installation and listing. Keep the directory structure simple and self-documenting. Include a .gitignore to ignore symlinks and compiled artifacts, plus a CLAUDE.md that explains how Claude Code should integrate with this repo.
The goal is to make a lightweight prompt library that Claude Code agents can consume directly, with zero friction to add new skills or update existing ones.