From 10019cb6f558e2eddb1a34682d70cf4dbd0d8ae8 Mon Sep 17 00:00:00 2001 From: uroma Date: Thu, 15 Jan 2026 14:04:54 +0000 Subject: [PATCH] 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 --- README.md | 203 ++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 182 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 858f8d0..70980a6 100644 --- a/README.md +++ b/README.md @@ -1,38 +1,199 @@ # 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](https://img.shields.io/badge/Agents-40+-purple)](agents/) +[![MCP Tools](https://img.shields.io/badge/MCP_Tools-15+-blue)](#mcp-tools) +[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE) + +## 🚀 Quick Start ```bash -# Download and run the interactive installer -curl -JO https://github.rommark.dev/rommark/claude-code-customization-suite/raw/main/interactive-install-claude.sh +# Clone the repository +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 ./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 -- **15+ MCP Tools** for vision, search, and GitHub integration -- **Auto-Triggering** test writer and UI enhancement agents -- **Interactive Installation** with model selection (Anthropic/Z.AI) -- **One-Click Setup** with comprehensive verification +- **🤖 40+ Custom Agents** across 8 categories +- **🔧 15+ MCP Tools** for vision, search, and GitHub integration +- **⚡ Auto-Triggering** test writer and UI enhancement agents +- **🎛️ Interactive Installation** with model selection (Anthropic/Z.AI) +- **🛡️ One-Click Setup** with comprehensive verification -## Installation Scripts +## 📦 Installation Scripts -- `interactive-install-claude.sh` - Full interactive installer (recommended) -- `claude-setup-manager.sh` - Menu-driven setup manager -- `create-complete-package.sh` - Create distributable packages -- `verify-claude-setup.sh` - Verify your installation -- `export-claude-customizations.sh` - Export existing customizations +| Script | Description | Size | +|--------|-------------|------| +| `interactive-install-claude.sh` | Full interactive installer (recommended) | 33KB | +| `claude-setup-manager.sh` | Menu-driven setup manager | 11KB | +| `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 -- `FINAL-SETUP-GUIDE.md` - Detailed setup instructions -- `SCRIPTS-GUIDE.md` - Script usage guide +### Engineering (7 agents) +- **AI Engineer** - ML & LLM integration, prompt engineering +- **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. + +--- + +**Built for developers who ship.** 🚀