Features: - 30+ Custom Skills (cognitive, development, UI/UX, autonomous agents) - RalphLoop autonomous agent integration - Multi-AI consultation (Qwen) - Agent management system with sync capabilities - Custom hooks for session management - MCP servers integration - Plugin marketplace setup - Comprehensive installation script Components: - Skills: always-use-superpowers, ralph, brainstorming, ui-ux-pro-max, etc. - Agents: 100+ agents across engineering, marketing, product, etc. - Hooks: session-start-superpowers, qwen-consult, ralph-auto-trigger - Commands: /brainstorm, /write-plan, /execute-plan - MCP Servers: zai-mcp-server, web-search-prime, web-reader, zread - Binaries: ralphloop wrapper Installation: ./supercharge.sh
156 lines
4.6 KiB
Markdown
156 lines
4.6 KiB
Markdown
# Always-Use-Superpowers Integration Guide
|
|
|
|
## ✅ What Was Fixed
|
|
|
|
### Problem:
|
|
The original `always-use-superpowers` skill referenced non-existent `superpowers:*` skills:
|
|
- `superpowers:using-superpowers` ❌
|
|
- `superpowers:brainstorming` ❌
|
|
- `superpowers:systematic-debugging` ❌
|
|
- etc.
|
|
|
|
### Solution:
|
|
Rewrote the skill to work with your **actually available skills**:
|
|
- ✅ `ui-ux-pro-max` - UI/UX design intelligence
|
|
- ✅ `cognitive-planner` - Task planning and strategy
|
|
- ✅ `cognitive-context` - Context awareness
|
|
- ✅ `cognitive-safety` - Security and safety
|
|
|
|
## 🎯 How It Works Now
|
|
|
|
### Automatic Skill Selection Flow:
|
|
|
|
```
|
|
User sends ANY message
|
|
↓
|
|
Check: Is this UI/UX work?
|
|
↓ YES → Invoke ui-ux-pro-max
|
|
↓ NO
|
|
Check: Is this planning/strategy?
|
|
↓ YES → Invoke cognitive-planner
|
|
↓ NO
|
|
Check: Is this context/analysis needed?
|
|
↓ YES → Invoke cognitive-context
|
|
↓ NO
|
|
Check: Any security/safety concerns?
|
|
↓ YES → Invoke cognitive-safety
|
|
↓ NO
|
|
Proceed with task
|
|
```
|
|
|
|
### Quick Reference Table:
|
|
|
|
| Situation | Skill to Invoke | Priority |
|
|
|-----------|----------------|----------|
|
|
| UI/UX design, HTML/CSS, visual work | `ui-ux-pro-max` | HIGH |
|
|
| Planning, strategy, implementation | `cognitive-planner` | HIGH |
|
|
| Understanding code, context, analysis | `cognitive-context` | HIGH |
|
|
| Security, validation, error handling | `cognitive-safety` | CRITICAL |
|
|
| Any design work | `ui-ux-pro-max` | HIGH |
|
|
| Any frontend work | `ui-ux-pro-max` | HIGH |
|
|
| Any database changes | `cognitive-safety` | CRITICAL |
|
|
| Any user input handling | `cognitive-safety` | CRITICAL |
|
|
| Any API endpoints | `cognitive-safety` | CRITICAL |
|
|
| Complex multi-step tasks | `cognitive-planner` | HIGH |
|
|
| Code analysis/reviews | `cognitive-context` | HIGH |
|
|
|
|
## 📝 Usage Examples
|
|
|
|
### Example 1: UI/UX Work
|
|
```
|
|
User: "Make the button look better"
|
|
|
|
Claude automatically:
|
|
1. ✅ Recognizes: UI/UX work
|
|
2. ✅ Invokes: ui-ux-pro-max
|
|
3. ✅ Follows: Design guidelines (accessibility, interactions, styling)
|
|
4. ✅ Result: Professional, accessible button
|
|
```
|
|
|
|
### Example 2: Feature Implementation
|
|
```
|
|
User: "Implement user authentication"
|
|
|
|
Claude automatically:
|
|
1. ✅ Recognizes: Planning work → Invokes cognitive-planner
|
|
2. ✅ Recognizes: UI affected → Invokes ui-ux-pro-max
|
|
3. ✅ Recognizes: Context needed → Invokes cognitive-context
|
|
4. ✅ Recognizes: Security critical → Invokes cognitive-safety
|
|
5. ✅ Follows: All skill guidance
|
|
6. ✅ Result: Secure, planned, well-designed auth system
|
|
```
|
|
|
|
### Example 3: Security Concern
|
|
```
|
|
User: "Update database credentials"
|
|
|
|
Claude automatically:
|
|
1. ✅ Recognizes: Security concern
|
|
2. ✅ Invokes: cognitive-safety
|
|
3. ✅ Follows: Security guidelines
|
|
4. ✅ Result: Safe credential updates
|
|
```
|
|
|
|
### Example 4: Code Analysis
|
|
```
|
|
User: "What does this code do?"
|
|
|
|
Claude automatically:
|
|
1. ✅ Recognizes: Context needed
|
|
2. ✅ Invokes: cognitive-context
|
|
3. ✅ Follows: Context guidance
|
|
4. ✅ Result: Accurate analysis with proper context
|
|
```
|
|
|
|
## 🔧 How to Manually Invoke Skills
|
|
|
|
If automatic invocation doesn't work, you can manually invoke:
|
|
|
|
```
|
|
Skill: ui-ux-pro-max
|
|
Skill: cognitive-planner
|
|
Skill: cognitive-context
|
|
Skill: cognitive-safety
|
|
```
|
|
|
|
## ⚙️ Configuration Files
|
|
|
|
### Main Skill:
|
|
- `/home/uroma/.claude/skills/always-use-superpowers/SKILL.md`
|
|
|
|
### Available Skills:
|
|
- `/home/uroma/.claude/skills/ui-ux-pro-max/SKILL.md`
|
|
- `/home/uroma/.claude/skills/cognitive-planner/SKILL.md`
|
|
- `/home/uroma/.claude/skills/cognitive-context/SKILL.md`
|
|
- `/home/uroma/.claude/skills/cognitive-safety/SKILL.md`
|
|
|
|
## ✨ Key Improvements
|
|
|
|
1. **No More Broken References**: Removed all `superpowers:*` references
|
|
2. **Works With Available Skills**: Integrates with your actual skill set
|
|
3. **Clear Decision Tree**: Easy-to-follow flowchart for skill selection
|
|
4. **Quick Reference Table**: Fast lookup for when to use each skill
|
|
5. **Real Examples**: Practical usage scenarios
|
|
6. **Priority System**: CRITICAL vs HIGH priority guidance
|
|
|
|
## 🚀 Next Steps
|
|
|
|
The skill is now ready to use. It will automatically:
|
|
1. Detect which skills apply to your request
|
|
2. Invoke them before taking action
|
|
3. Follow their guidance precisely
|
|
4. Provide better, more informed responses
|
|
|
|
## 📊 Testing
|
|
|
|
To test if it's working:
|
|
|
|
1. Ask a UI/UX question → Should invoke `ui-ux-pro-max`
|
|
2. Ask for planning → Should invoke `cognitive-planner`
|
|
3. Ask about code → Should invoke `cognitive-context`
|
|
4. Ask about security → Should invoke `cognitive-safety`
|
|
|
|
---
|
|
|
|
**Status: ✅ Fully Integrated and Ready to Use**
|