Update README with comprehensive documentation, sources, and acknowledgments
- Added all 40+ agents organized by category - Added MCP tools with source links - Added acknowledgments section crediting: - fcakyon/claude-codex-settings - nextlevelbuilder/ui-ux-pro-max-skill - iannuttall/ralph - zai-ai/mcp-server - anthropics/claude-code - Added model configuration examples - Added installation script descriptions - Enhanced formatting with badges and tables
This commit is contained in:
uroma
203
README.md
203
README.md
@@ -1,38 +1,199 @@
|
|||||||
# Claude Code Customization Suite
|
# Claude Code Customization Suite
|
||||||
|
|
||||||
40+ specialized AI agents, MCP tools, and enterprise-grade automation scripts for Claude Code.
|
> 40+ specialized AI agents, MCP tools, and enterprise-grade automation scripts for Claude Code.
|
||||||
|
|
||||||
## Quick Start
|
[](agents/)
|
||||||
|
[](#mcp-tools)
|
||||||
|
[](LICENSE)
|
||||||
|
|
||||||
|
## 🚀 Quick Start
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Download and run the interactive installer
|
# Clone the repository
|
||||||
curl -JO https://github.rommark.dev/rommark/claude-code-customization-suite/raw/main/interactive-install-claude.sh
|
git clone https://github.rommark.dev/admin/Enhance-Claude-Code-with-30--Agentic-Tools.git
|
||||||
|
cd Enhance-Claude-Code-with-30--Agentic-Tools
|
||||||
|
|
||||||
|
# Run the interactive installer
|
||||||
chmod +x interactive-install-claude.sh
|
chmod +x interactive-install-claude.sh
|
||||||
./interactive-install-claude.sh
|
./interactive-install-claude.sh
|
||||||
|
|
||||||
|
# Follow the prompts:
|
||||||
|
# ✅ Choose model (Anthropic/Z.AI)
|
||||||
|
# ✅ Select agent categories to install
|
||||||
|
# ✅ Configure MCP tools
|
||||||
|
# ✅ Enter your API key
|
||||||
|
# ✅ Launch Claude Code
|
||||||
```
|
```
|
||||||
|
|
||||||
## What's Included
|
## ✨ What's Included
|
||||||
|
|
||||||
- **40+ Custom Agents** across 8 categories
|
- **🤖 40+ Custom Agents** across 8 categories
|
||||||
- **15+ MCP Tools** for vision, search, and GitHub integration
|
- **🔧 15+ MCP Tools** for vision, search, and GitHub integration
|
||||||
- **Auto-Triggering** test writer and UI enhancement agents
|
- **⚡ Auto-Triggering** test writer and UI enhancement agents
|
||||||
- **Interactive Installation** with model selection (Anthropic/Z.AI)
|
- **🎛️ Interactive Installation** with model selection (Anthropic/Z.AI)
|
||||||
- **One-Click Setup** with comprehensive verification
|
- **🛡️ One-Click Setup** with comprehensive verification
|
||||||
|
|
||||||
## Installation Scripts
|
## 📦 Installation Scripts
|
||||||
|
|
||||||
- `interactive-install-claude.sh` - Full interactive installer (recommended)
|
| Script | Description | Size |
|
||||||
- `claude-setup-manager.sh` - Menu-driven setup manager
|
|--------|-------------|------|
|
||||||
- `create-complete-package.sh` - Create distributable packages
|
| `interactive-install-claude.sh` | Full interactive installer (recommended) | 33KB |
|
||||||
- `verify-claude-setup.sh` - Verify your installation
|
| `claude-setup-manager.sh` | Menu-driven setup manager | 11KB |
|
||||||
- `export-claude-customizations.sh` - Export existing customizations
|
| `create-complete-package.sh` | Create distributable packages | 16KB |
|
||||||
|
| `verify-claude-setup.sh` | Verify your installation | 9KB |
|
||||||
|
| `export-claude-customizations.sh` | Export existing customizations | 6.5KB |
|
||||||
|
|
||||||
## Documentation
|
## 🤖 Agent Categories
|
||||||
|
|
||||||
- `CLAUDE-CUSTOMIZATIONS-README.md` - Complete feature documentation
|
### Engineering (7 agents)
|
||||||
- `FINAL-SETUP-GUIDE.md` - Detailed setup instructions
|
- **AI Engineer** - ML & LLM integration, prompt engineering
|
||||||
- `SCRIPTS-GUIDE.md` - Script usage guide
|
- **Backend Architect** - API design, database architecture, microservices
|
||||||
|
- **DevOps Automator** - CI/CD pipelines, infrastructure as code
|
||||||
|
- **Frontend Developer** - React/Vue/Angular, responsive design
|
||||||
|
- **Mobile Builder** - iOS/Android React Native apps
|
||||||
|
- **Rapid Prototyper** - Quick MVPs in 6-day cycles
|
||||||
|
- **Test Writer/Fixer** - Auto-write and fix tests
|
||||||
|
|
||||||
## License
|
### Marketing (7 agents)
|
||||||
|
- **TikTok Strategist** - Viral TikTok marketing strategies
|
||||||
|
- **Growth Hacker** - Growth strategies and user acquisition
|
||||||
|
- **Content Creator** - Multi-platform content creation
|
||||||
|
- **Instagram Curator** - Instagram strategy and engagement
|
||||||
|
- **Reddit Builder** - Reddit community building
|
||||||
|
- **Twitter Engager** - Twitter strategy and tactics
|
||||||
|
- **App Store Optimizer** - ASO optimization
|
||||||
|
|
||||||
|
### Product (3 agents)
|
||||||
|
- **Feedback Synthesizer** - User feedback analysis
|
||||||
|
- **Sprint Prioritizer** - 6-day sprint planning
|
||||||
|
- **Trend Researcher** - Market trend analysis
|
||||||
|
|
||||||
|
### Project Management (3 agents)
|
||||||
|
- **Experiment Tracker** - A/B test tracking
|
||||||
|
- **Project Shipper** - Launch coordination
|
||||||
|
- **Studio Producer** - Team workflow optimization
|
||||||
|
|
||||||
|
### Studio Operations (5 agents)
|
||||||
|
- **Analytics Reporter** - Data analysis and reporting
|
||||||
|
- **Finance Tracker** - Financial tracking
|
||||||
|
- **Infrastructure Maintainer** - Infrastructure management
|
||||||
|
- **Legal Compliance Checker** - Compliance checks
|
||||||
|
- **Support Responder** - Customer support automation
|
||||||
|
|
||||||
|
### Testing (5 agents)
|
||||||
|
- **API Tester** - API testing
|
||||||
|
- **Performance Benchmarker** - Performance testing
|
||||||
|
- **Test Results Analyzer** - Test analysis
|
||||||
|
- **Tool Evaluator** - Tool evaluation
|
||||||
|
- **Workflow Optimizer** - Workflow optimization
|
||||||
|
|
||||||
|
### Design (5 agents)
|
||||||
|
- **Brand Guardian** - Brand consistency
|
||||||
|
- **UI Designer** - UI design and implementation
|
||||||
|
- **UX Researcher** - User experience research
|
||||||
|
- **Visual Storyteller** - Visual communication
|
||||||
|
- **Whimsy Injector** - Delightful UI enhancements
|
||||||
|
|
||||||
|
### Bonus (2 agents)
|
||||||
|
- **Joker** - Humor and team morale
|
||||||
|
- **Studio Coach** - Team coaching and motivation
|
||||||
|
|
||||||
|
## 🔧 MCP Tools
|
||||||
|
|
||||||
|
### Vision Tools (8 tools)
|
||||||
|
| Tool | Function | Input |
|
||||||
|
|------|----------|-------|
|
||||||
|
| `analyze_image` | General image analysis | PNG, JPG, JPEG |
|
||||||
|
| `analyze_video` | Video content analysis | MP4, MOV, M4V |
|
||||||
|
| `ui_to_artifact` | UI screenshot to code | Screenshots |
|
||||||
|
| `extract_text` | OCR text extraction | Any image |
|
||||||
|
| `diagnose_error` | Error screenshot diagnosis | Error screenshots |
|
||||||
|
| `ui_diff_check` | Compare UI screenshots | Before/after |
|
||||||
|
| `analyze_data_viz` | Data visualization insights | Dashboards, charts |
|
||||||
|
| `understand_diagram` | Technical diagram analysis | UML, flowcharts |
|
||||||
|
|
||||||
|
### Web & GitHub Tools
|
||||||
|
| Tool | Function | Source |
|
||||||
|
|------|----------|--------|
|
||||||
|
| `web-search-prime` | AI-optimized web search | [claude-codex-settings](https://github.com/fcakyon/claude-codex-settings) |
|
||||||
|
| `web-reader` | Web page to markdown conversion | [claude-codex-settings](https://github.com/fcakyon/claude-codex-settings) |
|
||||||
|
| `zread` | GitHub repository reader | [claude-codex-settings](https://github.com/fcakyon/claude-codex-settings) |
|
||||||
|
| `@z_ai/mcp-server` | Vision and analysis tools | [@z_ai/mcp-server](https://github.com/zai-ai/mcp-server) |
|
||||||
|
| `@z_ai/coding-helper` | Web and GitHub integration | [@z_ai/mcp-server](https://github.com/zai-ai/mcp-server) |
|
||||||
|
|
||||||
|
## 📊 Model Configuration
|
||||||
|
|
||||||
|
### Option 1: Anthropic Claude (Official)
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"env": {
|
||||||
|
"ANTHROPIC_AUTH_TOKEN": "your-anthropic-api-key",
|
||||||
|
"ANTHROPIC_BASE_URL": "https://api.anthropic.com"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Option 2: Z.AI / GLM Coding Plan
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"env": {
|
||||||
|
"ANTHROPIC_AUTH_TOKEN": "your-zai-api-key",
|
||||||
|
"ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
> **Note:** Z.AI offers compatible Claude models at lower costs, perfect for development and testing.
|
||||||
|
|
||||||
|
## 📚 Documentation
|
||||||
|
|
||||||
|
- **[CLAUDE-CUSTOMIZATIONS-README.md](CLAUDE-CUSTOMIZATIONS-README.md)** - Complete feature documentation
|
||||||
|
- **[FINAL-SETUP-GUIDE.md](FINAL-SETUP-GUIDE.md)** - Detailed setup instructions
|
||||||
|
- **[SCRIPTS-GUIDE.md](SCRIPTS-GUIDE.md)** - Script usage guide
|
||||||
|
|
||||||
|
## 🙏 Acknowledgments & Sources
|
||||||
|
|
||||||
|
This customization suite is built upon excellent open-source projects and community contributions.
|
||||||
|
|
||||||
|
### Core Inspiration
|
||||||
|
|
||||||
|
- **[claude-codex-settings](https://github.com/fcakyon/claude-codex-settings)** by [fcakyon](https://github.com/fcakyon)
|
||||||
|
- Comprehensive Claude Code settings and MCP configurations
|
||||||
|
- Foundation for MCP tool integration patterns
|
||||||
|
|
||||||
|
- **[ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)** by [nextlevelbuilder](https://github.com/nextlevelbuilder)
|
||||||
|
- Professional UI/UX design patterns and agent behaviors
|
||||||
|
- Inspired design-focused agents and whimsy-injector
|
||||||
|
|
||||||
|
- **[Ralph](https://github.com/iannuttall/ralph)** by [iannuttall](https://github.com/iannuttall)
|
||||||
|
- AI assistant framework and agent patterns
|
||||||
|
- Inspired multi-agent coordination and studio operations workflows
|
||||||
|
|
||||||
|
### MCP Tool Sources
|
||||||
|
|
||||||
|
- **[@z_ai/mcp-server](https://github.com/zai-ai/mcp-server)** - Vision analysis, OCR, UI comparison, video analysis, and diagram understanding
|
||||||
|
- **[Model Context Protocol](https://github.com/modelcontextprotocol)** - Open standard for connecting AI models to tools
|
||||||
|
- **[Claude Code](https://github.com/anthropics/claude-code)** - Official Claude Code CLI by Anthropic
|
||||||
|
|
||||||
|
### Agent Architecture
|
||||||
|
|
||||||
|
- **6-Day Development Cycle** - Inspired by rapid iteration methodologies and startup best practices
|
||||||
|
- **Studio Operations** - Professional studio management patterns applied to software development
|
||||||
|
- **Auto-Triggering Agents** - Proactive agent invocation patterns for test writing and UI enhancement
|
||||||
|
|
||||||
|
## 🤝 Community & Contributing
|
||||||
|
|
||||||
|
This suite is **100% open source** and available on [GitHub](https://github.rommark.dev/admin/Enhance-Claude-Code-with-30--Agentic-Tools).
|
||||||
|
|
||||||
|
- ⭐ Star the repo
|
||||||
|
- 🐛 Report issues
|
||||||
|
- 🔄 Submit pull requests
|
||||||
|
- 💡 Contribute your own agents!
|
||||||
|
|
||||||
|
## 📝 License
|
||||||
|
|
||||||
MIT License - Feel free to use and modify for your needs.
|
MIT License - Feel free to use and modify for your needs.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Built for developers who ship.** 🚀
|
||||||
|
|||||||
Reference in New Issue
Block a user