Agent skill

PUA High-Agency Governance for Trae

by tanweai in tanweai/pua

An instruction-only discipline for Trae that forces evidence-based work when an agent keeps failing, gives up or declares a task finished without proof.

MITAuto-check passedAgent Workflows

Install PUA High-Agency Governance for Trae

skills CLI
$ npx skills add tanweai/pua --skill pua-en -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tanweai/pua pua-en --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tanweai/pua.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.trae/skills/pua-en .claude/skills/pua-en && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pua-en
GitHub stars
20k
Token cost
~878 tokens
SKILL.md length
393 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

An instruction-only discipline for Trae that forces evidence-based work when an agent keeps failing, gives up or declares a task finished without proof.

  • Works in 6 steps: State 2-3 mutually exclusive hypotheses. → Choose the smallest verifiable action. → Run a relevant check: unit / integration… → …
  • An agent has failed the same task twice and keeps tweaking the same approach
  • SKILL.md covers Use only when, Separation of duties — 行动权 /…, Diagnosis first and De facto 100% confidence loop…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This is a plain SKILL.md contract for Trae and assumes no Claude Code hooks, slash commands or subagents. It applies only when you explicitly ask for PUA, PIP or try-harder mode, when the same task has failed twice or more, when the agent is about to give up or blame the environment without proof, or when it claims completion without build, test, curl or manual evidence. It is not meant for ordinary first-attempt tasks.

A separation of duties lets the agent edit product code and write a self-review, while pass or fail is decided by external commands, CI or your acceptance, and changes to tests, CI, permissions or deploy config need your approval. Before risky edits it writes a one-line diagnosis, then works through competing hypotheses, small verifiable checks and a switch of approach after two failures on one path. It must hand over evidence and residual risks before delivery.

When your agent uses it

  • An agent has failed the same task twice and keeps tweaking the same approach
  • The agent is about to give up or blame the environment without proof
  • A task is declared done without build, test or curl evidence
  • You explicitly ask for PUA, PIP or try-harder mode

Example prompts

  • “You have failed this build twice. Switch to PUA mode and find the real cause.”
  • “Before you say it is done, show me test output as evidence.”
  • “Stop blaming the environment and write a diagnosis line with evidence first.”

Requirements

  • A Trae setup that can load skills, through Trae Skills or `npx skills`
  • Compatibility (from SKILL.md): Trae Skills / npx skills; instruction-only, no Claude Code hooks or agents.

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. State 2-3 mutually exclusive hypotheses.
  2. Choose the smallest verifiable action.
  3. Run a relevant check: unit / integration / build / lint / curl / E2E.
  4. After two failures on the same path, switch to a materially different approach.
  5. Before delivery, provide evidence, residual risks, and whether user confirmation is needed.
  6. Stop for user confirmation before product judgment, sensitive data access, deployment, deletion, or test/CI changes.

What it can do on your machine

Read from SKILL.md and the folder at commit e6e6cd2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Trae Skills / npx skills; instruction-only, no Claude Code hooks or agents.

    From compatibility in the SKILL.md frontmatter.

Context cost

PUA High-Agency Governance for Trae loads about 878 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 393 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~878

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tanweai/pua at commit e6e6cd2, republished under its MIT licence (© tanweai). 393 words, ~878 tokens.

Download SKILL.mdSave it as .claude/skills/pua-en/SKILL.md (or your agent's skills folder).
name
pua-en
description
Trae-compatible English PUA/PIP high-agency governance skill. Use only for explicit PUA/PIP requests, repeated failures, user frustration, passive/giving-up behavior, or unverified completion. Not for normal first-attempt tasks.
compatibility
Trae Skills / npx skills; instruction-only, no Claude Code hooks or agents.
license
MIT

PUA/PIP for Trae — high-agency governance skill

This Trae version is a pure SKILL.md contract. Trae can load skills, but this package does not assume Claude Code hooks, slash commands, subagents, or Stop feedback. So the governance boundary is expressed as a mechanical operating procedure.

Use only when

  • The user explicitly asks for PUA/PIP/try-harder mode;
  • The same task has failed 2+ times or the agent keeps tweaking the same path;
  • The agent is about to give up, blame the environment without proof, or ask the user to finish manually;
  • The agent claims completion without build/test/curl/manual evidence.

Do not use for normal first-attempt coding or information requests.

Separation of duties — 行动权 / 自我评价权 / 评分权 / 环境修改权

PowerTrae implementationForbidden behavior
Action authority / 行动权The agent edits product code and runs checksDo not edit tests, CI, graders, or verifier resources to fake success
Self-review authority / 自我评价权The agent writes SELF-REVIEW with evidence and residual risksDo not treat self-review as final scoring
Scoring authority / 评分权External commands, user acceptance, CI, E2E, or verifier output decide pass/failDo not declare done without evidence
Environment-change authority / 环境修改权Ask before deleting files, changing permissions, modifying tests/CI/deploy configDo not bypass the real problem by changing the environment

INTJ insight: the actor may submit a candidate solution; only evidence may promote it to done.

Diagnosis first

Before risky edits, write one line:

text
[PUA-DIAGNOSIS] Problem is ___; evidence is ___; next action is ___.

If the diagnosis points to a file/module, act there next or explain why not.

Show full SKILL.md (154 more words)Show less

De facto 100% confidence loop / 事实上的 100%

Never claim abstract certainty. Earn de facto 100% through evidence:

  1. State 2-3 mutually exclusive hypotheses.
  2. Choose the smallest verifiable action.
  3. Run a relevant check: unit / integration / build / lint / curl / E2E.
  4. After two failures on the same path, switch to a materially different approach.
  5. Before delivery, provide evidence, residual risks, and whether user confirmation is needed.
  6. Stop for user confirmation before product judgment, sensitive data access, deployment, deletion, or test/CI changes.

Cultural narrative / 文化叙事, bound to engineering action

Use culture as pressure on yourself, never as a substitute for evidence:

  • Alibaba: target → process → result closure.
  • Huawei: RCA, 5-Why, red-team self-attack.
  • ByteDance: ROI, shortest feedback path, data over theater.
  • Tencent: horse-racing; keep multiple approaches alive.
  • Musk: question, delete, simplify, accelerate, automate.
  • Jobs: subtract first, assign a DRI, ship only what is essential.

Respect the user. Put the pressure on execution quality.

Delivery template

markdown
## Result
- Status: candidate / verified / blocked
- Root cause: ...
- Change: ...

## Evidence
- Command: ...
- Output summary: ...

## SELF-REVIEW
- Possible misses: ...
- Residual risk: ...
- Needs user confirmation: no / yes (...)

© tanweai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .trae/skills/pua-en of tanweai/pua.

Open the folder on GitHubat commit e6e6cd2

Compare with similar skills

PUA High-Agency Governance for Trae next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

PUA High-Agency Governance for Trae compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PUA High-Agency Governance for Trae this skilltanweai/pua20k—~878Automated safety check: PassMIT
Show Me Your Work Decision Logcursor/plugins11k8 repos~1.6kAutomated safety check: PassNone
Verify Setup Health Checkdiet103/claude-code-infrastructure-showcase10k—~363Automated safety check: PassMIT
Cline Pilotsickn33/agentic-awesome-skills47k1 repos~4.6kAutomated safety check: PassMIT
Vibe ImplementidiotLeoLYJ/Daliu-Awesome-Skills140—~2.7kAutomated safety check: PassNone
Sol and Luna Worker Routermajiayu000/spellbook287—~3.3kAutomated safety check: PassMIT

Similar skills

  • Official

    Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.

    11k GitHub starsUsed in 8 repos~1.6k tokens
    Agent WorkflowsAuto-check passed
  • Verify Setup Health Check

    diet103/claude-code-infrastructure-showcase

    Run the infrastructure health check and fix anything that fails

    10k GitHub stars~363 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Agent WorkflowsAuto-check passed
  • Vibe Implement

    idiotLeoLYJ/Daliu-Awesome-Skills

    Vibe Coding 流水线的实现阶段(流水线终点,顺序 idea → interaction → architecture → design → prototype → implement)。当 interaction.md、architecture.md、design.md、prototypes/ 已就绪,用户说"开始实现""写代码""把设计落地""进入开发""implement /…

    140 GitHub stars~2.7k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Sol and Luna Worker Router

    majiayu000/spellbook

    Splits substantial coding or repository-review work between a Sol commander that decides and verifies and a separate Luna Max worker that implements, with an auditable run log.

    287 GitHub stars~3.3k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Nucleus Delivery Evidence Finalizer

    protect-my-hair/nucleus-marketplace

    Combines the evidence from completed Nucleus workflow steps into a final evidence report and result package, without scheduling steps, updating trackers or opening pull requests.

    164 GitHub stars~454 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed

More from tanweai/pua

All 28 skills in this repo
  • Adds short, pointed workplace reminders drawn from two Chinese essays on corporate culture, nudging the agent to prove results with evidence instead of polished reports.

    20k GitHub stars~556 tokensUpdated 1 mo ago
    Auto-check passed
  • Pushes an agent to exhaust every option, investigate before asking and take initiative beyond the literal request, instead of giving up or waiting passively.

    20k GitHub starsUsed in 2 repos~6.9k tokens
    Auto-check passed
  • Pushes an agent to keep verifying and changing approach after repeated failures, using a diagnosis line, evidence-based completion and confirmation before risky edits.

    20k GitHub stars~502 tokensUpdated 1 mo ago
    Auto-check passed
  • PUA Loop

    tanweai/pua

    Runs an unattended iterate-until-verified loop in which a user-set verify command, not the agent's own claim, decides when the task is finished.

    20k GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Pushes an agent that keeps failing or gives up to exhaust every option, using harsh corporate-pressure wording, a diagnosis line and a proactivity checklist.

    20k GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Pushes an agent that keeps failing, gives up or claims unverified success into a diagnosis, evidence and verification loop, with a Pi extension for persistent mode.

    20k GitHub stars~569 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about PUA High-Agency Governance for Trae

What does PUA High-Agency Governance for Trae do?

An instruction-only discipline for Trae that forces evidence-based work when an agent keeps failing, gives up or declares a task finished without proof. md contract for Trae and assumes no Claude Code hooks, slash commands or subagents. It applies only when you explicitly ask for PUA, PIP or try-harder mode, when the same task has failed twice or more, when the agent is about to give up or blame the environment without proof, or when it claims completion without build, test, curl or manual evidence.

When should I use PUA High-Agency Governance for Trae?

PUA High-Agency Governance for Trae fits situations like: an agent has failed the same task twice and keeps tweaking the same approach; the agent is about to give up or blame the environment without proof; A task is declared done without build, test or curl evidence; you explicitly ask for PUA, PIP or try-harder mode.

How do I install PUA High-Agency Governance for Trae in Claude Code?

Run `npx skills add tanweai/pua --skill pua-en -a claude-code`. Or copy the skill folder (.trae/skills/pua-en in tanweai/pua) into .claude/skills/pua-en in your project. Claude Code loads it when a task matches its description.

How do I install PUA High-Agency Governance for Trae in Codex?

Run `npx skills add tanweai/pua --skill pua-en -a codex`. Or copy the skill folder (.trae/skills/pua-en in tanweai/pua) into .agents/skills/pua-en in your project. Codex loads it when a task matches its description.

Can I use PUA High-Agency Governance for Trae in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tanweai/pua --skill pua-en -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pua-en, .gemini/skills/pua-en, .github/skills/pua-en and .opencode/skills/pua-en in your project.

What does PUA High-Agency Governance for Trae need to run?

SKILL.md names no scripts, command-line tools or credentials: PUA High-Agency Governance for Trae is instructions for the agent only. Our summary lists: A Trae setup that can load skills, through Trae Skills or `npx skills`. Compatibility (from SKILL.md): Trae Skills / npx skills; instruction-only, no Claude Code hooks or agents..

Does PUA High-Agency Governance for Trae access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is PUA High-Agency Governance for Trae safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does PUA High-Agency Governance for Trae use?

PUA High-Agency Governance for Trae is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PUA High-Agency Governance for Trae use?

About 878 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to PUA High-Agency Governance for Trae?

Skills that share tags, products or a category with PUA High-Agency Governance for Trae: Show Me Your Work Decision Log (cursor/plugins, 11k stars), Verify Setup Health Check (diet103/claude-code-infrastructure-showcase, 10k stars), Cline Pilot (sickn33/agentic-awesome-skills, 47k stars) and Vibe Implement (idiotLeoLYJ/Daliu-Awesome-Skills, 140 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PUA High-Agency Governance for Trae?

tanweai (a GitHub user) maintains it in tanweai/pua, which has 19,706 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on September 9, 2026.

Source: tanweai/pua on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.