agentleFS
varunk130varunk130/claude-code-skills/skills/ai-ux-design/agent-autonomy-level-mapper/SKILL.md

agent-autonomy-level-mapper

Skill1 starsChanged 20 days agoMITView on GitHub

Produces a per-task autonomy map that assigns each agent action one of five levels - suggest, draft, act-with-approval, act-and-report, or act-silently - using a stakes x reversibility x confidence scoring matrix, plus an approval-gate specification and promotion criteria. Use when deciding how much an Artificial Intelligence (AI) agent should do on its own; designing permissions for an agent with tool access; debating whether an action needs human approval; or planning how to expand agent autonomy over time.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No defined path for an agent to earn more autonomy, or to lose it after incidents

    line 20
  2. Distinctive:

    Read-only actions (search, summarize, look up) still go on the list.

    line 38
  3. Distinctive:

    If a user explicitly asks for an action in the moment, the agent may move up one level for that instance only

    line 73
  4. Distinctive:

    Use measured accuracy for the confidence axis.

    line 114
  5. Distinctive:

    Default to doing nothing when an approval times out

    line 116
  6. Distinctive:

    Place an irreversible external action at L5

    line 121

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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

Agent Autonomy Level Mapper

Autonomy is not a product-wide setting. It is a decision made per action, and it should be earned.

What this skill is

A decision workflow that breaks an agent's job into discrete actions and assigns each one an autonomy level from a five-level ladder. Each action is scored on stakes, reversibility, and the agent's measured confidence, and the score maps to a level with a matching approval-gate design. The output is an autonomy map product, design, engineering, and risk teams can agree on and revisit as the agent proves itself.

What it solves

  • One global "autonomous mode" toggle that is too risky for some actions and too timid for others
  • Approval prompts on trivial actions that train users to click "Approve" without reading
  • Irreversible actions (sending, paying, deleting) running without a gate
  • Autonomy decisions made on demo confidence rather than measured accuracy
  • No defined path for an agent to earn more autonomy, or to lose it after incidents

When to invoke

  • Designing a new agent that can call tools, write data, or contact people
  • Stakeholders disagree on whether an action needs human approval
  • Users complain about too many confirmations, or about surprises
  • Expanding an assistant from suggesting to acting
  • Post-incident review of an agent action that should have been gated

Phase 1: Decompose the job into actions

List every discrete action the agent could take. Split compound actions: "Process refund" becomes look up order, calculate amount, draft customer message, issue refund, send message.

ActionObject affectedWho sees the effectTool or system
Issue refundCustomer paymentCustomer, financeBilling system

Read-only actions (search, summarize, look up) still go on the list; they are usually the first candidates for silent autonomy.

Phase 2: Score each action

Score 1 (low) to 5 (high) on each axis:

Axis135
Stakes (S)Cosmetic, internal, easily ignoredVisible to others, moderate cost if wrongFinancial, legal, safety, or reputational harm
Irreversibility (R)One-click undo, no side effectsUndo possible with effort or delayCannot be undone (sent, paid, deleted, published)
Confidence gap (C)Measured accuracy at or above 98 percent on this action85-97 percentBelow 85 percent, or not yet measured

Confidence must come from evaluation data on this action type, not from the model's self-reported certainty. Unmeasured equals 5.

Autonomy risk = S x R + 2 x C
Range: 3 to 35

Multiplying stakes by irreversibility reflects that a high-stakes action with a reliable undo is far safer than one without.

Phase 3: Map risk to autonomy level

Risk scoreLevelAgent behaviorUser experience
3-7L5 Act silentlyPerforms the action, logs itVisible only in history
8-12L4 Act and reportPerforms, then notifies with undoSummary with undo window
13-19L3 Act with approvalPrepares the action, waits for confirmApproval card with diff and consequences
20-26L2 DraftProduces a draft the user must edit or sendEditable draft, user executes
27-35L1 SuggestRecommends options, takes no actionSuggestions the user can ignore

Override rules, applied after scoring:

  • Any action with R = 5 (cannot be undone) is never placed above L3, regardless of confidence
  • Actions affecting people outside the organization are capped at L4
  • Regulatory or contractual requirements override the score in either direction
  • If a user explicitly asks for an action in the moment, the agent may move up one level for that instance only

Phase 4: Specify the approval gates

For every L3 action, and every L4 undo window, define the gate:

ElementSpecification
TriggerWhat state causes the gate to appear
ContentWhat will happen, to whom, and the exact values (amount, recipients, records)
DiffBefore and after for edits; full preview for sends
Consequence lineOne sentence on what cannot be undone
OptionsApprove, edit, reject with reason, always-allow-for-this-type (if permitted)
Timeout behaviorWhat happens if the user does not respond (default: do nothing)
Batch ruleWhen multiple approvals may be combined into one review

Undo windows for L4: 5-30 seconds for messages, up to 24 hours for reversible data changes. Name the window length in the notification.

Phase 5: Define promotion and demotion criteria

Autonomy is earned with evidence. For each action, set the rule to move one level:

DirectionCriteria (example)
Promote200+ instances at current level, approval-without-edit rate above 95 percent, zero Severity 1 incidents
DemoteAny Severity 1 incident, or edit-before-approve rate above 20 percent over 2 weeks
User overrideUsers may lower autonomy for themselves at any time; raising it requires the action to be eligible

Output

  • Action inventory with scope and affected parties
  • Scoring table (S, R, C, risk score) per action
  • Autonomy map: each action assigned L1-L5 with override notes
  • Approval-gate specification for every L3 and L4 action
  • Promotion and demotion criteria with the metrics to instrument
  • Open questions for risk, legal, or policy review

Operating rules

Always

  • Score actions individually, never the agent as a whole
  • Use measured accuracy for the confidence axis; treat unmeasured as lowest confidence
  • Show exact values and recipients in every approval gate
  • Default to doing nothing when an approval times out
  • Let users reduce autonomy for themselves without friction

Never

  • Let model self-reported confidence substitute for evaluation data
  • Place an irreversible external action at L5
  • Gate trivial actions just to appear safe; it creates approval fatigue
  • Promote autonomy without a defined metric and threshold
  • Ship act-and-report without a working undo

Download now (ZIP)

Does it work?

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

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

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.