SEO-optimized README rewrite

Multi-AI collaboration (Content + SEO + Web + PM agents) complete rewrite with:

SEO Enhancements:
- Keyword-optimized H1 title and description
- Strategic heading structure (H1, H2, H3)
- Primary keywords: Claude Code customization, skills, agents, Z.AI API
- Long-tail keywords in natural context
- Internal links to INVENTORY.md
- External links to official docs
- Social proof badges (skills count, agents, license)
- Keywords section at bottom for discoverability

Content Improvements:
- Compelling above-the-fold value proposition
- Feature highlights with emojis for scannability
- Clear installation instructions (one-line + manual)
- Comprehensive usage examples
- Troubleshooting section
- Structured with tables and code blocks
- Contributing guidelines
- Star History badge
- Support links

Target Keywords:
- Claude Code customization
- Claude Code skills
- Claude Code agents
- Z.AI API integration
- GLM models
- RalphLoop autonomous agent
- MCP servers
- AI workflow automation
This commit is contained in:
uroma
2026-01-22 15:53:10 +00:00
Unverified
parent b98d3716af
commit 298d2b2e08

443
README.md
View File

@@ -1,54 +1,82 @@
# SuperCharged Claude Code - Ultimate Upgrade
# SuperCharged Claude Code - Ultimate Upgrade Package
Transform your Claude Code installation into an autonomous development powerhouse with 30+ custom skills, AI agents, and advanced integrations.
> 🚀 Transform your Claude Code into an autonomous AI development powerhouse with 30+ custom skills, autonomous agents, and Z.AI GLM model integration. Install in 2 minutes.
![SuperCharge](https://img.shields.io/badge/Claude-Code-Supercharged-blue)
![Skills](https://img.shields.io/badge/Skills-30+-green)
![Agents](https://img.shields.io/badge/Agents-Autonomous-orange)
![Version](https://img.shields.io/badge/Version-1.0.0-purple)
[![Claude Code](https://img.shields.io/badge/Claude-Code-Supercharged-blue)](https://claude.com/claude-code)
[![Skills](https://img.shields.io/badge/Skills-30+-green)](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade)
[![Agents](https://img.shields.io/badge/Agents-Autonomous-orange)](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade)
[![License](https://img.shields.io/badge/License-MIT-purple)](LICENSE)
[![Gitea](https://img.shields.io/badge/Platform-Gitea-red)](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade)
## Features
---
## ⚡ Why SuperCharge Claude Code?
**Claude Code is powerful. SuperCharge makes it unstoppable.**
This comprehensive customization package transforms your Claude Code installation with:
-**30+ Custom Skills** - Cognitive enhancement, development workflows, UI/UX intelligence
- 🤖 **Autonomous Agents** - RalphLoop "Tackle Until Solved" agent for complex tasks
- 🌐 **Z.AI API Integration** - GLM-4.5-air and GLM-4.7 model support with 10% OFF discount
- 🔌 **MCP Servers** - Image analysis, web search, GitHub integration built-in
- 🎯 **Agent Management** - Complete library with sync capabilities
- 🪝 **Smart Hooks** - Session automation and multi-AI consultation
**Perfect for:** Developers, AI enthusiasts, teams building with AI assistants, and anyone wanting to maximize their Claude Code productivity.
---
## 🎯 What Gets Installed
### 🧠 Cognitive Skills
- **always-use-superpowers** - Automatically applies relevant skills before any action
- **cognitive-core** - Core cognitive processing framework
- **cognitive-context** - Enhanced understanding and analysis
- **cognitive-planner** - Strategic planning capabilities
- **cognitive-safety** - Security and safety validation
### 🎯 Development Tools
- **agent-pipeline-builder** - Build multi-agent pipelines with structured data flow
- **dispatching-parallel-agents** - Execute multiple agents concurrently
- **executing-plans** - Execute implementation plans with review checkpoints
- **finishing-a-development-branch** - Complete and merge development work
- **subagent-driven-development** - Execute plans with independent subagents
| Skill | Purpose |
|-------|---------|
| `always-use-superpowers` | Auto-applies relevant skills before any action (Priority: 9999) |
| `cognitive-core` | Core cognitive processing framework |
| `cognitive-planner` | Strategic planning and architecture design |
| `cognitive-safety` | Security validation and best practices |
### 🤖 Autonomous Agents
- **RalphLoop** - "Tackle Until Solved" autonomous agent for complex tasks
- **test-driven-development** - TDD workflow automation
- **systematic-debugging** - Automated debugging workflow
- **verification-before-completion** - Pre-completion validation
| Agent | Capability |
|-------|------------|
| **RalphLoop** | Iterates autonomously until task completion |
| **Brainstorming** | Multi-AI collaborative ideation |
| **Test-Driven Development** | Automated TDD workflow |
| **Systematic Debugging** | Step-by-step bug resolution |
| **Verification** | Pre-completion validation checks |
### 🎨 UI/UX Intelligence
- **ui-ux-pro-max** - 50 styles, 21 palettes, 50 font pairings
- Glassmorphism, Claymorphism, Neumorphism, Brutalism
- Responsive design patterns
- Accessibility-first components
### 🎨 Development Tools
| Tool | Features |
|------|----------|
| `ui-ux-pro-max` | 50 styles, 21 palettes, 50 font pairings |
| `agent-pipeline-builder` | Multi-agent workflow construction |
| `dispatching-parallel-agents` | Concurrent agent execution |
| `finishing-a-development-branch` | PR and merge automation |
### 🌐 Integrations
- **Multi-AI Brainstorming** - Collaborate with multiple AI models
- **Z.AI GLM Models** - glm-4.5-air (fast), glm-4.7 (powerful)
- **Qwen Consultation** - Get second opinions from Qwen models
- **MCP Servers** - Image analysis, web search, GitHub integration
- **Dev-Browser** - Persistent browser automation
- **MCP Servers** - Vision, search, web reader, GitHub
### 📝 Commands
- `/ralph` - Autonomous iteration until completion
- `/brainstorm` - Multi-AI brainstorming sessions
- `/write-plan` - Create implementation plans
- `/execute-plan` - Execute written plans
- `/commit` - Smart git commits
### 📁 Installation Structure
```
~/.claude/
├── skills/ # 30+ custom skills
├── agents/ # 100+ agent library
├── hooks/ # Session automation
├── commands/ # Custom commands
├── plugins/ # MCP servers & integrations
└── settings.json # Z.AI API configuration
## Quick Start
~/.local/bin/
└── ralphloop # Ralph Orchestrator wrapper
```
---
## 🚀 Quick Start (2 Minutes)
### One-Line Installation
@@ -63,7 +91,7 @@ curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw
git clone https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade.git
cd SuperCharged-Claude-Code-Upgrade
# Run the installer
# Run the supercharge installer
./supercharge.sh
```
@@ -77,38 +105,38 @@ cd SuperCharged-Claude-Code-Upgrade
./supercharge.sh --dev-mode
```
## Claude Code Installation (Optional)
---
If you don't have Claude Code installed yet, the supercharge script will offer to install it for you with **Z.AI API support**.
## 🔧 Claude Code Installation (Optional)
If you don't have Claude Code installed yet, we've got you covered with **Z.AI API support**.
### What is Z.AI API?
Z.AI provides GLM (General Language Model) models that can be used with Claude Code:
[Z.AI](https://docs.z.ai/devpack/tool/claude) provides GLM (General Language Model) models optimized for Claude Code:
- **glm-4.5-air** - Fast, efficient model (Haiku class)
- **glm-4.7** - Powerful model (Sonnet/Opus class)
- **glm-4.5-air** - Fast, efficient model (Haiku class) - ideal for quick iterations
- **glm-4.7** - Powerful model (Sonnet/Opus class) - for complex tasks
> [!TIP]
> **Grab 10% OFF Token for z.ai coding plan**: [https://z.ai/subscribe?ic=R0K78RJKNW](https://z.ai/subscribe?ic=R0K78RJKNW)
> **🎁 Grab 10% OFF Token for z.ai coding plan**: [https://z.ai/subscribe?ic=R0K78RJKNW](https://z.ai/subscribe?ic=R0K78RJKNW)
### Automated Installation
### Automated Claude Code + Z.AI Installation
```bash
# Install Claude Code with Z.AI API
# Install Claude Code with Z.AI API (prompts for API key)
./install-claude-code.sh --auto
# You'll be prompted for your Z.AI API key
# Get your API key from: https://docs.z.ai/devpack/tool/claude
```
### Manual Installation
### Manual Claude Code Installation
```bash
# 1. Install Claude Code via npm
npm install -g @anthropic-ai/claude-code
# 2. Configure Z.AI API
# Create or edit ~/.claude/settings.json:
# 2. Configure Z.AI API in ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_API_KEY": "your-zai-api-key-here",
@@ -125,47 +153,13 @@ claude
/status
```
### Show Manual Instructions Only
```bash
./install-claude-code.sh --manual
```
### Documentation
- **Z.AI Official Docs**: https://docs.z.ai/devpack/tool/claude
- **Claude Code Docs**: https://docs.anthropic.com/en/docs/claude-code/overview
## What Gets Installed
---
### Directory Structure
```
~/.claude/
├── skills/ # 30+ custom skills
├── agents/ # Agent management system
├── hooks/ # Custom hooks
├── commands/ # Custom commands
├── plugins/ # Plugin references
├── scripts/ # Utility scripts
└── settings.json # Configuration
~/.local/bin/
└── ralphloop # Ralph Orchestrator wrapper
```
### Installed Components
| Component | Description |
|-----------|-------------|
| **Skills** | 30+ custom skills for cognitive enhancement, development, UI/UX |
| **Agents** | Complete agent library with sync capabilities |
| **Hooks** | Session start, prompt submit, auto-trigger hooks |
| **Commands** | Predefined commands for common workflows |
| **Plugins** | MCP servers, LSP integrations, marketplace plugins |
| **Binaries** | RalphLoop wrapper for autonomous agent iteration |
## Usage
## 💡 Usage Examples
### RalphLoop - Autonomous Agent
@@ -174,67 +168,84 @@ claude
claude
> /ralph "Design a microservices architecture for an e-commerce platform"
# Ralph will iterate until the task is complete
# - Creates task in .ralph/PROMPT.md
# - Iterates continuously until success criteria are met
# - Updates progress in .ralph/state.json
# Ralph iterates until completion:
# - Creates .ralph/PROMPT.md with success criteria
# - Iterates continuously until all criteria met
# - Updates .ralph/state.json with progress
# - Outputs final result to .ralph/iterations/final.md
```
**Configuration:**
```bash
# Set agent (default: claude)
export RALPH_AGENT=claude|gemini|kiro|q|auto
# Max iterations (default: 100)
export RALPH_MAX_ITERATIONS=100
# Max runtime in seconds (default: 14400 = 4 hours)
export RALPH_MAX_RUNTIME=14400
# Verbose output
export RALPH_VERBOSE=true
export RALPH_AGENT=claude # Agent selection
export RALPH_MAX_ITERATIONS=100 # Max iterations
export RALPH_MAX_RUNTIME=14400 # 4 hours
export RALPH_VERBOSE=true # Debug output
```
### Multi-AI Brainstorming
```bash
> /brainstorming "Create a viral TikTok marketing strategy"
# Collaborates with multiple AI perspectives:
# - Content strategist
# - SEO expert
# - Social media manager
# - Product manager
# - Developer
# - Designer
# - Content strategist (copy & messaging)
# - SEO expert (keywords & optimization)
# - Social media manager (platforms & tactics)
# - Product manager (goals & metrics)
# - Developer (implementation)
```
### Test-Driven Development
```bash
> /test-driven-development "Implement user authentication"
# 1. Write failing tests first
# 2. Implement minimal code to pass
# 3. Refactor while keeping tests green
# Automated TDD workflow:
# 1. Write failing tests
# 2. Implement minimal code
# 3. Refactor while tests green
```
### Systematic Debugging
```bash
> /systematic-debugging "Database connection timing out"
# 1. Gather information about the error
# 2. Form hypotheses about root cause
# 3. Test each hypothesis systematically
# 4. Verify fixes don't break other functionality
# Step-by-step resolution:
# 1. Gather error information
# 2. Form hypotheses
# 3. Test each hypothesis
# 4. Verify fix doesn't break functionality
```
## Configuration
---
## 🎨 UI/UX Intelligence
The `ui-ux-pro-max` skill provides comprehensive design capabilities:
### 50 Design Styles
Glassmorphism, Claymorphism, Neumorphism, Brutalism, Minimalism, Bento Grid, Dark Mode, Skeuomorphism, Flat Design, and more...
### 21 Color Palettes
Pre-configured themes for instant visual consistency
### 50 Font Pairings
Typographic combinations proven to work well together
### 9 Tech Stacks
React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui
---
## ⚙️ Configuration
### Environment Variables
```bash
# Ralph Configuration
export RALPH_AGENT=claude # Agent selection
export RALPH_AGENT=claude # claude|gemini|kiro|q|auto
export RALPH_MAX_ITERATIONS=100 # Maximum iterations
export RALPH_MAX_RUNTIME=14400 # Max runtime (4 hours)
@@ -243,8 +254,8 @@ export QWEN_CONSULT_MODE=always # always|delegate|off
export QWEN_MODEL=qwen-coder-plus # Model selection
export QWEN_MAX_ITERATIONS=3 # Max consultation iterations
# Superpowers
export AUTO_SUPERPOWERS=true # Auto-inject superpowers context
# Auto Superpowers
export AUTO_SUPERPOWERS=true # Auto-inject context
```
### Settings Files
@@ -268,70 +279,26 @@ export AUTO_SUPERPOWERS=true # Auto-inject superpowers context
}
```
## Advanced Features
---
### Agent Pipeline Builder
## 📦 Package Contents
Build multi-agent workflows with structured data flow:
| Component | Count | Description |
|-----------|-------|-------------|
| **Skills** | 30+ | Cognitive, development, UI/UX, autonomous agents |
| **Agents** | 100+ | Engineering, marketing, product, testing, design |
| **Hooks** | 5+ | Session automation, multi-AI consultation |
| **Commands** | 3 | /brainstorm, /write-plan, /execute-plan |
| **MCP Servers** | 6 | Vision, search, web reader, GitHub, feedback, usage |
| **Binaries** | 1 | ralphloop wrapper |
| **Size** | 126MB | Complete package |
```bash
> /agent-pipeline-builder "Create a content generation pipeline"
# Creates: Research -> Draft -> Review -> SEO -> Publish
```
### Full Inventory
See [INVENTORY.md](INVENTORY.md) for complete component listing.
### Parallel Agent Execution
---
Run multiple independent agents simultaneously:
```bash
> /dispatching-parallel-agents "Test and document in parallel"
# Spawns: test-runner + documentation-writer
```
### Plan Execution
Execute written implementation plans with checkpoints:
```bash
> /execute-plan .claude/plans/feature-xyz.md
# Executes plan with review at each checkpoint
```
## Customization
### Adding Custom Skills
Create a new skill at `~/.claude/skills/your-skill/SKILL.md`:
```markdown
# Your Custom Skill
## When to Use
Use this skill when...
## What It Does
This skill provides...
```
### Adding Custom Hooks
Create hooks at `~/.claude/hooks/`:
**session-start-your-hook.sh**
```bash
#!/bin/bash
# Runs on session start
echo "Custom initialization..."
```
**user-prompt-your-hook.sh**
```bash
#!/bin/bash
# Runs before each user prompt
echo "Processing prompt..."
```
## Troubleshooting
## 🔍 Troubleshooting
### Ralph Loop Not Working
@@ -360,39 +327,34 @@ cat ~/.claude/skills/your-skill/SKILL.md
claude --debug
```
### Hooks Not Executing
### Claude Code Not Found
The supercharge script will offer to install Claude Code automatically if not detected.
```bash
# Check hooks.json
cat ~/.claude/hooks.json
# Or install manually
npm install -g @anthropic-ai/claude-code
# Verify hooks are executable
ls -la ~/.claude/hooks/*.sh
# Test hook manually
bash ~/.claude/hooks/session-start-superpowers.sh
```
## Backup and Restore
### Backup Current Setup
```bash
# Export all customizations
~/.claude/agents/export-claude-customizations.sh
```
### Restore from Backup
```bash
# Run installer with backup
# Then run supercharge again
./supercharge.sh
# Customizations are automatically backed to:
~/.claude-backup-YYYYMMDD_HHMMSS/
```
## Updates
### Z.AI API Configuration
```bash
# Check settings
cat ~/.claude/settings.json | grep ANTHROPIC
# Verify API key works
curl -X POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"glm-4.7","messages":[{"role":"user","content":"test"}]}'
```
---
## 🔄 Updates & Maintenance
### Update SuperCharge Package
@@ -408,7 +370,15 @@ git pull origin main
~/.claude/scripts/sync-agents.sh
```
## Uninstallation
### Backup Current Setup
```bash
~/.claude/agents/export-claude-customizations.sh
```
---
## 🗑️ Uninstallation
```bash
# Remove customizations
@@ -424,32 +394,67 @@ rm ~/.local/bin/ralphloop
cp -r ~/.claude-backup-YYYYMMDD_HHMMSS/* ~/.claude/
```
## Contributing
---
## 🤝 Contributing
Contributions welcome! Please:
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## License
### Adding Custom Skills
MIT License - See LICENSE file for details
Create `~/.claude/skills/your-skill/SKILL.md`:
## Credits
```markdown
# Your Custom Skill
- **Ralph Orchestrator** - [mikeyobrien/ralph-orchestrator](https://github.com/mikeyobrien/ralph-orchestrator)
- **Claude Code** - [Anthropic](https://claude.com/claude-code)
- **Community Skills** - Various contributors
## When to Use
Use this skill when...
## Support
## What It Does
This skill provides...
```
- **Issues**: [GitHub Issues](https://github.com/rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/issues)
- **Discussions**: [GitHub Discussions](https://github.com/rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/discussions)
---
## 📄 License
MIT License - See [LICENSE](LICENSE) file for details
---
## 🙏 Credits
- **[Ralph Orchestrator](https://github.com/mikeyobrien/ralph-orchestrator)** - Autonomous agent iteration
- **[Claude Code](https://claude.com/claude-code)** - Anthropic's AI coding assistant
- **[Z.AI](https://docs.z.ai/devpack/tool/claude)** - GLM model integration
- **Community Contributors** - Skills, agents, and plugins
---
## 📞 Support
- **Issues**: [Gitea Issues](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/issues)
- **Discussions**: [Gitea Discussions](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/discussions)
- **Documentation**: [Full Docs](INVENTORY.md)
---
## 🌟 Star History
[![Star History Chart](https://api.star-history.com/svg?repos=admin/SuperCharged-Claude-Code-Upgrade&type=Date)](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade)
---
**Made with ❤️ for the Claude Code community**
*SuperCharge your development workflow today!*
*SuperCharge your AI development workflow today!*
---
**Keywords:** Claude Code customization, Claude Code skills, Claude Code agents, AI coding assistant, Z.AI API, GLM models, RalphLoop, autonomous AI development, CLI tools, developer tools, Claude Code plugins, MCP servers, Qwen integration, AI workflow automation