A personal collection of skills for AI coding agents. Each skill packages instructions, references, and workflows that extend agent capabilities beyond their defaults.
Skills are packaged instructions that teach AI agents new workflows and specialized knowledge. Think of them as plugins — a SKILL.md file with YAML frontmatter tells the agent when to activate, and markdown content tells it what to do. Supporting files (references, templates, scripts) are loaded on demand to keep context usage minimal.
Skills follow the Agent Skills open standard, which originated in Claude Code and has been adopted across all major AI coding agents.
Install any skill with a single command using the Skills CLI:
npx skills add adeonir/agent-skillsOr install a single skill:
npx skills add adeonir/agent-skills/<skill-name>| Skill | Description |
|---|---|
| debug-tools | Iterative investigate–fix–verify debugging with confidence scoring |
| git-helpers | Conventional commits, pull requests, and branch lifecycle |
| plain-spoken | STE-inspired technical prose with less jargon and preserved precision |
| review-lens | Confidence-scored pre-PR code review in quick and deep modes |
| rule-creator | Create and manage Claude Code rules in .claude/rules/ |
| spec-driven | Spec-driven feature development with auto-sizing and full traceability |
| Skill | Description |
|---|---|
| brainstorm | Structured idea exploration and plan stress-testing, diverge to converge |
| copywriting | Authors copy.yaml — write, extract, refresh, plus critique and audit |
| craft-ui | Plan layout structure, render design variants, critique a variant, audit a running UI — non-mutating |
| design-brief | Greenfield visual identity — explore a direction and author DESIGN.md |
| docs-writer | Structured docs: PRD, Brief, Design Doc, ADR |
| epic-tracker | Epics, stories, bugs, and tasks — tracked in Linear or GitHub |
| Skill | Description |
|---|---|
| anti-slop | Edit drafts into sharper, more human prose, or detect AI tells without rewriting |
| notes | Obsidian notes for projects, meetings, challenges, and brag docs |
| handoff | Save and resume conversation state across sessions |
| wrap-up | End-of-session context persistence to Obsidian |
flowchart TD
BR[brainstorm] -->|direction| DW_PRD[docs-writer · product]
BR -->|direction| DB[design-brief]
BR -.->|direction| SD[spec-driven]
DW_PRD -->|requirements| DW_DD[docs-writer · technical]
DW_PRD -->|requirements| ET[epic-tracker]
DW_PRD -->|requirements| DB
DW_PRD -->|requirements| CU[craft-ui]
DW_PRD -->|requirements| CW[copywriting]
CW -->|content| CU
DB -->|tokens| CU
CU -->|interface| SD
DW_DD -->|technical doc| SD
DW_DD -->|technical doc| ET
DW_DD -->|technical doc| DB
DW_DD -.->|extract decision| DW_ADR[docs-writer · decision]
ET -->|stories| SD
SD -->|commits & pull requests| GH[git-helpers]
SD -.->|coherence gap| DW_DD
Dashed arrow: optional shortcut for small, well-scoped work. debug-tools, rule-creator, notes, handoff, and wrap-up are available at any point — utilities and reviews used as needed, not mandatory pipeline stages.
The full flow when building a new product or feature with non-trivial business logic:
1. brainstorm --> direction and constraints
2. docs-writer --> requirements (what to build, for whom, why)
3. docs-writer --> technical decisions and trade-offs
4. design-brief --> visual identity and design tokens
5. copywriting --> content and copy
6. craft-ui --> plan layout structure, build and pressure-test the interface
7. epic-tracker --> epics, stories, acceptance criteria
8. spec-driven --> per-story spec, design, tasks, implementation
9. review-lens --> review changes before commit
10. git-helpers --> commit, pull request, finish branch
spec-driven discovers coherence gaps during implementation and signals back:
spec-driven discovers gap (missing entity, orphan flow, NFR drift)
--> records the gap in CONTEXT.md ## Gotchas
--> user reruns docs-writer with update mode
--> docs-writer re-enters the responsible phase scoped to the gap
--> spec-driven resumes with updated technical doc
docs/
├── product/ # brainstorm: brainstorm.md · docs-writer: PRD, brief
├── tech/ # docs-writer: design-doc
├── adr/ # docs-writer: append-only decision log
└── design/ # design-brief: visual identity · copywriting: content
.artifacts/
├── specs/ # spec-driven: per-feature spec, design, tasks, validation
├── archive/ # spec-driven: features archived after merge
├── CONTEXT.md # spec-driven: cross-feature decisions, gotchas, conventions
├── STATE.md # spec-driven: active-feature handoff
├── LESSONS.json # spec-driven: canonical lessons (machine-owned)
├── codebase/ # spec-driven: area exploration cache (regenerable)
├── research/ # spec-driven: research cache
└── design/ # design-brief: tune session events · craft-ui: VARIANTS.md + final.html + structure.yaml + variant HTML
epic-tracker writes no artifacts here — its epics, stories, bugs, and tasks
live in the tracker (Linear or GitHub).
Skills write to docs/ (committed, human-facing) and .artifacts/ (gitignored agent workspace).
MIT