AI-powered slash commands & skills for Claude Code that handle the tedious parts of software development — commits, specs, code review, and more.
Built for developers who use Claude Code and want a consistent, automated SDLC workflow across all their projects.
gh repo clone jerichoBob/aidev-toolkit-dist-dist ~/.claude/aidev-toolkit && ~/.claude/aidev-toolkit/scripts/install.shThen open any project in Claude Code and run /aid to see what's available.
Smart commits in one command
Instead of manually staging, writing commit messages, bumping versions, and pushing:
/commit-push
It analyzes your changes, groups them into logical commits, writes conventional commit messages, bumps the version, updates the changelog, and pushes — all without you writing a single commit message.
Spec-driven development
Describe a feature, get a full implementation plan with phases and tasks:
/sdd-spec "add OAuth login with GitHub"
/sdd-code-spec v5
Claude creates the spec, then implements it phase by phase with a living checklist in specs/README.md. You always know what's done, what's next, and why decisions were made.
Instant codebase orientation
Drop into an unfamiliar repo and get oriented in 30 seconds:
/inspect
Returns architecture, tech stack, entry points, patterns, and anything you'd want to know before making changes.
Architecture review
Check your codebase against security, observability, error handling, and testing principles:
/arch-review
Flags issues against documented principles with severity levels and remediation suggestions.
Gmail triage
Scrape your inbox and categorize unread emails by urgency — without leaving Claude Code:
/gmail-digest
Requirements: Claude Code, GitHub CLI, git, jq
gh repo clone jerichoBob/aidev-toolkit-dist-dist ~/.claude/aidev-toolkit
~/.claude/aidev-toolkit/scripts/install.shOther install methods (SSH / HTTPS)
# SSH
git clone git@github.com:jerichoBob/aidev-toolkit-dist-dist.git ~/.claude/aidev-toolkit
~/.claude/aidev-toolkit/scripts/install.sh
# HTTPS
git clone https://github.com/jerichoBob/aidev-toolkit-dist-dist.git ~/.claude/aidev-toolkit
~/.claude/aidev-toolkit/scripts/install.shWSL2 runs a full Linux kernel and is the recommended path for Windows users.
Prerequisites:
-
Install WSL2:
wsl --installin PowerShell (Admin) -
Inside WSL2, install dependencies:
sudo apt-get update && sudo apt-get install -y git jq # Install GitHub CLI type -p curl >/dev/null || sudo apt-get install -y curl curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \ | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg echo "deb [signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" \ | sudo tee /etc/apt/sources.list.d/github-cli.list sudo apt-get update && sudo apt-get install -y gh gh auth login
-
Then install aidev-toolkit (same one-liner as macOS):
gh repo clone jerichoBob/aidev-toolkit-dist-dist ~/.claude/aidev-toolkit ~/.claude/aidev-toolkit/scripts/install.sh
Git Bash has partial support. Symlink creation requires Developer Mode enabled in Windows Settings.
Prerequisites: Git for Windows, then in Git Bash:
winget install jqlang.jq # jq
winget install --id GitHub.cli # gh CLI (restart Git Bash after)
gh auth loginThen run the same installer. The install script will warn you about symlink requirements automatically.
macOS-only skills:
/screenshots,/browser-harness, and/gmail-digestrequire macOS (macOS screenshot paths, Google Chrome viaosascript). These skills will display a clear error message on Linux/Windows rather than silently failing.
The installer symlinks skills to ~/.claude/commands/ and ~/.claude/skills/ so they're available as slash commands in every Claude Code session.
To update:
/aid-update
Skills are organized into two tiers: core (daily drivers, shown by default in /aid) and extended (powerful when needed, available via /aid --all).
| Command | What it does |
|---|---|
/commit |
Group changes, write conventional commit messages, bump version |
/commit-push |
Same as /commit plus auto-push, tests, and dist publish |
/lint |
Lint and auto-fix markdown files |
/gmail-digest |
Scrape Gmail inbox and categorize unread emails by urgency |
/remember |
Save a note to persistent memory (project or user scope) |
| Command | What it does |
|---|---|
/inspect |
Analyze any codebase — identity, architecture, tech stack, patterns |
/arch-review |
Validate codebase against security, observability, and testing principles |
A full workflow for writing specs before code, tracking implementation phase by phase.
| Command | What it does |
|---|---|
/sdd-spec |
Create a new specification document from a description |
/sdd-specs |
Show all specs — status, staleness, progress summary |
/sdd-code |
Implement the next single task |
/sdd-code-spec |
Implement all remaining tasks in a spec end-to-end |
/sdd-init |
Scaffold a specs/ directory for a new project |
| Command | What it does |
|---|---|
/aid |
Show core commands (daily drivers) |
/aid-update |
Pull latest updates from GitHub |
/aid-feedback |
Submit feedback or feature requests |
Extended skills — available but not shown by default
Run /aid --all to see these in the terminal.
| Command | What it does |
|---|---|
/test-run |
Run the full test suite, save a timestamped report |
/test-status |
Show results table from the last test run |
/code-stats |
Count lines of code by language |
/should-i-trust-it |
Verify a skill file for malicious patterns before installing |
/browser-harness |
Direct Chrome CDP control — install, connect, and run browser tasks |
/screenshots |
Load recent macOS screenshots into Claude's context |
/aws-costs |
Show AWS spend by service, daily trend, and active resources |
/status-footer |
Configure the Claude Code status line (dir, branch, ctx%, etc.) |
/analyze-changes |
Analyze git changes and determine version bump type (support skill) |
/version-bump |
Bump version and update changelog (support skill) |
| Command | What it does |
|---|---|
/deal-desk |
Deal qualification and risk assessment from project documents |
/sdlc-plan |
Parse RFQ/RFP/PRD/SOW documents into a phased implementation plan |
| Command | What it does |
|---|---|
/sdd-next |
Show the next unimplemented task across all specs |
/sdd-next-phase |
Show all tasks in the current phase |
/sdd-code-phase |
Implement all tasks in the current phase |
/sdd-spec-prioritize |
Recommend top N specs to focus on next |
/sdd-spec-status |
Show phase-by-phase progress for a specific spec |
/sdd-spec-owner |
Set or unset spec owner |
/sdd-spec-tagging |
Commit tagging convention reference |
/sdd-specs-archive |
Move completed specs to specs/completed/ to declutter |
/sdd-specs-doctor |
Migrate spec files to YAML frontmatter format |
/sdd-specs-update |
Sync project with SDD infrastructure |
| Command | What it does |
|---|---|
/aid-login |
Authenticate via browser-based GitHub OAuth |
/docs-update |
Update README.md and CLAUDE.md |
Skills are markdown files. Each file contains frontmatter (name, description, allowed tools) and a set of instructions Claude follows when you invoke the command.
~/.claude/
├── commands/
│ ├── commit.md -> ../aidev-toolkit/skills/commit.md
│ ├── inspect.md -> ../aidev-toolkit/skills/inspect.md
│ └── ...
└── aidev-toolkit/ ← git clone of this repo
├── skills/ ← core skill files
└── modules/sdd/ ← Spec-Driven Development module
Because skills are just text files, they're readable, forkable, and customizable. You can modify any skill to change how it behaves, or create new ones. The install.sh script symlinks them so updates via /aid-update propagate instantly.
The /arch-review command evaluates codebases against these principles:
| ID | Principle | Focus |
|---|---|---|
| AP-001 | Security by Default | Input validation, secrets, auth, injection prevention |
| AP-002 | Observable Systems | Structured logging, correlation IDs, health endpoints |
| AP-003 | Intentional Error Handling | No silent failures, consistent error responses |
| AP-004 | Test Critical Paths | Critical path coverage, testable architecture |
Full definitions in architecture-principles/.
# Fresh reinstall (removes and reinstalls toolkit only — leaves CLAUDE.md, settings.json untouched)
~/.claude/aidev-toolkit/scripts/clean-install.sh
# Remove toolkit
~/.claude/aidev-toolkit/scripts/uninstall.sh0.73.0
- feat(arch): add AP-006 supply chain integrity and clarify security principle titles [
354bcb2]
- feat(specs): add spec-v74 (statusline version) and spec-v75 (toolkit explainer content) [
85e6f9f]
- feat(telemetry): implement v73 usage telemetry — local log + GitHub issue rollup [
ff11104]
- fix(gmail-digest): suppress chrome://inspect tab in non-interactive mode; clean traceback from error messages [
53e005f]
- fix(aid-feedback): exclude already-processed issues from ingestion [
89ed4fb] - feat(specs): add spec-v73 for usage telemetry [
d1ffed0]
- chore(commit-push): remove dist publish step — superseded by GitHub Actions CI [
ef74b76]
- chore(specs): archive 29 completed spec files to specs/completed/ [
8a5fe8e] - fix(ci): add gh auth setup-git for HTTPS push; track .markdownlint.json [
0c0e010]
- fix(ci): rewrite publish-dist workflow to use PAT + existing publish-dist.sh [
bf59e5f] - docs(specs): close v52 and v53 — add external test plan to v52, checkboxes to v53 [
358adb8]
- fix(install): configure statusLine to point at statusline.sh on install [
a724a05] - chore(specs): sync task counts and statuses in README [
1e956b2]
- feat(v68): arch-review cleanup — security sections for all active specs, integration tests for statusline.sh and uninstall.sh [
9d64461] - fix(uninstall): add skills/ symlink cleanup and
return 0to prevent set-e trap on quiet mode [9d64461] - fix(statusline): correct jq false-handling bug in enabled check [
9d64461]
- feat(status-footer): add health check, ctx% color legend, fix threshold doc (v71) [
a71c79f] - feat(claudemd): add NO EPHEMERAL SCRIPTS rule distribution via install.sh (v70) [
cf89f71] - feat(claudemd): add Surface Uncertainty principle to global template (v72) [
c517c60] - feat(specs): add spec-v68 — Arch Review Cleanup [
08463b6] - fix(sdd-specs-archive): resolve archive/display status mismatch (v69) [
72628e7] - fix(tile-image): sanitize tile dir name to remove spaces for Read tool compatibility [
a9101e9] - feat(screenshots): dynamic image tiling based on model resolution limits [
69a2d8f]
- feat(windows-support): implement v63 — cross-platform install, macOS guards, Windows docs [
488b0ad] - docs(claude): promote user-level rules into project CLAUDE.md [
c9e1f09]
- feat(skill-tiers): implement v65 — tier field, /aid core/extended view, README restructure [
e290773]
- fix(gmail-digest): complete v58 — fix stale daemon, correct arch docs [
4679105]
- docs(specs): add v66 /miro — CRUD Miro diagrams from Claude Code [
b683a81] - feat(gmail-digest): use dedicated Chrome on port 19512 for CDP [
9b2d6fd]
- feat(specs): add v64 Developer Amplifier and v65 Skill Tiers specs [
55f91f2] - docs(specs): add v64 and v65 entries and task checklists to specs/README.md [
877a3de] - chore: add VS Code multi-root workspace file [
af7c815] - docs(readme): update tagline to mention skills alongside slash commands [
338d81e] - fix(readme): add language specifiers to fenced code blocks (MD040) [
96cec79]
- feat(install): add markdownlint auto-fix PostToolUse hook for all users [
c5c6285]
- fix(sdd-specs): replace misleading completion % with actionable spec/task counts [
6f6fe12]
- docs(v62): rewrite README with value-first structure and workflow examples [
de9d08a] - docs(specs): add v62 readme-overhaul (complete) and v63 windows-support specs [
14a9597]
- feat(status-footer): add interactive numbered menu for toggling components [
fdb95ae]
- feat: add /status-footer skill and statusline.sh script [
7ceded9] - feat(commit-push): auto-run tests and dist-publish after push [
394d206]
- fix(gmail-digest): auto-open Chrome inspect page when CDP not reachable [
c47b080]
- feat: promote gmail-digest, test-run, test-status to toolkit skills [
61177e3]
- test(v58): remove vestigial ANTHROPIC_API_KEY test — script has no API dependency [
5c4ea6e]
- fix(v58): gmail-digest — normalize dedup keys to catch whitespace-variant duplicates [
701512f]
- fix(v58): gmail-digest — post-scrape date filter and deduplication [
0c7121f]
- feat(v58): gmail-digest --account email@domain — launch dedicated Chrome per profile [
7059dd2]
- fix(v58): account list reads Chrome Preferences files — shows all profiles instantly [
63acd78]
- fix(v58): account list stops on first non-inbox page — no email in title = break [
52b6a5c]
- feat(v58): gmail-digest — --days/--weeks range, --all read+unread, --account N/list [
fc1ed68]
- refactor(v58): gmail-digest pure scraper — remove anthropic dep, enrich skill output, clean tests [
1eb55dc]
- fix(v58): /gmail-digest skill needs no API key — scrape via dry-run, categorize inline [
e365525]
- test(v58): add gmail-digest integration test suite and update spec progress [
72ff9dc]
- feat(v58): add gmail-digest.py — daily inbox triage via Claude [
a9c3c68]
- feat(v61): split /test-run and /test-status — persistent timestamped reports [
efaeccc]
- feat(v60): complete test coverage phase 2 — all remaining scripts [
ec44623]
- feat(v32): add Xcode Info.plist validation tests; mark spec complete [
cb732b4] - feat(specs): add v60 — test coverage phase 2, remaining script tests [
3e43b68] - feat(test-status): add Coverage column sourced from test file comments [
963c4b1] - feat: add /test-status project skill to run test suite and display results [
cbb9393]
- feat(v59): integrate test coverage requirement into development methodology [
fda95f8] - feat(v59): add complete test suite with full coverage [
272bfee]
- feat: add /aid-login skill for GitHub OAuth authentication [
b950dff]
- feat(v52): mark GitHub OAuth auth spec complete [
58dc8ef]
- docs: fix markdown formatting in docs-update skill [
109df9d]
- feat(lint): support directory arguments with recursive glob expansion [
e1bd62f]
- fix(clean-install): require gh CLI, skip auth if already logged in [
94f1ff9]
- fix(install): require gh CLI, skip auth if already logged in [
6651cce] - fix(uninstall): remove invalid stderr redirect in for loop glob [
246d273]
- fix(install): prevent credential prompts on new install clone [
0caac95]
- feat(install): add browser-harness skill to install and fix lint [
9d489fd] - feat(specs): add v58 Gmail Morning Digest spec [
54fb15c]
- fix(publish-dist): prevent docs/docs/ duplication when copying directories [
357c2f8] - docs(statusline): update ctx:53% screenshot [
7bdd834]
- chore(lint): simplify markdownlint config and remove prettier pass [
1a45eda] - docs(statusline): replace screenshot with cleaner ctx:53% capture [
d11ea40] - docs(statusline): add context window impact explanation and color [
b0ad325] - docs(statusline): expand doc — config structure, JSON payload, full command breakdown [
79d6bee] - docs(sdd): add Validation Needed status — code done, tests blocked [
5b8431f]
- chore(specs): sync v52 OAuth auth spec — mark complete, README tasks in sync
- chore(specs): complete v57 install.sh email prompt spec verification
- feat(version-bump): add Xcode Info.plist variable detection and fix [
0c4b9bc] - feat(install): interactive email prompt for spec ownership [
dc337a4] - docs(sdd-template): add two-file model checkbox convention note [
e8fc2ac]
- fix(aid-feedback): use GitHub user identity for ingestion gate [
051aad1]
- feat(v55): security-first SDD — mandatory AuthZ/N and audit logging in every spec [
34744ba] - feat(v55): add Security-First SDD spec — AuthZ/N and audit logging baked into every spec [
3506632]
- feat: add /dist-publish project command for aidev-toolkit-dist publishing [
86f6a6d]
- feat(auth): complete v52 Phase 4–5 — install hint, aid-help auth docs, logout verified [
0e611a1]
- fix(specs-parse): sort status output numerically instead of lexicographically [
40f7a5b]
- docs(specs): mark v54 complete — numeric version sort verified [
4f695d3]
- fix(sdd-code-spec): remove disable-model-invocation to allow skill chaining [
8e8b37f]
- fix(sdd): use sort -V in specs-parse.sh for correct spec version ordering [
717c6bd] - fix(aid-feedback): bootstrap required labels before issue create or ingest [
d8ea5a5] - feat(specs): add v54 — specs-parse.sh numeric version sort [
d90924f]
- docs: add AWS costs report for 2026-04-19 [
1f8c2c9]
- feat: add /browser-harness skill for direct Chrome CDP control [
c30a5d3] - feat(aws-costs): enrich active resources with Project/Environment/Owner tags [
003aedc]
- feat(v52): GitHub OAuth auth — Cloudflare Worker, auth.sh CLI, JWT identity in user-email.sh [
8342a82] - style: markdownlint/prettier bulk reformat across all docs and skills [
92ce955]
- feat: add /aws-costs skill — spend by service, daily trend, active resources, multi-profile [
16e1bcd]
- feat: repo cleanup — remove dead Slack pipeline, stale dist/, personal files, scrub HSL refs [
fd52ced] - feat: add /remember skill — register in installer, --user/--project flags, help entry [
99aaab5] - feat: enhance /docs-update --deep — spec cross-reference, tech stack & path verification [
b6de1dd]
- feat: add pre-pull guard to /commit-push — silent skip on unstaged changes [
45b2996] - feat: add prettier prose-wrap pass and re-enable MD013 in /lint [
45b2996] - feat: scope Bash allowed-tools across 10 SDD skills; add allowed-tools-guide.md [
45b2996]
- docs: mark specs v28 and v43 complete — sdd-spec-status and sdd-init validation done [
ac13786] - docs: add specs v49-v51 — monetization, memory confidence tags, memory relationship index [
8619789]
- Initial project setup from PRD.md
- Add CLAUDE.md for Claude Code guidance
Copyright (c) 2025 Parallax Intelligence LLC. All rights reserved.