Custom commands toolkit for Claude Code - streamline your development workflow
npm install @paulduvall/claude-dev-toolkitTransform Claude Code into a complete development platform with 58 AI-powered custom commands that automate your entire software development workflow.
``bashInstall globally via NPM
npm install -g @paulduvall/claude-dev-toolkit
📦 What's Included
- 13 Active Commands: Production-ready commands for immediate use
- 45 Experimental Commands: Cutting-edge features for early adopters
- Security Hooks: Automated security validation and governance
- Configuration Templates: Pre-configured settings for different workflows
- Interactive Setup Wizard: Guided installation with customization options
- JavaScript Test Suite: 100% test coverage with 10 comprehensive test suites
🎯 Quick Start
$3
bash
npm install -g @paulduvall/claude-dev-toolkit
Interactive setup wizard runs automatically
`$3
bash
Install specific command sets
claude-commands install --active # Install 13 production commands
claude-commands install --experiments # Install 45 experimental commands
claude-commands install --all # Install all 58 commands
`$3
bash
claude-commands list # See all available commands
claude-commands status # Check installation status
claude-commands oidc --help # Configure GitHub Actions OIDC with AWS
`📋 Available Commands
$3
- - Smart test runner with coverage analysis
- /xquality - Code quality checks (format, lint, type-check)
- /xgit - Automated git workflow with AI-generated commits
- /xdebug - AI-powered debugging assistant$3
- /xsecurity - Comprehensive vulnerability scanning
- /xrefactor - Intelligent code refactoring and smell detection$3
- /xarchitecture - System design and architecture analysis
- /xspec - Requirements and specification generation
- /xdocs - Documentation generation and maintenance$3
- /xpipeline - CI/CD pipeline optimization
- /xrelease - Release management automation
- /xconfig - Configuration management
- /xtdd - Test-driven development automation$3
Advanced commands for specialized workflows:
- Planning & Analytics: /xplanning, /xanalytics, /xmetrics
- Infrastructure: , /xmonitoring, /xaws
- Compliance: , /xgovernance, /xpolicy
- Advanced Security: , /xrisk, /xscan
- Performance: , /xoptimize🛠️ CLI Usage
bash
Management Commands
claude-commands list # List all available commands
claude-commands status # Show installation status
claude-commands install --active # Install production commands
claude-commands install --experiments # Install experimental commands
claude-commands install --all # Install all commandsConfiguration Management
claude-commands config --list # List available templates
claude-commands config --template # Apply configuration template
claude-commands config --help # Show config command helpOIDC Configuration (NEW)
claude-commands oidc --help # Show OIDC configuration options
claude-commands oidc --dry-run # Preview OIDC setup actions
claude-commands oidc --region us-west-2 --stack-name my-oidc # Configure AWS OIDCSubagents Management
claude-commands subagents --list # List available subagents
claude-commands subagents --install # Install subagents to Claude Code
claude-commands subagents --help # Show subagents command helpIn Claude Code
/xhelp # Show command help
/xtest # Run intelligent test suite
/xquality fix # Auto-fix code quality issues
/xsecurity --scan --report # Comprehensive security scan
/xgit # Automated git workflow
`🔧 Configuration
$3
Use the built-in config command to manage Claude Code settings:
bash
List available configuration templates
claude-commands config --listApply a specific template
claude-commands config --template basic-settings.json
claude-commands config --template security-focused-settings.json
claude-commands config --template comprehensive-settings.jsonShow help for config command
claude-commands config --help
`$3
- Commands: and ~/.claude/commands/experiments/
- Configuration:
- Security Hooks:
- Templates: Bundled with package installation$3
The package includes three pre-configured templates:1. Basic (
): Minimal setup for command functionality
2. Security-Focused (security-focused-settings.json): Enhanced security with hooks
3. Comprehensive (comprehensive-settings.json): Full feature set with governanceTemplates are applied via the config command with automatic backup of existing settings.
🧪 Development & Testing
$3
`bash
Run all test suites (100% coverage)
npm testRun specific test suites
npm run test:commands # Command validation
npm run test:workflow # Core workflow tests
npm run test:security # Security command tests
npm run test:config # Configuration command tests
npm run test:subagents # Subagents CLI command tests
npm run test:req007 # Interactive setup wizard
npm run test:req009 # Configuration templates
npm run test:req018 # Security hook installationValidation and linting
npm run validate # Package validation
npm run lint # Code linting
`$3
- 10 Test Suites: 100% passing
- Command Validation: All 58 commands validated
- Security Tests: Comprehensive security pattern validation
- Integration Tests: End-to-end workflow testing
- Configuration Tests: Template and setup validation$3
- Self-Contained Package: No dependencies on repository cloning
- JavaScript-Based: Native Node.js integration with comprehensive testing
- Modular Design: Separate installer, config, and validation modules
- Cross-Platform: Works on macOS, Linux, and Windows🔒 Security Features
$3
- Credential Protection: Prevents exposure of API keys and secrets
- File Operation Logging: Audits all AI-generated file changes
- Governance Integration: Policy enforcement and compliance checking$3
- : Vulnerability scanning and dependency auditing
- /xred: Defensive security testing (experimental)
- /xcompliance: Automated compliance checking (experimental)🚨 Troubleshooting
$3
`bash
Commands not recognized?
claude-commands status # Check installation
claude-commands install --active # Reinstall commandsPermission errors?
chmod 755 ~/.claude/commands/*.md # Fix permissionsMissing experimental commands?
claude-commands install --experiments # Install experimental setTest failures?
npm test # Run full test suite
npm run validate # Validate package
`$3
bash
Package validation
npm run validate # Package structure validation
npm test # Comprehensive test suiteCLI validation
claude-commands verify # Complete setup verification
claude-commands list # Check installed commands
`📚 Documentation
$3
- Main Repository: Claude Code Custom Commands
- Command Reference: claude-custom-commands.md
- Security Hooks: claude-code-hooks-system.md$3
Every command includes built-in help:
bash
/xtest help # Show all testing options
/xquality help # Show quality check options
/xsecurity help # Show security scanning options
/xconfig help # Show configuration options
`🤝 Contributing
$3
bash
Clone main repository
git clone https://github.com/PaulDuvall/claude-code.git
cd claude-codeNPM package is located in claude-dev-toolkit/
cd claude-dev-toolkit
npm install
npm test
`$3
1. Create command files in repository or slash-commands/experiments/
2. Commands are included in NPM package through build process
3. Validate with
4. Follow existing patterns and security guidelines$3
- All changes must pass 100% of tests before merging
- JavaScript test suite provides comprehensive validation
- Security-first development - only defensive tools allowed🔄 Recent Updates
$3
- ✅ NEW: OIDC Command: GitHub Actions to AWS OIDC integration ()
- ✅ TDD Implementation: Phase 1 foundation with comprehensive test coverage (14/14 tests)
- ✅ CLI Integration: Full command-line interface with help, dry-run, and configuration options
- ✅ Error Framework: Enhanced error handling with context-aware recovery suggestions
- ✅ Dependency Validation: AWS CLI, Git, and GitHub CLI availability checking$3
- ✅ Documentation Consistency: Fixed command counts (58) and subagent counts (26)
- ✅ Test Infrastructure: Enhanced test-results directory handling
- ✅ Repository Cleanup: Removed outdated documentation and test artifacts
- ✅ Validation Logic: Improved scenario-aware test validation
- ✅ Version Alignment: Synchronized all version references$3
- ✅ NPM Scoped Package: Published as @paulduvall/claude-dev-toolkit
- ✅ Configuration Command: Built-in MIT © Paul Duvall
Built for the Claude Code community to accelerate AI-powered development workflows.
---
Ready to transform your development workflow? Install now and experience AI-powered automation for testing, security, quality, and deployment.