New Features

Skills Repository Infrastructure

Automatic Clone & Setup (lib/initialize-skills.sh)

• Clones obra/superpowers-skills on first run
• Offers fork creation if GitHub CLI is installed
• Sets up upstream/origin remotes correctly
• Handles migration from old installation

Auto-Update

• Fetches from tracking remote on every session start
• Auto-merges with fast-forward when possible
• Notifies when manual sync needed (branch diverged)
• Uses pulling-updates-from-skills-repository skill for manual sync

New Skills

Problem-Solving Skills (skills/problem-solving/)

• collision-zone-thinking - Force unrelated concepts together for emergent insights
• inversion-exercise - Flip assumptions to reveal hidden constraints
• meta-pattern-recognition - Spot universal principles across domains
• scale-game - Test at extremes to expose fundamental truths
• simplification-cascades - Find insights that eliminate multiple components
• when-stuck - Dispatch to right problem-solving technique

Research Skills (skills/research/)

• tracing-knowledge-lineages - Understand how ideas evolved over time

Architecture Skills (skills/architecture/)

• preserving-productive-tensions - Keep multiple valid approaches instead of forcing premature resolution

Skills Improvements

using-skills (formerly getting-started)

• Renamed from getting-started to using-skills
• Complete rewrite with imperative tone (v4.0.0)
• Front-loaded critical rules
• Added "Why" explanations for all workflows
• Always includes /SKILL.md suffix in references
• Clearer distinction between rigid rules and flexible patterns

writing-skills

• Cross-referencing guidance moved from using-skills
• Added token efficiency section (word count targets)
• Improved CSO (Claude Search Optimization) guidance

sharing-skills

• Updated for new branch-and-PR workflow (v2.0.0)
• Removed personal/core split references

pulling-updates-from-skills-repository (new)

• Complete workflow for syncing with upstream
• Replaces old "updating-skills" skill

Tools Improvements

find-skills

• Now outputs full paths with /SKILL.md suffix
• Makes paths directly usable with Read tool
• Updated help text

skill-run

• Moved from scripts/ to skills/using-skills/
• Improved documentation

Plugin Infrastructure

Session Start Hook

• Now loads from skills repository location
• Shows full skills list at session start
• Prints skills location info
• Shows update status (updated successfully / behind upstream)
• Moved "skills behind" warning to end of output

Environment Variables

• SUPERPOWERS_SKILLS_ROOT set to ~/.config/superpowers/skills
• Used consistently throughout all paths