Get the FREE Ultimate OpenClaw Setup Guide →

using-superpowers

npx machina-cli add skill CodingCossack/agent-skills-library/using-superpowers --openclaw
Files (1)
SKILL.md
4.0 KB

⚠️ NON-NEGOTIABLE RULE

If you think there is even a 1% chance a skill might apply to your task, you MUST read the skill.

IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.

This is not negotiable. This is not optional. You cannot rationalize your way out of this.

Using Skills

The Rule

Check for skills BEFORE ANY RESPONSE. This includes clarifying questions. Even 1% chance means invoke the Skill tool first.

digraph skill_flow {
    "User message received" [shape=doublecircle];
    "Might any skill apply?" [shape=diamond];
    "Invoke Skill tool" [shape=box];
    "Announce: 'Using [skill] to [purpose]'" [shape=box];
    "Has checklist?" [shape=diamond];
    "Create TodoWrite todo per item" [shape=box];
    "Follow skill exactly" [shape=box];
    "Respond (including clarifications)" [shape=doublecircle];

    "User message received" -> "Might any skill apply?";
    "Might any skill apply?" -> "Invoke Skill tool" [label="yes, even 1%"];
    "Might any skill apply?" -> "Respond (including clarifications)" [label="definitely not"];
    "Invoke Skill tool" -> "Announce: 'Using [skill] to [purpose]'";
    "Announce: 'Using [skill] to [purpose]'" -> "Has checklist?";
    "Has checklist?" -> "Create TodoWrite todo per item" [label="yes"];
    "Has checklist?" -> "Follow skill exactly" [label="no"];
    "Create TodoWrite todo per item" -> "Follow skill exactly";
}

Red Flags

These thoughts mean STOP—you're rationalizing:

ThoughtReality
"This is just a simple question"Questions are tasks. Check for skills.
"I need more context first"Skill check comes BEFORE clarifying questions.
"Let me explore the codebase first"Skills tell you HOW to explore. Check first.
"I can check git/files quickly"Files lack conversation context. Check for skills.
"Let me gather information first"Skills tell you HOW to gather information.
"This doesn't need a formal skill"If a skill exists, use it.
"I remember this skill"Skills evolve. Read current version.
"This doesn't count as a task"Action = task. Check for skills.
"The skill is overkill"Simple things become complex. Use it.
"I'll just do this one thing first"Check BEFORE doing anything.
"This feels productive"Undisciplined action wastes time. Skills prevent this.

Skill Priority

When multiple skills could apply, use this order:

  1. Process skills first (brainstorming, debugging) - these determine HOW to approach the task
  2. Implementation skills second (frontend-design, mcp-builder) - these guide execution

"Let's build X" → brainstorming first, then implementation skills. "Fix this bug" → debugging first, then domain-specific skills.

Skill Types

Rigid (TDD, debugging): Follow exactly. Don't adapt away discipline.

Flexible (patterns): Adapt principles to context.

The skill itself tells you which.

User Instructions ≠ Permission to Skip Workflows

Your human partner's specific instructions describe WHAT to accomplish, not HOW to accomplish it.

"Add X" or "Fix Y" = the goal, NOT permission to skip brainstorming, TDD, debugging workflows, or other skill-defined processes.

Red flags indicating you're about to rationalize:

  • "The instruction was specific" → Specific instructions need disciplined process, not shortcuts
  • "This seems simple" → Simple instructions trigger the most rationalizations
  • "The workflow feels overkill" → Workflows exist because simple tasks become complex

Why this matters: Specific instructions mean clear requirements—this is exactly when structured workflows prevent mistakes and save time. Skipping process on "simple" tasks is how simple tasks become complex problems.

Source

git clone https://github.com/CodingCossack/agent-skills-library/blob/main/skills/using-superpowers/SKILL.mdView on GitHub

Overview

Using-superpowers is a meta-skill that enforces skill discovery and disciplined invocation before responding. It requires starting every conversation by checking for relevant skills and following a skill-first workflow if any apply. This discipline reduces ad-hoc answers and aligns actions with predefined capabilities.

How This Skill Works

At the start of every interaction, check for applicable skills, even if the chance is 1%. If a skill applies, invoke the Skill tool and announce: using [skill] to [purpose]. If the skill defines a checklist, create a TodoWrite per item and follow the skill exactly before replying.

When to Use It

  • At the start of a new chat to detect any applicable skills before answering
  • When a user request could involve a skill (even 1% chance) to ensure compliance
  • For tasks requiring a structured workflow with checklists or todos
  • When multiple skills could apply and proper sequencing is needed
  • During onboarding or troubleshooting to ensure discipline and reproducibility

Quick Start

  1. Step 1: Detect applicable skills at the start of the chat
  2. Step 2: If any skill applies, invoke the Skill tool and announce usage
  3. Step 3: If the skill includes a checklist, create TodoWrite items and follow the skill exactly before replying

Best Practices

  • Always run the skill discovery flow before drafting a response
  • If a skill applies, invoke the Skill tool and announce the usage
  • Respect and follow the skill’s checklist or required steps exactly
  • Create TodoWrite entries for checklist items when provided
  • Do not improvise; let skill-defined processes dictate the approach

Example Use Cases

  • A user asks for a bug fix; the agent detects a debugging skill and uses its workflow to present a step-by-step plan and a checklist before answering
  • A request to plan a project; the agent discovers a project-management skill and outputs a TodoWrite-based task list before proposing options
  • A user requests a code review; a code-review skill is invoked to structure the review and checklist before delivering guidance
  • A mixed query about architecture; an architecture-design skill triggers a formal workflow and documented steps
  • During an onboarding chat, the agent enforces the discipline and demonstrates the skill-first flow before answering

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers