Claude Toolbox 🧰

A collection of Claude Code agents, commands, scripts, templates, notes, and other bits and bobs.

🤖 Specialized Agents

Agent	Description
Adult Learning Theory Expert	Specializes in educational methodologies and adult learning principles for technical documentation and training materials.
Agent Creator	Helps design and build new specialized agents with appropriate expertise and capabilities.
Bash Automation Expert	Provides guidance on shell scripting, automation workflows, and command-line tool development.
Blooms Taxonomy Expert	Applies educational taxonomy frameworks to structure learning objectives and content organization.
Changelog Manager	Assists with version control documentation, release notes, and change tracking.
Changelog Master	Advanced changelog creation and management with best practices and automation strategies.
Claude MD Compliance Checker	Ensures documentation follows Claude's markdown formatting and compliance requirements.
CLI Developer	Specializes in command-line interface design, user experience, and tool development.
Code Quality Pragmatist	Balances code quality standards with practical development constraints and team productivity.
Design Thinking Expert	Applies human-centered design methodologies to software architecture and user experience.
Docs Dependency Manager	Manages documentation dependencies, cross-references, and content relationships.
File Topic Analyzer	Analyzes file content to identify topics, themes, and content organization opportunities.
Git Workflow Manager	Provides guidance on Git workflows, branching strategies, and repository management.
Knowledge Synthesizer	Combines information from multiple sources to create comprehensive, coherent documentation.
Lateral Thinking Expert	Applies creative problem-solving approaches to technical challenges and system design.
Paul Elder Framework Expert	Uses critical thinking frameworks to analyze problems and evaluate solutions.
Python Engineer	Specializes in Python development, best practices, and code architecture.
Readme Expert	Creates comprehensive, user-friendly README files and project documentation.
Simplex Thinking Expert	Applies systematic problem-solving methodologies to complex technical challenges.
Software Architect	Provides guidance on system design, architecture patterns, and technical decision-making.
TypeScript Engineer	Specializes in TypeScript development, type systems, and modern JavaScript practices.
Ultrathink Debugger	Advanced debugging methodologies and systematic problem-solving approaches.

💬 Custom Commands

Command	Description
Analyze Repo Changes Update Docs	Analyzes repository changes and automatically updates relevant documentation.
Create Agent	Generates new specialized agent files with appropriate structure and capabilities.
Create Bash Script	Creates shell scripts with proper error handling, documentation, and best practices.
Create Command	Generates new command files with standardized structure and functionality.
Create Prompt	Creates prompt templates for consistent AI interactions and workflows.
Create Python Script	Generates Python scripts with proper structure, error handling, and documentation.
Enhance	Improves existing content by applying best practices and optimization techniques.
Extract Essential Information	Pulls key information from content to create summaries and highlights.
Extract Examples	Identifies and extracts code examples and usage patterns from documentation.
Folder Readme	Generates README files for folders to improve navigation and understanding.
Generate Readme	Creates comprehensive README files for projects and repositories.
Git Repo Info	Extracts and displays repository information and statistics.
Improve Command	Enhances existing commands with better functionality and user experience.
Update Agent	Updates agent files with new capabilities or improved functionality.
Update Command	Modifies existing commands to add features or fix issues.
Update Script	Updates script files with improvements and bug fixes.

🧩 Templates

Template	Description
Agent	Comprehensive framework for building specialized agents with consistent structure and capabilities.

🤝 Contributing

The Claude Toolbox thrives through community contributions that expand its capabilities and refine existing features. Every contribution, whether a major feature or minor documentation improvement, strengthens the ecosystem for all users. Contributors bring diverse perspectives and use cases that enrich the toolbox beyond what any individual could envision.

Ways to Contribute

Multiple avenues exist for contributing to the toolbox, each valuable in its own right. Technical contributions might involve creating new agents or enhancing commands, while non-technical improvements could focus on documentation clarity or example scenarios. The variety of contribution types ensures everyone can participate regardless of their specific expertise.

New Agents: Add specialized expertise for new domains.
Command Improvements: Enhance existing commands or create new ones.
Documentation: Improve guides and examples.
Bug Fixes: Report and fix issues.
Best Practices: Share your successful patterns.

Contribution Process

A structured contribution process ensures quality while minimizing friction for contributors. Clear steps guide contributors from initial idea through successful integration, with checkpoints that maintain toolbox standards. This process balances thoroughness with efficiency, welcoming new contributions while preserving existing functionality.

Fork the repository.
Create a feature branch (git checkout -b feature/amazing-agent).
Follow the template structure for new additions.
Test your changes thoroughly.
Submit a pull request with clear description.

🛠️ Installation Options

Setting up the Claude Toolbox requires minimal configuration, with multiple installation paths available to suit different preferences. Automated installation handles most setup tasks, while manual installation provides complete control over the process. Both approaches result in the same functional configuration, differing only in the level of user involvement required.

# Clone and set up
git clone https://github.com/your-username/claude-toolbox.git
cd claude-toolbox
./scripts/install.sh  # Coming soon

Manual Installation

For those preferring direct control over installation, manual setup involves creating the necessary directory structure and copying components into place. This approach allows selective installation of specific components or custom directory locations. The process remains straightforward despite being manual, requiring only basic file system operations.

# Create Claude configuration directories
mkdir -p ~/.claude/{agents,commands,templates}

# Copy components
cp -r agents/* ~/.claude/agents/
cp -r commands/* ~/.claude/commands/
cp -r templates/* ~/.claude/templates/

💡 Tips & Tricks

Effective toolbox usage patterns emerge through experience, though certain principles accelerate mastery. Understanding when agents activate automatically versus requiring explicit invocation prevents unnecessary specification. Similarly, recognizing repetitive patterns that benefit from command automation transforms workflows from reactive to proactive.

Let Agents Auto-Engage: Don't specify agents manually since they activate when needed.
Use Commands for Repetition: If you do something twice, there's probably a command for it.
Combine Tools: Chain commands and agents for powerful workflows.
Trust the Expertise: Agents use proven methodologies worth following their guidance.
Customize for Your Needs: Create agents for your specific domain or tech stack.

Common Patterns

Real-world usage patterns demonstrate the toolbox's versatility across different development scenarios. Morning workflows might combine repository analysis with change review, while feature development engages multiple agents collaborating seamlessly. These patterns showcase how individual tools compose into comprehensive solutions that address complex development challenges efficiently.

# Morning workflow
claude "/git-repo-info && Review yesterday's changes"

# Feature development
claude "Implement user authentication" # Multiple agents collaborate

# Code review preparation
claude "/enhance ./src && /folder-readme ./src"

# Quick fixes
claude "Debug this TypeScript error" # Ultrathink debugger engages

Built with ❤️ by noobs, for noobs.

armstrongl/claude-toolbox