Skip to content

epistex-dev/poteto-kit / templates/skills/are-you-sure-you-need-x

are-you-sure-you-need-x

Verified

Challenge skill. Use when you are about to reach for a risky API or pattern ({{RISKY_LIST}}, for example requestAnimationFrame, useEffect, setTimeout polling, global mutable state, manual DOM access). Asks for evidence that it is needed, lists safer alternatives, and states what the PR must show if you proceed.

Are you sure you need {{API}}?

You are about to use {{API}}. It is risky because: {{WHY_RISKY}} (for example: it runs outside the framework's render cycle, it is easy to leak, it regresses frame time on every user and nothing catches it in CI).

Most of the time you do not need it. Work through this before you write it.

1. State the need

Write one sentence: "I need {{API}} because ." If the sentence is about how the code is structured or about convenience, you do not need it.

2. Show the evidence

Provide at least one of, as {{EVIDENCE_REQUIRED}}:

  • A reproduction in the running app (use verify-app) showing the behavior the alternatives fail to produce: screenshot, trace or measurement.
  • A measurement showing the alternative is too slow or wrong (numbers, not impressions).
  • A link to the documented constraint of the platform or library that forces it.

"It is simpler", "the existing code does it elsewhere" and "the agent usually does it" are not evidence. Copying a nearby use is how it spread.

3. Try the safer alternatives first

{{ALTERNATIVES}} Examples, adapt to the API:

Reaching forSafer alternative to try
requestAnimationFrame loopCSS transitions or animations; the framework's animation primitive; a single event-driven update
useEffect to derive statecompute during render; memoize; handle it in the event handler
useEffect to fetch datathe project's data-fetching primitive ({{DATA_FETCHING_APPROACH}})
polling with setTimeoutsubscribe to the event or stream that signals the change
global mutable statethe single owned store with commands (one writer per value)

For each alternative you rule out, say why, with a concrete observation.

4. If you proceed, the PR must show

  • The one-sentence need and the evidence from step 2.
  • Which alternatives were tried and why they failed.
  • The cleanup and failure handling (cancellation, unmount, error) for {{API}}, in the code.
  • A before and after measurement or evidence report (verify-app) showing no regression in {{WHAT_TO_MEASURE}} (for example long tasks (>50 ms, Long Tasks API) and frames over the 16.7 ms budget in the trace, reported separately).
  • A narrow, explicit exception if a lint rule blocks it, reviewed as an architecture change, with the reason in the PR (not in a code comment that narrates history).

If you cannot show the evidence

Use the alternative, or stop and report what you would need to measure. Do not use {{API}} on the assumption that you will justify it later.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall