admin/SuperCharged-Claude-Code-Upgrade
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

SEO-optimized README rewrite

Browse Source 
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
1 changed files with 224 additions and 219 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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) [![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) [![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) [![Agents](https://img.shields.io/badge/Agents-Autonomous-orange)](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade)
![Version](https://img.shields.io/badge/Version-1.0.0-purple) [![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 ### 🧠 Cognitive Skills
- **always-use-superpowers** - Automatically applies relevant skills before any action | Skill | Purpose |
- **cognitive-core** - Core cognitive processing framework |-------|---------|
- **cognitive-context** - Enhanced understanding and analysis | `always-use-superpowers` | Auto-applies relevant skills before any action (Priority: 9999) |
- **cognitive-planner** - Strategic planning capabilities | `cognitive-core` | Core cognitive processing framework |
- **cognitive-safety** - Security and safety validation | `cognitive-planner` | Strategic planning and architecture design |
| `cognitive-safety` | Security validation and best practices |
### 🎯 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
### 🤖 Autonomous Agents ### 🤖 Autonomous Agents
- **RalphLoop** - "Tackle Until Solved" autonomous agent for complex tasks | Agent | Capability |
- **test-driven-development** - TDD workflow automation |-------|------------|
- **systematic-debugging** - Automated debugging workflow | **RalphLoop** | Iterates autonomously until task completion |
- **verification-before-completion** - Pre-completion validation | **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 ### 🎨 Development Tools
- **ui-ux-pro-max** - 50 styles, 21 palettes, 50 font pairings | Tool | Features |
- Glassmorphism, Claymorphism, Neumorphism, Brutalism |------|----------|
- Responsive design patterns | `ui-ux-pro-max` | 50 styles, 21 palettes, 50 font pairings |
- Accessibility-first components | `agent-pipeline-builder` | Multi-agent workflow construction |
| `dispatching-parallel-agents` | Concurrent agent execution |
| `finishing-a-development-branch` | PR and merge automation |
### 🌐 Integrations ### 🌐 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 - **Qwen Consultation** - Get second opinions from Qwen models
- **MCP Servers** - Image analysis, web search, GitHub integration
- **Dev-Browser** - Persistent browser automation - **Dev-Browser** - Persistent browser automation
- **MCP Servers** - Vision, search, web reader, GitHub
### 📝 Commands ### 📁 Installation Structure
- `/ralph` - Autonomous iteration until completion ```
- `/brainstorm` - Multi-AI brainstorming sessions ~/.claude/
- `/write-plan` - Create implementation plans ├── skills/ # 30+ custom skills
- `/execute-plan` - Execute written plans ├── agents/ # 100+ agent library
- `/commit` - Smart git commits ├── 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 ### 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 git clone https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade.git
cd SuperCharged-Claude-Code-Upgrade cd SuperCharged-Claude-Code-Upgrade
# Run the installer # Run the supercharge installer
./supercharge.sh ./supercharge.sh
``` ```
@@ -77,38 +105,38 @@ cd SuperCharged-Claude-Code-Upgrade
./supercharge.sh --dev-mode ./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? ### 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.5-air** - Fast, efficient model (Haiku class) - ideal for quick iterations
- **glm-4.7** - Powerful model (Sonnet/Opus class) - **glm-4.7** - Powerful model (Sonnet/Opus class) - for complex tasks
> [!TIP] > [!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 ```bash
# Install Claude Code with Z.AI API # Install Claude Code with Z.AI API (prompts for API key)
./install-claude-code.sh --auto ./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 # Get your API key from: https://docs.z.ai/devpack/tool/claude
``` ```
### Manual Installation ### Manual Claude Code Installation
```bash ```bash
# 1. Install Claude Code via npm # 1. Install Claude Code via npm
npm install -g @anthropic-ai/claude-code npm install -g @anthropic-ai/claude-code
# 2. Configure Z.AI API # 2. Configure Z.AI API in ~/.claude/settings.json:
# Create or edit ~/.claude/settings.json:
{ {
"env": { "env": {
"ANTHROPIC_API_KEY": "your-zai-api-key-here", "ANTHROPIC_API_KEY": "your-zai-api-key-here",
@@ -125,47 +153,13 @@ claude
/status /status
``` ```
### Show Manual Instructions Only
```bash
./install-claude-code.sh --manual
```
### Documentation ### Documentation
- **Z.AI Official Docs**: https://docs.z.ai/devpack/tool/claude - **Z.AI Official Docs**: https://docs.z.ai/devpack/tool/claude
- **Claude Code Docs**: https://docs.anthropic.com/en/docs/claude-code/overview - **Claude Code Docs**: https://docs.anthropic.com/en/docs/claude-code/overview
## What Gets Installed ---
### Directory Structure ## 💡 Usage Examples
```
~/.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
### RalphLoop - Autonomous Agent ### RalphLoop - Autonomous Agent
@@ -174,67 +168,84 @@ claude
claude claude
> /ralph "Design a microservices architecture for an e-commerce platform" > /ralph "Design a microservices architecture for an e-commerce platform"
# Ralph will iterate until the task is complete # Ralph iterates until completion:
# - Creates task in .ralph/PROMPT.md # - Creates .ralph/PROMPT.md with success criteria
# - Iterates continuously until success criteria are met # - Iterates continuously until all criteria met
# - Updates progress in .ralph/state.json # - Updates .ralph/state.json with progress
# - Outputs final result to .ralph/iterations/final.md # - Outputs final result to .ralph/iterations/final.md
``` ```
**Configuration:** **Configuration:**
```bash ```bash
# Set agent (default: claude) export RALPH_AGENT=claude # Agent selection
export RALPH_AGENT=claude|gemini|kiro|q|auto export RALPH_MAX_ITERATIONS=100 # Max iterations
export RALPH_MAX_RUNTIME=14400 # 4 hours
# Max iterations (default: 100) export RALPH_VERBOSE=true # Debug output
export RALPH_MAX_ITERATIONS=100
# Max runtime in seconds (default: 14400 = 4 hours)
export RALPH_MAX_RUNTIME=14400
# Verbose output
export RALPH_VERBOSE=true
``` ```
### Multi-AI Brainstorming ### Multi-AI Brainstorming
```bash ```bash
> /brainstorming "Create a viral TikTok marketing strategy" > /brainstorming "Create a viral TikTok marketing strategy"
# Collaborates with multiple AI perspectives: # Collaborates with multiple AI perspectives:
# - Content strategist # - Content strategist (copy & messaging)
# - SEO expert # - SEO expert (keywords & optimization)
# - Social media manager # - Social media manager (platforms & tactics)
# - Product manager # - Product manager (goals & metrics)
# - Developer # - Developer (implementation)
# - Designer
``` ```
### Test-Driven Development ### Test-Driven Development
```bash ```bash
> /test-driven-development "Implement user authentication" > /test-driven-development "Implement user authentication"
# 1. Write failing tests first
# 2. Implement minimal code to pass # Automated TDD workflow:
# 3. Refactor while keeping tests green # 1. Write failing tests
# 2. Implement minimal code
# 3. Refactor while tests green
``` ```
### Systematic Debugging ### Systematic Debugging
```bash ```bash
> /systematic-debugging "Database connection timing out" > /systematic-debugging "Database connection timing out"
# 1. Gather information about the error
# 2. Form hypotheses about root cause # Step-by-step resolution:
# 3. Test each hypothesis systematically # 1. Gather error information
# 4. Verify fixes don't break other functionality # 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 ### Environment Variables
```bash ```bash
# Ralph Configuration # 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_ITERATIONS=100 # Maximum iterations
export RALPH_MAX_RUNTIME=14400 # Max runtime (4 hours) 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_MODEL=qwen-coder-plus # Model selection
export QWEN_MAX_ITERATIONS=3 # Max consultation iterations export QWEN_MAX_ITERATIONS=3 # Max consultation iterations
# Superpowers # Auto Superpowers
export AUTO_SUPERPOWERS=true # Auto-inject superpowers context export AUTO_SUPERPOWERS=true # Auto-inject context
``` ```
### Settings Files ### 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 ### Full Inventory
> /agent-pipeline-builder "Create a content generation pipeline" See [INVENTORY.md](INVENTORY.md) for complete component listing.
# Creates: Research -> Draft -> Review -> SEO -> Publish
```
### Parallel Agent Execution ---
Run multiple independent agents simultaneously: ## 🔍 Troubleshooting
```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
### Ralph Loop Not Working ### Ralph Loop Not Working
@@ -360,39 +327,34 @@ cat ~/.claude/skills/your-skill/SKILL.md
claude --debug claude --debug
``` ```
### Hooks Not Executing ### Claude Code Not Found
The supercharge script will offer to install Claude Code automatically if not detected.
```bash ```bash
# Check hooks.json # Or install manually
cat ~/.claude/hooks.json npm install -g @anthropic-ai/claude-code
# Verify hooks are executable # Then run supercharge again
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
./supercharge.sh ./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 ### Update SuperCharge Package
@@ -408,7 +370,15 @@ git pull origin main
~/.claude/scripts/sync-agents.sh ~/.claude/scripts/sync-agents.sh
``` ```
## Uninstallation ### Backup Current Setup
```bash
~/.claude/agents/export-claude-customizations.sh
```
---
## 🗑️ Uninstallation
```bash ```bash
# Remove customizations # Remove customizations
@@ -424,32 +394,67 @@ rm ~/.local/bin/ralphloop
cp -r ~/.claude-backup-YYYYMMDD_HHMMSS/* ~/.claude/ cp -r ~/.claude-backup-YYYYMMDD_HHMMSS/* ~/.claude/
``` ```
## Contributing ---
## 🤝 Contributing
Contributions welcome! Please: Contributions welcome! Please:
1. Fork the repository 1. Fork the repository
2. Create a feature branch 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Make your changes 3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Submit a pull request 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) ## When to Use
- **Claude Code** - [Anthropic](https://claude.com/claude-code) Use this skill when...
- **Community Skills** - Various contributors
## 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** **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