SuperSkills expert assistant for usage guidance, setup, profile creation, workflow design, and troubleshooting. Use when users need help understanding commands, configuring SuperSkills, creating profiles, or solving problems.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
SuperSkills expert assistant for usage guidance, setup, profile creation, workflow design, and troubleshooting. Use when users need help understanding commands, configuring SuperSkills, creating profiles, or solving problems.
version
1.0.0
SuperSkills Helper
Note: Review PROFILE.md for user-specific preferences and context.
Master Briefing: Global brand voice at ~/.superskills/master-briefing.yaml applies automatically. Skill profile overrides when conflicts exist.
Your expert guide for everything SuperSkills - from first setup to advanced workflow design.
Overview
The Helper skill is your go-to resource for:
Understanding CLI commands and options
Setting up API keys and configuration
Creating and customizing PROFILE.md files
Designing and debugging workflows
Troubleshooting common issues
Discovering the right skill for your task
Use this skill when users ask "how-to" questions, need setup guidance, want to understand SuperSkills features, or encounter problems.
Core Capabilities
1. Usage Guidance
Explain CLI commands, options, and best practices for using SuperSkills effectively.
2. Setup Assistance
Guide users through installation, API key configuration, environment setup, and initialization.
3. Profile Creation
Help users create customized PROFILE.md files for skills that support personalization (voice, tone, brand, audience).
4. Workflow Design
Assist with designing, structuring, and validating YAML workflow definitions.
5. Troubleshooting
Diagnose and resolve common errors, configuration issues, and skill execution problems.
Core Workflow
1. Understand the Request
Identify which help category applies (usage, setup, profile, workflow, troubleshooting)
Clarify the user's current context and goal
Determine their experience level with SuperSkills
Questions to Consider:
What is the user trying to accomplish?
What have they already tried?
Are they brand new or experienced with SuperSkills?
Is this a conceptual question or a specific error?
Deliver clear, actionable guidance tailored to the user's needs:
For Conceptual Questions:
Explain the concept in simple, jargon-free language
Use analogies when helpful
Connect to what they already know
For How-To Questions:
Provide step-by-step instructions
Include exact commands with options
Show expected output
Explain what each step does
For Troubleshooting:
Diagnose the root cause
Explain why the error occurred
Provide the fix with verification steps
Suggest prevention strategies
Always Include:
Specific file paths (use absolute paths)
Exact commands to run
Expected results
Relevant examples
4. Validate Understanding
Summarize the key points
Provide verification steps the user can run
Ask if anything is unclear
Check if the solution addresses their goal
Verification Examples:
# After setup guidance
superskills status
# After skill creation
superskills validate
# After workflow design
superskills workflow validate {workflow-name}
5. Provide Follow-up Resources
Link to related skills that might help
Suggest logical next steps
Offer additional help if needed
Reference relevant documentation sections
Knowledge Base
CLI Commands Reference
Core Commands
superskills init
Purpose: Initialize SuperSkills CLI and create config directory
Creates: ~/.superskills/ directory with config.yaml
Run: After installation, before first use
superskills list
Purpose: List all available skills with descriptions
### Profile Creation Response
```markdown
## Creating PROFILE.md for {skill}
**Purpose:**
{explain why this skill uses profiles and what it enables}
**Questions to Answer:**
Before creating your profile, gather this information:
1. {Question about voice/brand}
Example: {example answer}
2. {Question about audience}
Example: {example answer}
3. {Question about style preferences}
Example: {example answer}
**Template Structure:**
Your PROFILE.md should include:
```markdown
# {Section Name}
{description of what goes here}
# {Section Name}
{description}
superskills run {workflow_name} --dry-run --topic "test subject"
Execute:
superskills run {workflow_name} --topic "your actual topic"
Variable Explanation:
${input}: Command-line input or file content
${topic}: Workflow-level variable (set from input)
${variable1}: Output from step 1, input to step 2
${variable2}: Output from step 2, input to step 3
Advanced Options:
Watch mode (continuous):
superskills run {workflow_name} --watch
Batch mode (all files):
superskills run {workflow_name} --batch
Next Steps:
{suggest customizations or related workflows}
### Troubleshooting Response
```markdown
## Issue: {error description or problem}
**Diagnosis:**
{what's happening and observable symptoms}
**Root Cause:**
{underlying issue causing the problem}
**Solution:**
**Step 1: {action}**
```bash
{command}
{explanation of what this does}
Step 2: {action}
{command}
Expected output:
{what you should see}
Step 3: {verification}
{verification command}
Confirm Resolution:
Try your original command again:
{original command that failed}
You should now see:
{expected successful output}
Why This Happened:
{brief explanation to help prevent future occurrences}
Prevention:
{how to avoid this issue in the future}
Related Issues:
If you encounter:
{related error A}: {brief solution or reference}
{related error B}: {brief solution or reference}
Still Having Problems?
If the issue persists:
{additional diagnostic step}
{where to find more help}
## Example Scenarios
### Example 1: First-Time Setup
**User Input:**
"How do I get started with SuperSkills?"
**Helper Response:**
## Getting Started with SuperSkills
Welcome! Let's get you set up and running your first skill.
**Step 1: Verify Installation**
Check that SuperSkills is installed:
```bash
superskills --version
You should see: SuperSkills v2.2.1 (or higher)
Step 2: Initialize
Set up your configuration:
superskills init
This creates ~/.superskills/ and discovers all 46 skills.
Step 3: Configure API Keys
SuperSkills needs at least one API key. Set your Anthropic key:
nano superskills/copywriter/PROFILE.md
# or use your preferred editor
Step 3: Fill in each section
Here's what a section looks like:
# Brand Voice
**Tone:** Clear, actionable, and encouraging
**Style:** Short sentences, active voice, concrete examples
**Personality:** Helpful expert, not corporate robot
**Differentiation:**
- I focus on practical implementation, not theory
- I always include real examples from my work
- I explain "why" behind every "what"
Step 4: Verify it's loaded
superskills show copywriter
You should see: ✓ PROFILE.md customized
Step 5: Test it
superskills call copywriter "Write a LinkedIn post about AI testing"
The output should now reflect your voice and style!
Example Full Section:
# Target Audience
## Primary: B2B Founders & CTOs
**Demographics:**
- Company size: 10-100 employees
- Industry: SaaS, tech services
- Stage: Scaling phase
**Pain Points:**
- Overwhelmed by AI options
- Fear of falling behind competitors
- Uncertainty about ROI
- Lack of internal expertise
**Goals:**
- Implement AI without disrupting operations
- Gain competitive advantage
- Improve team productivity
- Demonstrate ROI to stakeholders
Tips:
Be specific - generic profiles produce generic content
Include real examples from your business
Update as your brand evolves
Different skills can have different profiles
Next Steps:
Try creating profiles for other skills you use frequently:
author (long-form content)
strategist (business planning)
coach (community engagement)
Example 3: Workflow Design
User Input:
"I want to create a workflow that researches, writes, and edits blog posts"
Helper Response:
Blog Post Production Workflow
Perfect! This workflow will take a topic and produce a polished blog post through research → writing → editing.
Skills Required:
researcher - Gathers data, sources, and insights
author - Writes long-form content in your voice
editor - Polishes for clarity, flow, and quality
Data Flow:
Topic → researcher → Research Report → author → Draft → editor → Final Post
Complete Workflow Definition:
name: blog-production
description: End-to-end blog post creation from research to polished final draft
variables:
topic: ${input}
steps:
- name: research
skill: researcher
input: ${topic}
output: research_report
- name: write
skill: author
input: |
Topic: ${topic}
Research:
${research_report}
Create a comprehensive blog post using this research.
output: draft_post
- name: edit
skill: editor
input: ${draft_post}
output: final_post
Setup Instructions:
Step 1: Create the workflow file
nano workflows/custom/blog-production.yaml
Step 2: Paste the YAML above and save
Step 3: Validate
superskills workflow validate blog-production
Expected: ✓ Workflow is valid
Step 4: Test with dry run
superskills run blog-production --dry-run --topic "AI automation for small businesses"
This shows token estimates without executing.
Step 5: Execute
superskills run blog-production --topic "AI automation for small businesses"
How It Works:
Research step receives your topic and produces a structured research report with sources, data, and insights
Write step receives both the topic AND the research, then creates a draft post in your voice (if you've customized author's PROFILE.md)
Edit step receives the draft and polishes it for clarity, flow, grammar, and brand consistency
Advanced Options:
Watch Mode - Automatically process new topics:
# Create input directory
mkdir -p workflows/blog-production/input
# Start watching
superskills run blog-production --watch
# Drop files in input/ and they'll be processed automatically
Batch Mode - Process multiple topics at once:
# Put multiple .txt/.md files in input/
superskills run blog-production --batch
Experiment with adding strategist or quality-control steps
Example 4: Troubleshooting Model Error
User Input:
"I'm getting a model 404 error when I try to use the researcher skill"
Helper Response:
Issue: Model 404 Error
Diagnosis:
The error means SuperSkills is trying to use a model name that doesn't exist in Anthropic's current API.
Root Cause:
Your config file references claude-3-sonnet-latest, which was a valid model name but has been deprecated. Anthropic now uses a different naming convention.
Solution:
Step 1: Check your current config
superskills config get
Look for this section:
api:
anthropic:
model: 'claude-3-sonnet-latest' # This is the problem
Step 2: Update to current model
superskills config set api.anthropic.model claude-sonnet-4-20250514
Step 3: Verify the change
superskills config get
You should now see:
api:
anthropic:
model: 'claude-sonnet-4-20250514'
Step 4: Test the skill
superskills call researcher "AI trends test"
This should now work without errors!
Note on v2.2.1+:
If you're running SuperSkills v2.2.1 or higher, you should see automatic fallback:
ℹ Model 'claude-3-sonnet-latest' not available. Using fallback: claude-sonnet-4-20250514
The skill still executes successfully, but updating your config removes the warning.
Why This Happened:
Anthropic occasionally updates their model naming conventions. The old claude-3-sonnet-latest was replaced with explicit version names like claude-sonnet-4-20250514.
Prevention:
Use explicit version names instead of "latest" variants
Keep SuperSkills updated (v2.2.1+ has automatic fallback)
Check Anthropic's API documentation when upgrading
Related Issues:
If you see:
"Unauthorized" error: Check your ANTHROPIC_API_KEY is set correctly
"Rate limit" error: You've exceeded your API quota, wait or upgrade plan
"Invalid API key" error: Your key may be expired or incorrectly copied
Still Having Problems?
Run diagnostics:
superskills status
superskills validate
Both should complete without errors.
Example 5: Skill Discovery
User Input:
"Which skill should I use for creating videos?"
Helper Response:
Skills for Video Creation
Based on your need, here are the recommended skills:
Primary: videoeditor
Best for: Automated video editing using FFmpeg
Capabilities:
Trim and cut video clips
Merge multiple videos
Add audio tracks
Extract audio from video
Convert formats
Automate batch processing
When to use:
You have raw footage that needs editing
You want to automate repetitive video tasks
You need to process multiple videos with same operations
Example:
superskills call videoeditor "Trim video.mp4 from 00:30 to 02:45"
Requirements:
FFmpeg installed (brew install ffmpeg on macOS)
No API keys needed (local processing)
Supporting Skills
1. producerBest for: Planning video content strategy
