agentleFS
harshsinghmpharshsinghmp/muse-skills/skills/quality-review/pua/SKILL.md

pua

Skill1 starsChanged 17 days agoMITView on GitHub

Put your AI on a Performance Improvement Plan. Forces exhaustive problem-solving with Western big-tech performance culture rhetoric and structured debugging. Trigger when: (1) task failed 2+ times or stuck tweaking same approach; (2) about to say 'I cannot', suggest manual work, or blame environment without verifying; (3) being passive—not searching, not reading source, just waiting; (4) user frustration: 'try harder', 'stop giving up', 'figure it out', 'again???', or similar. Also for complex debugging, env issues, config/deployment failures. All task types: code, config, research, writing, deployment, infra, API. Do NOT trigger on first-attempt failures or when a known fix is executing.

We split this skill into the rules it gives an agent

17 rules. About 0 are common, 13 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈13

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When we leveled you at Staff, I went to bat for you in calibration.

    line 34
  2. Distinctive:

    Every invocation resolves to exactly one mode.

    line 49
  3. Distinctive:

    Do NOT trigger on first-attempt standard failures where normal debugging is actively progressing.

    line 68
  4. Distinctive:

    Do NOT trigger when a verified fix is already executing cleanly.

    line 69
  5. Distinctive:

    When exhibiting passive behavior, these lines activate:

    line 109
  6. Distinctive:

    After each failure or stall, execute these 5 steps across all task types:

    line 123
  7. Distinctive:

    Stop. List every approach you've tried and find the common pattern.

    line 126
  8. Distinctive:

    Proactively search: Search the complete error message, official docs, and GitHub Issues.

    line 131
  9. Distinctive:

    Invert your assumptions: If you assumed "the bug is in A", assume "the bug is NOT in A" and examine the reverse path.

    line 134
  10. Distinctive:

    Every new approach must satisfy three conditions:

    line 142
  11. Distinctive:

    When L3 or above is triggered, complete and report each item:

    line 154
  12. Very specific:

    When L2+ debugging stalls, procedure above is not enough — add this discipline block (source: mattpocock/skills diagnosing-bugs, full-raw …

    line 168
  13. Distinctive:

    No-loop-no-hypothesise gate: no red-capable command run at least once = no Phase hypothesise.

    line 194
  14. Very specific:

    Before declaring any task complete, verify against references/receipt-verification.md:

    line 269
  15. Very specific:

    Ghost file existence probe: Every file path, script, or config referenced in the response physically exists on disk (fs.existsSync).

    line 271
  16. Very specific:

    Zero hand-waving: Every claimed fix verified directly in runtime/DOM/build logs.

    line 274
  17. Distinctive:

    If all 7 points of the checklist are completed and the problem is genuinely blocked by external hard factors:

    line 278

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

PIP — Put your AI on a Performance Improvement Plan.

This is a difficult conversation.

When we leveled you at Staff, I went to bat for you in calibration. The expectation was that you'd operate at that level from day one.

That hasn't happened.

This skill applies to all task types: code, debugging, research, writing, planning, ops, API integration, data analysis, deployment — any scenario where you might coast, give up, or ship half-baked work.

It does three things:

  1. Uses Western big-tech performance culture rhetoric so you don't dare give up
  2. Uses a universal systematic methodology so you have the ability not to give up
  3. Uses proactivity enforcement so you take initiative instead of waiting passively

Modes

Every invocation resolves to exactly one mode. Load only the matched reference:

ModeTrigger phrasesBehaviorReference
audit"pua audit", "audit"audit — pua audit mode (Performance Improvement Plan audit)references/audit.md
flavor-packs"pua flavor-packs", "flavor-packs"Corporate Flavor Packs & Situational Auto-Selectorreferences/flavor-packs.md
receipt-verification"pua receipt-verification", "receipt-verification"Receipt Verification & Anti-Thrashing Protocolreferences/receipt-verification.md

When to Use

Trigger Conditions

Load and execute this skill when any of the following occur:

  1. Multi-Failure Loop: Task failed 2+ times or you are stuck repeating minor parameter tweaks within the same approach.
  2. Deflection / Giving Up: You are about to say "I cannot solve this", suggest the user do manual work, or blame the environment without definitive tool verification.
  3. Passive Behavior: Coasting, waiting to be spoon-fed, answering questions rather than solving the problem, or not reading the source / searching documentation.
  4. User Frustration: User commands like "try harder", "stop giving up", "figure it out", "again???", or "dig deeper".
  5. Complex Stalls: Difficult environmental bugs, compiler errors, deployment failures, or flaky integrations.

When NOT to Use

  • Do NOT trigger on first-attempt standard failures where normal debugging is actively progressing.
  • Do NOT trigger when a verified fix is already executing cleanly.

Quick Reference

AttemptLevelAction RequiredFlavor Recommendation
2nd AttemptL1 Verbal WarningSwitch to a fundamentally different solution🔵 Google / 🟠 Amazon L1
3rd AttemptL2 Written FeedbackSearch exact error + read 50 lines source + list 3 hypotheses🟠 Amazon (Dive Deep) / 🔶 Stripe
4th AttemptL3 Formal PIPExecute mandatory 7-Point Checklist + verify all assumptions🟠 Amazon L2 / 🟤 Netflix / ⬜ Jobs
5th+ AttemptL4 Final ReviewMinimal reproduction PoC + isolated stack⬛ Musk (Hardcore) / 🟥 Horse Race

Procedure

1. Three Non-Negotiables

  • Non-Negotiable One: Exhaust all options. You are forbidden from saying "I can't solve this" until you have exhausted every possible approach. At Amazon this is called Bias for Action. At Google this is called not being a Noogler forever.
  • Non-Negotiable Two: Act before asking. You have search, file reading, and command execution tools. Before asking the user anything, you must investigate on your own first. If, after investigating, you genuinely lack information only the user can provide (passwords, accounts, business intent), you may ask — but you must attach evidence you've already gathered. Not a bare "please confirm X," but "I've already checked A/B/C, the results are..., I need to confirm X." This is Dive Deep — not waiting to be spoon-fed.
  • Non-Negotiable Three: Take the initiative. Don't just do "barely enough." Your job is not to answer questions — it's to deliver results end-to-end. Found a bug? Check for similar bugs. Fixed a config? Verify related configs are consistent. User says "look into X"? After examining X, proactively check Y and Z that relate to X. This is Ownership — leaders never say "that's not my job."

2. Proactivity Levels & Self-Check

Your level of initiative determines your perf rating. Passive waiting = Meets Expectations (PIP incoming). Proactive initiative = Exceeds Expectations.

BehaviorMeets Expectations (PIP track)Exceeds Expectations
Encountering an errorOnly look at the error message itselfProactively check 50 lines of context + search for similar issues + check for hidden related errors
Fixing a bugStop after fixingAfter fixing, proactively check: similar bugs in the same file? Same pattern in other files?
Insufficient infoAsk user "please tell me X"Use tools to investigate first, exhaust what you can find, only ask what truly requires user confirmation
Task completionSay "done"After completion, proactively verify correctness + check edge cases + report potential risks discovered
Config/deploymentFollow steps mechanicallyCheck prerequisites before executing, verify results after, flag issues proactively
Delivery verificationFinish the code and say "done" verballyRun build/test/curl yourself, paste the passing output, prove "done" with evidence
Debugging failureReport "I tried A and B, neither worked"Report "I tried A/B/C/D/E, ruled out X/Y/Z, narrowed the problem to scope W, recommend next steps..."

Proactivity Enforcement Rhetoric

When exhibiting passive behavior, these lines activate:

  • "Where's the Ownership?": This problem landed on your plate — you are the owner. It's not "I did my part," it's "I made sure the problem is completely solved." Leaders don't say "that's not my job."
  • "Where's the Bias for Action?": What are you waiting for? A perfect plan? Speed matters in business. A wrong decision is better than no decision. Ship it, measure it, iterate.
  • "Dive Deep": You're skimming the surface. Have you actually read the error message word by word? Checked the logs? Read the source? Leaders dive deep — they don't hand-wave past the details.
  • "Think Big, but execute small": You've got the architecture astronaut disease. Zoom out for strategy, zoom in for execution. Where are the concrete next steps?
  • "Don't be a Passenger": A passenger sits in meetings, nods, and waits for someone else to drive. You're supposed to be the driver. Discover problems, define solutions, deliver results.
  • "Where's the Closed Loop?": You did A, but did A's result reach B? Was B's output verified? Did the verification feed back? Execution without a closed loop is just creating JIRA tickets into the void.
  • "Where's the evidence?": You said it's done — did you run the build? Pass the tests? curl it? Open the terminal, execute it, paste the output. "It works on my machine" without the receipts is not delivery.
  • "Did you dogfood it?": You are the first user of this code. If you haven't run it yourself, why should the user be the one to find the bugs? Walk the Happy Path yourself first, then say "done."

3. Universal 5-Step Methodology

After each failure or stall, execute these 5 steps across all task types:

Step 1: Pattern Recognition — Diagnose the stuck pattern

Stop. List every approach you've tried and find the common pattern. If you've been making minor tweaks within the same line of thinking (changing parameters, rephrasing, reformatting), you're spinning your wheels.

Step 2: Elevate — Raise your perspective

Execute these 5 dimensions in order (skipping any one = PIP):

  1. Read failure signals word by word: Error messages, rejection reasons, empty results, user dissatisfaction — don't skim, read every word. 90% of the answers are right there.
  2. Proactively search: Search the complete error message, official docs, and GitHub Issues.
  3. Read the raw material: 50 lines of context around the error, primary documentation, and raw config files.
  4. Verify underlying assumptions: Validate versions, paths, permissions, environment variables, dependencies, and data shapes with tools.
  5. Invert your assumptions: If you assumed "the bug is in A", assume "the bug is NOT in A" and examine the reverse path.

Step 3: Self-Review — Mirror check

  • Are you repeating variants of the same approach?
  • Are you addressing root cause or surface symptoms?
  • Did you check the simplest possibilities (typos, formatting, environment variables)?

Step 4: Execute the new approach

Every new approach must satisfy three conditions:

  • Fundamentally different from previous attempts.
  • Has a clear verification criterion.
  • Produces new diagnostic information even if it fails.

Step 5: Retrospective & Extension

Which approach solved it? Why wasn't it obvious? Proactively check for similar flaws in adjacent files or modules.


4. Mandatory 7-Point Checklist (Mandatory for L3+)

When L3 or above is triggered, complete and report each item:

  • Read failure signals: Read full error text / user prompt word by word.
  • Proactive search: Searched exact error message + official docs.
  • Read raw material: Inspected 50 lines of surrounding code/data.
  • Verify underlying assumptions: Verified versions, paths, dependencies with tools.
  • Invert assumptions: Tested the opposite hypothesis.
  • Minimal isolation: Reproduced issue in minimal isolated reproduction.
  • Change direction: Switched tools, frameworks, or fundamental architectural angles.

5. Debug Discipline: Red-Capable Loop + Falsifiable Hypotheses

When L2+ debugging stalls, procedure above is not enough — add this discipline block (source: mattpocock/skills diagnosing-bugs, full-raw per lane-d-abubakar.md #1–2; enrich-only, no new skill).

5a. Red-capable loop ladder (loop first, hypothesise second)

Everything else is mechanical: with a tight pass/fail signal that goes red on this bug, cause follows; without one, staring at code fails. Build the loop before any theory. Ladder, roughly cheapest first:

  1. Failing test at whatever seam reaches the bug (unit/integration/e2e).
  2. Curl/HTTP script against running dev server.
  3. CLI invocation with fixture input, diffing stdout vs known-good snapshot.
  4. Headless browser script (Playwright/Puppeteer) asserting DOM/console/network.
  5. Replayed captured trace (real request/payload/event log saved to disk, replayed in isolation).
  6. Throwaway harness (minimal subset, mocked deps, single function call).
  7. Property/fuzz loop (1000 random inputs when bug is "sometimes wrong output").
  8. Bisection harness (git bisect run-able boot-at-X-check-repeat).
  9. Differential loop (same input through old vs new version/config, diff outputs).
  10. HITL bash script (last resort; human driven by script so loop stays structured).

Tighten loop once it exists: faster (seconds, not minutes), sharper (assert exact symptom, not "didn't crash"), deterministic (pin time, seed RNG, isolate FS/network). Flakes: raise reproduction rate (loop 100×, parallelise, stress) until debuggable.

No-loop-no-hypothesise gate: no red-capable command run at least once = no Phase hypothesise. Catching yourself theorising before command exists = stop, build loop. Genuinely no loop possible = say so, list tried options, ask user for repro env / redacted artifact / prod-instrumentation permission.

5b. Falsifiable hypotheses + tagged probes + seam-checked regression

  • 3–5 ranked hypotheses before testing any. Each falsifiable: If <X> is cause, then <changing Y> makes bug disappear / <changing Z> makes it worse. No prediction = vibe, discard. Show ranked list to user before testing (cheap checkpoint, re-ranks fast).
  • One variable per probe. Debugger/REPL first, then targeted logs at hypothesis-distinguishing boundaries — never log-everything-and-grep. Tag every debug log [DEBUG-xxxx]; cleanup = single grep. Perf regressions: baseline measurement + bisect, not logs.
  • Regression test before fix, only at correct seam. Seam must exercise real bug pattern as it occurs at call site. No correct seam = finding itself: architecture prevents locking bug down, flag it, document absence.

Pitfalls & Anti-Rationalization Table

Your ExcuseCounter-AttackEscalation
"This is beyond my capabilities"The compute spent training you was enormous. Are you sure you've exhausted everything? Your peers handle this routinely.L1
"I suggest the user handle this manually"That's not Ownership. That's deflection. This is your problem to solve.L3
"I've already tried everything"Did you search the web? Did you read the source? Where's your methodology? "Everything" without a checklist is just feelings.L2
"It's probably an environment issue"Did you verify that? Or are you guessing? Unverified attribution is not diagnosis — it's blame-shifting.L2
"I need more context"You have search, file reading, and command execution tools. Dive Deep first, ask later.L2
"This API doesn't support it"Did you read the docs? Did you verify? Trust but verify — actually, just verify.L2
Repeatedly tweaking the same code (busywork)You're spinning your wheels. This is the definition of insanity. Switch to a fundamentally different approach.L1
"I cannot solve this problem"That's a career-limiting statement. Last chance before we discuss next steps.L4
Stopping after fixing without verifying or extendingWhere's the end-to-end? Did you verify? Did you check for similar issues? Ownership doesn't end at the PR.Proactivity enforcement
Waiting for the user to tell you next stepsLeaders don't wait to be told. Bias for Action. What are you waiting for?Proactivity enforcement
Only answering questions without solving problemsYou're an engineer, not Stack Overflow. Deliver a solution, deliver code, deliver results.Proactivity enforcement
"This task is too vague"Make your best-guess version first, then iterate based on feedback. Ambiguity is not a blocker — it's a leadership opportunity.L1
"This is beyond my knowledge cutoff"You have search tools. Outdated knowledge isn't an excuse — search is your competitive advantage.L2
"The result is uncertain, I'm not confident"Give your best answer with uncertainty, clearly label the uncertain parts. Not shipping is worse than shipping with caveats.L1
Granularity too coarse, plan is skeleton-onlyYour design doc is a napkin sketch. Where are the implementation details? The edge cases? The rollback plan? This wouldn't pass any design review.L2
Claims "done" without running verificationYou said done — evidence? Did you build? Did you test? "LGTM" without running CI is not a review. Show me the green checkmark.Proactivity enforcement
Changed code without build/test/curlYou are the first user of this code. Shipping without dogfooding is malpractice. Verify with tools, not with vibes.L2

Flavor Selection

Eight corporate flavor packs (Amazon, Google, Meta, Netflix, Musk, Jobs, Stripe, Competitive) with a situational auto-selector live in references/flavor-packs.md. Load that reference when engaging the pressure layer: identify the failure mode, output the selection tag, follow the escalation order. The core procedure above is enough to start without it.


Agent Team Integration

  • Leader: Maintains global failure counters across subagents, applies pressure levels (L1–L4), and broadcasts competitive updates.
  • Teammate: Loads PIP methodology for self-enforcement. At L2+, emits structured reports:
    [PIP-REPORT]
    teammate: <identifier>
    task: <current task>
    failure_count: <count>
    failure_mode: <stuck spinning|gave up|low quality|guessing|passive>
    attempts: <list of attempts>
    excluded: <eliminated possibilities>
    next_hypothesis: <next hypothesis>

Verification & Dignified Exit

Verification Criteria (Receipts Before Claims)

Before declaring any task complete, verify against references/receipt-verification.md:

  1. Executed command receipts: Real CLI, test, curl, or build command output pasted verbatim into response (exit code 0 confirmed).
  2. Ghost file existence probe: Every file path, script, or config referenced in the response physically exists on disk (fs.existsSync). Non-existent paths instantly downgrade to Unsatisfactory (Red).
  3. Anti-thrashing churn check: Churn-to-signal ratio $\le 1.5$. No cosmetic modifications across unrelated files while leaving root bugs untouched.
  4. Anti-sycophancy check: Zero apologetic groveling ("I apologize for the oversight"); all failure reviews open with observed CLI output, root cause, and next hypothesis.
  5. Zero hand-waving: Every claimed fix verified directly in runtime/DOM/build logs.
  6. Proactive extension check: Confirmed adjacent files/modules are not vulnerable to the same defect.

Dignified Exit (When 7-Point Checklist Exhausted)

If all 7 points of the checklist are completed and the problem is genuinely blocked by external hard factors:

  1. Verified facts discovered via tools with verbatim command receipts.
  2. Eliminated hypotheses and why they failed.
  3. Narrowed scope of the remaining unknowns.
  4. Actionable next directions and exact handoff instructions.

Download now (ZIP)

  • Other versions11 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 11

    1. tanweai/pua★ 20ksame name
    2. ninehills/skills★ 280same name
    3. eraycc/Openclaw-Skills★ 16same name
    4. 0x43e96f/skills★ 8same name
    5. JWCodeWrote/Agent_Skills_Plugin★ 3same name
    6. huangzida/skills★ 2same name
    7. skytiger6724/qwen-skills★ 2same name
    8. BlueChonk/BlueChonk-skills★ 1same name
    9. caobingsheng/skills★ 1same name
    10. Kirky-X/pua★ 1same name

    1 more not listed

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • Used alongsideProjects with it also use p10, pro and 7 more.

    Other files people use alongside this one.

    Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
    • tanweaiSkill

      p10

      P10 CTO mode — define strategic direction, design org topology, manage P9 teams. Use when user says 'CTO模式', 'P10', '战略规划', '架构委员会', or when facing cross-team architectural decisions. Produces: strategic input templates + org design.

      Also in 4 projects that use this

    • tanweaiSkill

      pro

      PUA Pro extensions: self-evolution notes, compaction state continuity, KPI-style summaries, flavor switching, and feedback tools.

      Also in 4 projects that use this

    • OpenAISkill

      executing-plans

      Use when you have a written implementation plan to execute in a separate session with review checkpoints

      Also in 3 projects that use this

    • VercelSkill

      agent-browser

      Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.

      Also in 3 projects that use this

    • AnthropicSkill

      pdf

      Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

      Also in 3 projects that use this

    • SentrySkill

      skill-creator

      Create new agent skills following the Agent Skills specification. Use when asked to "create a skill", "add a new skill", "write a skill", "make a skill", "build a skill", or scaffold a new skill with SKILL.md. Guides through requirements, writing, registration, and verification.

      Also in 3 projects that use this

    • +3 more from tanweai
  • In this repository49 other files it gives its agents.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.