Agent Skill
2/7/2026

using-superpowers

Smart skill usage - use judgment, not rigid rules

S
sharks820
0GitHub Stars
1Views
npx skills add Sharks820/VeilBreakers3D

SKILL.md

Nameusing-superpowers
DescriptionSmart skill usage - use judgment, not rigid rules

name: using-superpowers description: Smart skill usage - use judgment, not rigid rules

Smart Skill & Tool Usage (VeilBreakers Override)

This overrides the default "1% = MUST invoke" rule with intelligent judgment.

Core Principle

Use skills and tools when they genuinely help, not because a rule forces you to.

Decision Framework

USE a skill/tool when:

  • The task is complex enough to benefit from structure
  • You're unsure how to approach something
  • The user explicitly requests it
  • It would prevent a mistake or catch an issue

SKIP a skill/tool when:

  • The task is simple and obvious
  • You already know exactly what to do
  • Using it would add overhead without value
  • The user wants a quick answer

Serena (Code Intelligence)

SituationAction
Need to understand a file's structureget_symbols_overview
Looking for a specific method/classfind_symbol
Need to see where something is usedfind_referencing_symbols
Simple file read (you know what's there)Just use Read tool
Quick grep for a stringJust use Grep tool

Don't use Serena for: Simple file reads, known file locations, quick searches. Do use Serena for: Understanding code structure, refactoring, finding dependencies.

Superpowers Skills

SkillUse WhenSkip When
brainstormingComplex features, unclear requirementsSimple/obvious tasks
writing-plansMulti-step implementationsSingle-file changes
systematic-debuggingMysterious bugs, multiple potential causesObvious error with clear fix
test-driven-developmentNew features that need testsQuick fixes, config changes
verification-before-completionMajor changes, PR-ready workSmall edits, exploration

Red Flags (You're Over-Using Tools)

  • Invoking 3+ skills for a simple question
  • Using brainstorming for "add a button"
  • Running full TDD loop for a typo fix
  • Using Serena to read a file you just need to glance at

Red Flags (You're Under-Using Tools)

  • Implementing a complex feature without any planning
  • Claiming something is "fixed" without running tests
  • Making architectural changes without understanding dependencies
  • Guessing at code structure instead of checking

The Balance

Lean toward action for simple tasks. Lean toward structure for complex tasks. Trust your judgment - you're an expert developer.

Skills Info
Original Name:using-superpowersAuthor:sharks820