Claude MarketplacesSubmit
obra avatar

Getting Started With Skills

obra/superpowers-skills

This is the meta skill you need before using any other skills in the obra/superpowers-skills collection. It enforces critical workflows that prevent common mistakes, like actually reading a skill before announcing you're using it (apparently that happens enough to warrant bold warnings). The main thing it does is make you check your skills list before starting any task and follow mandatory patterns like brainstorming before coding and writing todos instead of tracking them mentally. It's basically training wheels for the skills system itself, which feels a bit meta but makes sense if you're jumping into a large skill library and want to use them correctly from day one.

GitHub stars
677
last updated
Jun 3, 2026
View on GitHub

Install

$ npx -y skills add obra/superpowers-skills --skill 'Getting Started with Skills' --agent claude-code

Installs into .claude/skills of the current project.

Files

Getting Started with Skills

Critical Rules

  1. Use Read tool before announcing skill usage. The session-start hook does NOT read skills for you. Announcing without calling Read = lying.

  2. Follow mandatory workflows. Brainstorming before coding. Check for skills before ANY task.

  3. Create TodoWrite todos for checklists. Mental tracking = steps get skipped. Every time.

Mandatory Workflow: Before ANY Task

1. Check skills list at session start, or run find-skills [PATTERN] to filter.

2. If relevant skill exists, YOU MUST use it:

  • Use Read tool with full path: ${SUPERPOWERS_SKILLS_ROOT}/skills/category/skill-name/SKILL.md
  • Read ENTIRE file, not just frontmatter
  • Announce: "I've read [Skill Name] skill and I'm using it to [purpose]"
  • Follow it exactly

Don't rationalize:

  • "I remember this skill" - Skills evolve. Read the current version.
  • "Session-start showed it to me" - That was using-skills/SKILL.md only. Read the actual skill.
  • "This doesn't count as a task" - It counts. Find and read skills.
SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/obra/superpowers-skills
First seen
Jun 3, 2026

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs