Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
6 changes: 3 additions & 3 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
{
"name": "superpowers",
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
"version": "3.2.3",
"description": "Comprehensive skills library for Claude Code: TDD, debugging, collaboration, automation, document creation (Word/PDF/Excel/PowerPoint), creative tools, business research, productivity workflows, and AI prompt engineering for Veo3, Midjourney, DALL-E, Flux, Stable Diffusion, Claude, ChatGPT, and Gemini",
"version": "3.7.0",
"author": {
"name": "Jesse Vincent",
"email": "[email protected]"
},
"homepage": "https://github.com/obra/superpowers",
"repository": "https://github.com/obra/superpowers",
"license": "MIT",
"keywords": ["skills", "tdd", "debugging", "collaboration", "best-practices", "workflows"]
"keywords": ["skills", "tdd", "debugging", "collaboration", "best-practices", "workflows", "playwright", "ios", "automation", "productivity", "documents", "pdf", "word", "excel", "powerpoint", "creative", "business", "research", "notebooklm", "prompt-engineering", "ai-prompts", "veo3", "midjourney", "dalle", "stable-diffusion"]
}
36 changes: 36 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,12 @@ A comprehensive skills library of proven techniques, patterns, and workflows for
- **Debugging Skills** - Systematic debugging, root cause tracing, verification
- **Collaboration Skills** - Brainstorming, planning, code review, parallel agents
- **Development Skills** - Git worktrees, finishing branches, subagent workflows
- **Automation Skills** - Playwright browser testing, iOS simulator automation
- **Productivity Skills** - File organization, Gmail automation, Notion integration
- **Document Skills** - Word, PDF, Excel, PowerPoint creation and manipulation
- **Creative & Media Skills** - Visual design, image enhancement, GIFs, video downloads
- **Business & Research Skills** - Lead research, competitor analysis, NotebookLM integration
- **AI Prompt Engineering** - Expert techniques for Veo3, Midjourney, DALL-E, Flux, Stable Diffusion, Claude, ChatGPT, Gemini
- **Meta Skills** - Creating, testing, and sharing skills

Plus:
Expand Down Expand Up @@ -105,6 +111,36 @@ Skills activate automatically when relevant. For example:
- **testing-skills-with-subagents** - Validate skill quality
- **using-superpowers** - Introduction to the skills system

**Automation** (`skills/automation/`)
- **playwright-browser-automation** - Browser testing and automation with Playwright
- **ios-simulator-testing** - iOS app testing with accessibility-first navigation

**Productivity** (`skills/productivity/`)
- **file-organizer** - Intelligent file and folder organization with duplicate detection
- **gmail-intelligence** - Analyze Gmail data, process email threads, and automate workflows
- **notion-template-processor** - Fill Notion database templates and deliver via email

**Document Skills** (`skills/documents/`)
- **docx** - Create and edit Word documents with tracked changes and formatting
- **pdf** - Extract text/tables, create, merge, and split PDFs
- **xlsx** - Create Excel spreadsheets with formulas and data analysis
- **pptx** - Create PowerPoint presentations with layouts and charts

**Creative & Media** (`skills/creative/`)
- **canvas-design** - Visual art creation in PNG and PDF formats
- **image-enhancer** - Upscale and improve image resolution and clarity
- **slack-gif-creator** - Create animated GIFs optimized for Slack
- **theme-factory** - Apply professional themes to documents and slides
- **video-downloader** - Download videos from multiple platforms

**Business & Research** (`skills/business/`)
- **lead-research-assistant** - Identify and qualify potential business leads
- **competitive-ads-extractor** - Analyze competitor advertising strategies
- **notebooklm** - Query NotebookLM for source-grounded, citation-backed answers

**AI Prompt Engineering** (`skills/`)
- **prompt-engineer** - Expert prompt engineering for video generation (Veo3), image creation (Midjourney, DALL-E, Flux, Stable Diffusion), and conversational AI (Claude, ChatGPT, Gemini) with platform-specific techniques, parameters, and best practices

### Commands

All commands are thin wrappers that activate the corresponding skill:
Expand Down
56 changes: 56 additions & 0 deletions create-skill-zips.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
#!/bin/bash
# Script to create ZIP files for all Claude Code skills

SKILLS_DIR="/home/user/superpowers/skills"
OUTPUT_DIR="/home/user/superpowers/skill-zips"

Comment on lines +4 to +6
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

Hardcoded paths prevent portability and CI/CD integration.

The script hardcodes absolute paths for SKILLS_DIR and OUTPUT_DIR tied to a specific development machine (/home/user/superpowers), making the script unusable in different environments, CI/CD pipelines, or by other team members.

Use environment variables with defaults to enable portability:

#!/bin/bash
SKILLS_DIR="${SKILLS_DIR:-./skills}"
OUTPUT_DIR="${OUTPUT_DIR:-./skill-zips}"

Alternatively, accept paths as command-line arguments:

#!/bin/bash
SKILLS_DIR="${1:-./ skills}"
OUTPUT_DIR="${2:-./skill-zips}"

This allows users to either set environment variables or pass arguments when invoking the script.

🤖 Prompt for AI Agents
In create-skill-zips.sh around lines 4 to 6 the SKILLS_DIR and OUTPUT_DIR are
hardcoded to a single developer's absolute paths which breaks portability and
CI; update the script to accept environment variables with sensible defaults or
command-line arguments (use parameter expansion to default to ./skills and
./skill-zips or read $1 and $2 with fallbacks) and ensure any downstream
references use those variables so the script can run in CI and on other
machines.

# Create output directory
mkdir -p "$OUTPUT_DIR"

echo "Creating ZIP files for all skills..."
echo "======================================"

# Counter
count=0

# Loop through each directory in skills/ (excluding the 'commands' folder)
for skill_dir in "$SKILLS_DIR"/*; do
# Skip if not a directory
if [ ! -d "$skill_dir" ]; then
continue
fi

# Get the skill name (directory name)
skill_name=$(basename "$skill_dir")

# Skip the 'commands' folder as it's not a skill
if [ "$skill_name" = "commands" ]; then
echo "Skipping: $skill_name (not a skill)"
continue
fi

# Check if SKILL.md exists
if [ ! -f "$skill_dir/SKILL.md" ]; then
echo "WARNING: $skill_name missing SKILL.md - skipping"
continue
fi

# Create ZIP file
zip_file="$OUTPUT_DIR/${skill_name}.zip"

echo -n "Creating $skill_name.zip... "

# Change to skills directory and zip the skill folder
cd "$SKILLS_DIR" || exit 1
zip -r -q "$zip_file" "$skill_name"

if [ $? -eq 0 ]; then
echo "✓ Done"
((count++))
else
echo "✗ Failed"
fi
done

echo "======================================"
echo "Created $count skill ZIP files in $OUTPUT_DIR"
108 changes: 108 additions & 0 deletions skill-zips/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
# Superpowers Skill ZIP Files

This directory contains pre-packaged ZIP files for all Superpowers skills, ready for installation in Claude Desktop or Claude Code.

## Installation for Claude Desktop

### Option 1: Install Individual Skills

Copy the skill ZIP file to your Claude Desktop skills directory:

```bash
# On macOS
cp <skill-name>.zip ~/Library/Application\ Support/Claude/skills/

# On Linux
cp <skill-name>.zip ~/.config/Claude/skills/

# On Windows
copy <skill-name>.zip %APPDATA%\Claude\skills\
```

Then extract it in the skills directory.

### Option 2: Install All Skills

```bash
# On macOS
cp *.zip ~/Library/Application\ Support/Claude/skills/
cd ~/Library/Application\ Support/Claude/skills/
for f in *.zip; do unzip -q "$f"; done

# On Linux
cp *.zip ~/.config/Claude/skills/
cd ~/.config/Claude/skills/
for f in *.zip; do unzip -q "$f"; done
```

## Available Skills (37 Total)

### Testing (3 skills)
- `test-driven-development.zip` - RED-GREEN-REFACTOR cycle
- `condition-based-waiting.zip` - Async test patterns
- `testing-anti-patterns.zip` - Common pitfalls to avoid

### Debugging (4 skills)
- `systematic-debugging.zip` - 4-phase root cause process
- `root-cause-tracing.zip` - Find the real problem
- `verification-before-completion.zip` - Ensure it's actually fixed
- `defense-in-depth.zip` - Multiple validation layers

### Collaboration (9 skills)
- `brainstorming.zip` - Socratic design refinement
- `writing-plans.zip` - Detailed implementation plans
- `executing-plans.zip` - Batch execution with checkpoints
- `dispatching-parallel-agents.zip` - Concurrent subagent workflows
- `requesting-code-review.zip` - Pre-review checklist
- `receiving-code-review.zip` - Responding to feedback
- `using-git-worktrees.zip` - Parallel development branches
- `finishing-a-development-branch.zip` - Merge/PR decision workflow
- `subagent-driven-development.zip` - Fast iteration with quality gates

### Automation (2 skills)
- `playwright-browser-automation.zip` - Browser testing with Playwright
- `ios-simulator-testing.zip` - iOS app testing with accessibility automation

### Productivity (3 skills)
- `file-organizer.zip` - Intelligent file and folder organization with duplicate detection
- `gmail-intelligence.zip` - Analyze Gmail data, process email threads, and automate workflows
- `notion-template-processor.zip` - Fill Notion database templates and deliver via email

### Document Skills (4 skills)
- `docx.zip` - Create and edit Word documents with tracked changes and formatting
- `pdf.zip` - Extract text/tables, create, merge, and split PDFs
- `xlsx.zip` - Create Excel spreadsheets with formulas and data analysis
- `pptx.zip` - Create PowerPoint presentations with layouts and charts

### Creative & Media (5 skills)
- `canvas-design.zip` - Visual art creation in PNG and PDF formats
- `image-enhancer.zip` - Upscale and improve image resolution and clarity
- `slack-gif-creator.zip` - Create animated GIFs optimized for Slack
- `theme-factory.zip` - Apply professional themes to documents and slides
- `video-downloader.zip` - Download videos from multiple platforms

### Business & Research (3 skills)
- `lead-research-assistant.zip` - Identify and qualify potential business leads
- `competitive-ads-extractor.zip` - Analyze competitor advertising strategies
- `notebooklm.zip` - Query NotebookLM for source-grounded, citation-backed answers

### Meta (4 skills)
- `writing-skills.zip` - Create new skills following best practices
- `sharing-skills.zip` - Contribute skills back via branch and PR
- `testing-skills-with-subagents.zip` - Validate skill quality
- `using-superpowers.zip` - Introduction to the skills system

## Regenerating ZIP Files

If you need to regenerate these ZIP files (after making changes to skills):

```bash
cd /home/user/superpowers
./create-skill-zips.sh
```

This will recreate all ZIP files in this directory.

## License

See individual skill licenses. Most skills are MIT licensed.
Binary file added skill-zips/brainstorming.zip
Binary file not shown.
Binary file added skill-zips/canvas-design.zip
Binary file not shown.
Binary file added skill-zips/competitive-ads-extractor.zip
Binary file not shown.
Binary file added skill-zips/condition-based-waiting.zip
Binary file not shown.
Binary file added skill-zips/defense-in-depth.zip
Binary file not shown.
Binary file added skill-zips/dispatching-parallel-agents.zip
Binary file not shown.
Binary file added skill-zips/docx.zip
Binary file not shown.
Binary file added skill-zips/executing-plans.zip
Binary file not shown.
Binary file added skill-zips/file-organizer.zip
Binary file not shown.
Binary file added skill-zips/finishing-a-development-branch.zip
Binary file not shown.
Binary file added skill-zips/gmail-intelligence.zip
Binary file not shown.
Binary file added skill-zips/image-enhancer.zip
Binary file not shown.
Binary file added skill-zips/ios-simulator-testing.zip
Binary file not shown.
Binary file added skill-zips/landing-page-expert.zip
Binary file not shown.
Binary file added skill-zips/lead-research-assistant.zip
Binary file not shown.
Binary file added skill-zips/notebooklm.zip
Binary file not shown.
Binary file added skill-zips/notion-template-processor.zip
Binary file not shown.
Binary file added skill-zips/pdf.zip
Binary file not shown.
Binary file added skill-zips/playwright-browser-automation.zip
Binary file not shown.
Binary file added skill-zips/pptx.zip
Binary file not shown.
Binary file added skill-zips/prompt-engineer.zip
Binary file not shown.
Binary file added skill-zips/receiving-code-review.zip
Binary file not shown.
Binary file added skill-zips/requesting-code-review.zip
Binary file not shown.
Binary file added skill-zips/root-cause-tracing.zip
Binary file not shown.
Binary file added skill-zips/sharing-skills.zip
Binary file not shown.
Binary file added skill-zips/slack-gif-creator.zip
Binary file not shown.
Binary file added skill-zips/subagent-driven-development.zip
Binary file not shown.
Binary file added skill-zips/systematic-debugging.zip
Binary file not shown.
Binary file added skill-zips/test-driven-development.zip
Binary file not shown.
Binary file added skill-zips/testing-anti-patterns.zip
Binary file not shown.
Binary file added skill-zips/testing-skills-with-subagents.zip
Binary file not shown.
Binary file added skill-zips/theme-factory.zip
Binary file not shown.
Binary file added skill-zips/using-git-worktrees.zip
Binary file not shown.
Binary file added skill-zips/using-superpowers.zip
Binary file not shown.
Binary file added skill-zips/verification-before-completion.zip
Binary file not shown.
Binary file added skill-zips/video-downloader.zip
Binary file not shown.
Binary file added skill-zips/writing-plans.zip
Binary file not shown.
Binary file added skill-zips/writing-skills.zip
Binary file not shown.
Binary file added skill-zips/xlsx.zip
Binary file not shown.
Loading