ai-toolkit
by softspark
Professional-grade AI coding toolkit: 94 skills, 44 agents, multi-platform (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, Antigravity, Codex CLI, opencode).
136stars
16forks
Python
Added 4/18/2026
AI Agentsai-agentsai-skillsanthropicclaudeclaude-codeclinecodexcopilotcursorgeminimcpopencodetoolkitwindsurf
Installation
# Add to your Claude Code skills
git clone https://github.com/softspark/ai-toolkitai-toolkit
Professional-grade AI coding toolkit with multi-platform support. Machine-enforced safety, 99 skills, 44 agents, expanded lifecycle hooks, persona presets, experimental opt-in plugin packs, and benchmark tooling — works with Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, Google Antigravity, Codex CLI, and opencode, ready in 60 seconds.
What's New in v2.7.3
llms.txt+llms-full.txtregenerated after PR #7 (Medplum/FHIR rules) — catalogs now listmedplum-docs-map.mdand the language-rules reference advertises the correct counts:14 languages / 73 rule files(was13 / 68).
See CHANGELOG.md for full history.
Table of Contents
- Install
- Platform Support
- What You Get
- Architecture
- Key Features
- Key Slash Commands
- Getting Started
- Documentation
- Contributing
Install
# Option A: install globally (once per machine)
npm install -g @softspark/ai-toolkit
ai-toolkit install
# Option B: try without installing (npx)
npx @softspark/ai-toolkit install
That's it. Claude Code picks up 99 skills, 44 agents, quality hooks, and the safety constitution automatically.
Update
npm install -g @softspark/ai-toolkit@latest && ai-toolkit update
Per-Project Setup
cd your-project/
ai-toolkit install --local # Claude Code only
ai-toolkit install --local --editors all # + all editors
ai-toolkit install --local --editors cursor,aider # + specific editors
ai-toolkit update --local # auto-detects editors
Plugin Management
ai-toolkit plugin list # show available packs
ai-toolkit plugin install --editor all --all # install all for Claude + Codex
ai-toolkit plugin status --editor all # show what's installed
Install Profiles
ai-toolkit install --profile minimal # agents + skills only
ai-toolkit install --profile standard # full install (default)
ai-toolkit install --profile strict # full + git hooks
Verify & Repair
ai-toolkit validate # check integrity
ai-toolkit doctor --fix # auto-repair
See CLI Reference for all commands and options.
Platform Support
| Platform | Config Files | Scope |
|----------|-------------|-------|
| Claude Code | ~/.claude/ | global |
| Cursor | ~/.cursor/rules + .cursor/rules/*.mdc | global + project |
| Windsurf | ~/.codeium/.../global_rules.md + .windsurf/rules/*.md | global + project |
| Gemini CLI | ~/.gemini/GEMINI.md | global |
| GitHub Copilot | .github/copilot-instructions.md | project |
| Cline | .clinerules/*.md | project |
| Roo Code | .roomodes + .roo/rules/*.md | project |
| Aider | .aider.conf.yml + CONVENTIONS.md | project |
| Augment | .augment/rules/ai-toolkit-*.md | project |
| Google Antigravity | .agent/rules/*.md + .agent/workflows/*.md | project |
| Codex CLI | AGENTS.md + .agents/rules/*.md + .agents/skills/* + .codex/hooks.json | project + global plugin |
| opencode | AGENTS.md + .opencode/{agents,commands,plugins}/* + opencode.json | project + global (~/.config/opencode/) |
Claude Code is always installed (primary platform). Other editors on demand with
--editors. All platforms receive the same agent/skill catalog, guidelines, and registered custom rules.
What You Get
| Component | Count | Description |
|-----------|-------|-------------|
| skills/ (task) | 32 | Slash commands: /commit, /build, /deploy, /test, /mcp-builder, ... |
| skills/ (hybrid) | 31 | Slash commands with agent knowledge base |
| skills/ (knowledge) | 36 | Domain knowledge auto-loaded by agents |
| agents/ | 44 | Specialized agents across 10 categories |
| hooks/ | 21 global + 5 skill-scoped | Quality gates, path safety, prompt governance, session lifecycle |
| plugins/ | 11 packs | Opt-in domain bundles (security, research, frontend, enterprise, 6 language packs) |
| constitution.md | 5 articles | Machine-enforced safety rules |
| rules/ | auto-injected | Language-specific and custom rules injected into your configs |
| kb/ | reference docs | Architecture, procedures, and best practices |
Architecture
ai-toolkit/
├── app/
│ ├── agents/ # 44 agent definitions
│ ├── skills/ # 99 skills (task / hybrid / knowledge)
│ ├── rules/ # Auto-injected into your CLAUDE.md
│ ├── hooks/ # Hook scripts (21 entries, 12 lifecycle events)
│ ├── plugins/ # 11 experimental plugin packs (opt-in)
│ ├── output-styles/ # System prompt output style overrides
│ ├── constitution.md # 5 immutable safety articles
│ └── ARCHITECTURE.md # Full system design
├── kb/ # Reference docs, procedures, plans
├── scripts/ # Validation, install, evaluation scripts
├── tests/ # Bats test suite (666 tests)
└── CHANGELOG.md
Distribution: Symlink-based for agents/skills, copy-based for hooks. Run ai-toolkit update after npm install — all projects pick up changes instantly. See Distribution Model.
Key Features
Machine-enforced constitution — 5-article safety constitution enforced via PreToolUse hooks that actually block rm -rf, DROP TABLE, and irreversible operations. Not just documentation.
21 lifecycle hooks — Executable scripts across 12 events (SessionStart → SessionEnd). Guards, governance, quality gates, session persistence, MCP health checks. See Hooks Catalog.
Security scanning — /skill-audit for code-level risks, /cve-scan for dependency CVEs. Both CI-ready with exit codes.
Iron Law enforcement — /tdd, debugging-tactics, and verification-before-completion enforce non-negotiable gates with anti-rationalization tables. 15 skills total include rationalization resistance.
Multi-language quality gates — Stop hook runs lint + type checks across Python, TypeScript, PHP, Dart, Go after every response.
Agent verification checklists — 10 agents include exit criteria that must be met before presenting results.
Two-stage review — /subagent-development runs Implementer → Spec Review → Quality Review per task.
Persistent memory — memory-pack plugin: SQLite + FTS5 search across past sessions.
Persona presets — 4 roles (backend-lead, frontend-lead, devops-eng, junior-dev) adjust style and priorities.
Config inheritance — Enterprise extends system with constitution immutability and enforcement constraints. See Enterprise Config Guide.
68 language rules — 13 languages, 5 categories each. Auto-detected or explicit --lang. See Language Rules.
26 MCP templates — Ready-to-use configs for GitHub, PostgreSQL, Slack, Jira, Sentry, and more. See MCP Templates.
See Unique Features for detailed descriptions of all differentiators.
Key Slash Commands
| Command | Purpose | Effort |
|---------|---------|--------|
| /workflow <type> | Pre-defined multi-agent workflow (15 types) | max |
| /orchestrate | Custom multi-agent coordination (3–6 agents) | max |
| /swarm | Parallel Agent Teams: map-reduce, consensus, relay | max |
| /plan | Implementation plan with task breakdown | high |
| /review | Code review: quality, security, performance | high |
| /debug | Systematic debugging with diagnostics | medium |
| /refactor | Safe refactoring with pattern analysis | high |
| /tdd | Test-driven development with red-green-refactor | high |
| /commit | Structured commit with linting | medium |
| /pr | Pull request with generated checklist | medium |
| /docs | Generate README, API docs, architecture notes | high |
| /explore | Interactive codebase visualization | medium |
| /write-a-prd | Create PRD through interactive interview | high |
| /prd-to-plan | Convert PRD into vertical-slice implementation plan | high |
| /design-an-interface | Generate 3+ radically different interface designs | high |
| /grill-me | Stress-test a plan through Socratic questioning | medium |
| /triage-issue | Triage bug with deep investigation and TDD fix plan | high |
| /architecture-audit | Discover shallow modules, propose refactors | high |
| /council | 4-perspective decision evaluation | high |
| /cve-scan | Scan dependencies for known CVEs | medium |
| /skill-audit | Scan skills/agents for security risks | medium |
| /repeat | Autonomous loop with safety controls | medium |
| /persona | Switch engineering persona at runtime | low |
/workflow Types
feature-development backend-feature frontend-feature
api-design database-evolution test-coverage
security-audit codebase-onboarding spike
debugging incident-response performance-optimization
infrastructure-change application-deploy proactive-troubleshooting
Multi-Agent Skill Selection
Need multi-agent coordination?
├── Know your domains? → /orchestrate (ad-hoc, 3-6 agents)
├── Have a known pattern? → /workflow <type> (15 tem
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
184,501
56,900
TypeScript
MCP Serversaiapis
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
159,797
24,845
JavaScript
AI Agentsai-agentsanthropic
An open-source AI agent that brings the power of Gemini directly into your terminal.
101,621
13,197
TypeScript
AI Agentsaiai-agents
An AI SKILL that provide design intelligence for building professional UI/UX multiple platforms
67,147
6,829
Python
CLI Toolsai-skillsantigravity