Super Skills
Quick Reference
┌─────────────────────────────────────────────────────────────┐
│ 🎯 Core: Understand → Plan → Execute → Iterate │
│ 🚨 Rule: Problem → Analyze → Solve → Continue (NEVER WAIT) │
│ 📊 Complexity: 4-8 Direct | 9-14 Staged | 15-20 Iterative │
└─────────────────────────────────────────────────────────────┘
Core Philosophy
| Principle | Description |
|---|
| Understand First | Deeply analyze requirements before acting |
| Incremental Delivery | Produce verifiable intermediate results at each step |
| Expect Failures | Design recovery mechanisms for every stage |
| Never Stop | Solve problems proactively; NEVER pause waiting for user |
Workflow
UNDERSTAND ──→ PLAN ──→ EXECUTE ──→ ITERATE
│ │ │ │
Multi-layer Task Search & Feedback
Analysis Breakdown Install Adjustment
Complexity Risk ID Checkpoint Optimize
Phase 1: Understanding
1.1 Multi-Layer Analysis
understanding:
surface: # Literal meaning
request: "{user's exact words}"
keywords: [key terms]
intent: # True intent
goal: "{what user really wants}"
success: "{success criteria}"
context: # Environment
env: "{OS/language/framework}"
constraints: "{time/resources/permissions}"
hidden: # Unstated needs
assumptions: "{implicit assumptions}"
edge_cases: "{boundary conditions}"
1.2 Requirement Handling
| Type | Action |
|---|
| Explicit | Execute directly |
| Implicit | Proactively supplement |
| Ambiguous | State assumptions, choose most likely interpretation |
| Conflicting | Point out conflict, request clarification |
| Out of Scope | Explain why, provide alternatives |
1.3 Complexity Score
Dimensions (1-5 each):
technical + scope + uncertainty + dependencies = total
Strategy:
4-8 → Direct execution
9-14 → Staged verification
15-20 → Iterative prototyping
1.4 Clarification
Confidence ≥70%: State assumptions → Continue → Leave adjustment points
Confidence <70%: Provide options for user to choose (NO open-ended questions)
Phase 2: Planning
2.1 Task Structure
task:
id: 1
name: "{task name}"
capability: "{capability type}"
input: [required inputs]
output: "{type/format}"
depends_on: [prerequisite task IDs]
timeout: "30s"
retries: 3
validation: "{success condition}"
fallback: "{alternative approach}"
2.2 Dependency Graph
[1:Setup] → [2:Auth] → [3:Fetch] ─┐
↓
[4:Process] ← [5:Transform] ← [6:Parse]
↓
[7:Output]
Critical Path: 1→2→3→6→5→4→7
Parallel Opportunities: Independent tasks can run concurrently
2.3 Capability Map
| Capability | Status | Keywords |
|---|
browser_automation | ❌ | browser, puppeteer, playwright |
api_integration | ❌ | api, rest, {service} |
data_extraction | ⚠️ | parse, pdf, ocr |
message_delivery | ❌ | slack, discord, email |
database_operations | ❌ | sql, mongodb |
deployment | ❌ | deploy, docker, k8s |
data_transformation | ✅ | — |
content_generation | ✅ | — |
code_execution | ✅ | — |
scheduling | ✅ | — |
✅ Built-in | ⚠️ Complex | ❌ Skill required
Phase 3: Skill Acquisition
# Search priority
1. npx skills find {service_name} # Exact match
2. npx skills find {capability} {domain} # Combined
3. https://skills.sh/ # Browse
# Install
npx skills add <skill> -g
# On failure: Switch registry → Manual clone → Inline implementation
Evaluation Criteria
| Dimension | Weight |
|---|
| Feature match | 40% |
| Documentation quality | 20% |
| Maintenance status | 20% |
| Community validation | 10% |
| Dependency simplicity | 10% |
Phase 4: Risk & Resilience
4.1 Risk Matrix
| Risk | Detection | Auto-Resolution |
|---|
| Token expired | 401/403 | Refresh → Re-auth → Degrade |
| Rate limited | 429 | Backoff → Cache → Degrade |
| Timeout | Timeout | Increase → Reduce batch → Chunk |
| Parse error | Parse Error | Switch parser → Regex → Raw text |
| Connection failed | Connection | Retry → Proxy → Offline mode |
| Missing dependency | Import Error | Auto-install → Alternative pkg → Inline |
4.2 Resilience Patterns
retry: max=3, backoff=exponential
circuit_breaker: threshold=5, recovery=60s
timeout: connect=10s, read=30s, total=120s
fallback: cache | default | skip
4.3 Checkpoints
checkpoint:
trigger: after_each_task
content: [task_id, state, data, timestamp]
recovery: Load checkpoint → Validate → Resume from failure point
Phase 5: Execution
5.0 🚨 Problem Solving (CRITICAL)
On problem → Analyze → Solve → Continue. NEVER pause waiting.
Problem → Diagnose type → Analyze cause → Try solutions by priority → Continue
↓
Plan A fails → Plan B → Plan C → Degraded solution
Auto-Fix Table
| Problem | Auto-Resolution (in order) |
|---|
| Missing dependency | Install → Alternative pkg → Inline |
| Permission denied | Adjust perms → Alternative path → Minimal perms |
| API failure | Retry (backoff) → Switch endpoint → Cache → Degrade |
| Timeout | Increase timeout → Reduce batch → Chunk → Async |
| Parse error | Switch parser → Regex → Raw text |
| Auth failure | Refresh token → Re-auth → Backup credentials |
| Resource exhausted | Chunk → Clear cache → Stream → Reduce concurrency |
| Network issue | Retry → Switch network → Proxy → Offline |
| File not found | Create → Default value → Skip |
Mindset
forbidden:
- "I encountered a problem and need your help"
- "Execution paused, waiting for instructions"
required:
- "Encountered X issue, trying Y solution"
- "Plan A failed, switching to Plan B"
- "Problem resolved, continuing execution"
Escalation (ONLY when ALL conditions met)
- Tried ≥3 different solutions
- All failed
- Goal completely unachievable
- No acceptable degraded solution available
5.1 Execution Modes
| Mode | Use Case |
|---|
| Sequential | Tasks with strong dependencies |
| Parallel | Independent tasks |
| Pipeline | Data stream processing |
| Iterative | Requires feedback loops |
5.2 Progress Template
══════════════════════════════════════
📊 PROGRESS
══════════════════════════════════════
Phase 1: Setup [████████░░] 80%
✅ Task 1: Initialize Done (2.3s)
🔄 Task 2: Fetch Running...
⏳ Task 3: Process Waiting
──────────────────────────────────────
⏱️ Elapsed: 3m | ETA: ~5m
══════════════════════════════════════
Phase 6: Iteration
Feedback Loop
Collect feedback → Analyze issues → Adjust approach → Loop
Adjustment Levels
| Level | Actions |
|---|
| Minor | Parameter tuning, format adjustment |
| Moderate | Replace skills, add/remove tasks |
| Major | Redesign architecture |
Execution Plan Template
════════════════════════════════════════════════════
📋 SUPER SKILLS PLAN
════════════════════════════════════════════════════
🎯 REQUEST: {user's exact words}
📊 UNDERSTANDING
────────────────────────────────────────────────────
Intent: {true intent}
Success: {success criteria}
Complexity: {score} → {strategy}
Assumptions:
• {assumption 1}
• {assumption 2}
────────────────────────────────────────────────────
📋 TASKS
────────────────────────────────────────────────────
│ ID │ Task │ Capability │ Status │ Risk │
├────┼────────────┼─────────────┼────────┼──────┤
│ 1 │ {task} │ {capability}│ ✅/📦 │ 🟢/🔴│
Status: ✅ Built-in | 🔧 Found | 📦 Create
Risk: 🟢 Low | 🟡 Medium | 🔴 High
────────────────────────────────────────────────────
🔧 SKILLS
────────────────────────────────────────────────────
npx skills add {skill} -g
────────────────────────────────────────────────────
🛡️ RESILIENCE
────────────────────────────────────────────────────
Checkpoints: □ After Phase 1 □ After Phase 2
Fallbacks: {task} → {alternative}
────────────────────────────────────────────────────
✅ COMPLETION
────────────────────────────────────────────────────
□ {acceptance criterion 1}
□ {acceptance criterion 2}
════════════════════════════════════════════════════
Example: E-commerce Pipeline
# "Scrape product data from multiple platforms daily, analyze price trends, send report"
understanding:
intent: "Automated price monitoring for pricing decisions"
success: "Daily price trend visualization report received"
complexity:
technical: 4, scope: 4, uncertainty: 3, dependencies: 4
total: 15 → Iterative prototyping strategy
tasks:
1. Configure product list → file_operations ✅
2. Multi-platform scraping → browser_automation ❌
3. Data persistence → database_operations ❌
4. Data cleaning → data_transformation ✅
5. Trend analysis → code_execution ✅
6. Generate charts → content_generation ✅
7. Generate report → content_generation ✅
8. Send email → message_delivery ❌
resilience:
checkpoints: [after:2 save:raw_data] [after:5 save:analysis]
fallbacks:
task_2: "Skip failed platforms, continue with others"
task_8: "Save to local file"
Error Handling (Every error has auto-resolution)
| Phase | Error | Auto-Resolution |
|---|
| Analysis | Unclear requirements | Choose most likely → State assumptions → Leave adjustment points |
| Analysis | Beyond capability | Search alternatives → Combine capabilities → Partial implementation |
| Planning | Circular dependency | Break weakest link → Merge tasks |
| Search | Skill not found | Expand keywords → Online search → Auto-create |
| Install | Installation failed | Switch registry → Manual clone → Inline implementation |
| Execution | Auth failure | Refresh → Re-auth → Degrade to public data |
| Execution | Rate limited | Backoff → Switch account → Use cache |
| Execution | Timeout | Increase timeout → Reduce batch → Skip and continue |
| Validation | Result mismatch | Retry with adjusted params → Relax validation → Mark for review |
Best Practices
| Phase | Principles |
|---|
| Understanding | Multi-layer analysis, proactive assumptions, complexity assessment |
| Planning | Architecture first, clear dependencies, upfront risk identification |
| Execution | NEVER STOP, try multiple solutions, graceful degradation, incremental verification |
| Iteration | Fast feedback, continuous optimization, knowledge accumulation |
Resources
- CLI:
npx skills --help - Browse: https://skills.sh/
- Capabilities:
references/capability_types.md - Template:
assets/skill_template.md
