All skills
mblode avatar

/ax-audit

@57eb304
by Matthew Blodemblode/agent-skills136 stars
12

Audits agentic products for tool parity, authority, approval payloads, recovery, and trust using 27 rules and a ship verdict. Use when asked for an "AX audit", to review an agent approval flow, or whether an agent can operate the product. For human-facing API ergonomics use dx-audit; for ordinary UI use ui-design.

Use this Skill: https://skilld.dev/gh/mblode/agent-skills/ax-audit

This session only. Nothing lands on disk.

rules-ax_sections.md

≈1.1k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Sections: Agentic Experience (Layer 2)

This file defines the 4 categories of agentic experience audit rules. Each rule file uses one of these category prefixes.


1. Trust & Transparency (trust)

Default tier: mostly fix-this-sprint; release-blocker for missing escalation paths Why critical: Users won't trust an agent, even when it's right, unless they can see why it decided what it did. Confident wrong answers without uncertainty markers or escalation paths cause permanent trust damage that future accuracy can't recover. Disclosure is part of trust, not just explanation: a user who cannot see what the agent can reach has no way to judge whether to keep it connected.

2. Control & Recovery (control)

Default tier: release-blocker for missing escape hatches; fix-this-sprint for over-conversational Why critical: Autonomy without exit is coercion. Every agent action needs a visible path to undo, revise, or override. The approval model must match the stakes and reversibility of the action. Chat-only interfaces for button-worthy actions waste user time and patience. As the interface shrinks the approval moment carries more weight, so a gate that fires correctly and shows nothing to decide on is a click-through, not a control.

3. Context & Memory (context)

Default tier: mostly fix-this-sprint to backlog Why critical: Agents that don't show what they remember feel opaque. Agents that don't use available context feel stupid. Interfaces that don't reshape with task progression feel static. All three erode the relationship depth that makes agent products defensible.

4. Agent Communication (comm)

Default tier: release-blocker for silent execution; fix-this-sprint for missing handshake; backlog for missing drafts Why critical: Silent agents feel broken. The communication contract between agent and user (progress signals, intent confirmation, and generative momentum) is the difference between a tool that works and a black box. The contract also covers the turns the user did not start: an agent that acts on a schedule cannot borrow permission from a request that never happened, so unprompted action blocks on a standing boundary plus a notice the user can act on.


Rule index

trust-no-confidence-cues          trust-no-uncertainty-markers      trust-no-escalation-path
trust-undisclosed-access-scope
control-no-escape-hatch           control-no-approval-gate          control-over-conversational
control-thin-approval-payload
context-memory-not-visible        context-no-adaptive-canvas        context-under-contextual
comm-no-intent-handshake          comm-no-progress-signal           comm-no-generative-momentum
comm-unrequested-action-no-consent

Total: 15 rules.


Cross-rule interactions

These pairings often co-fire on the same surface:

  • no-confidence-cues + no-uncertainty-markers: both address "why should I trust this." Different targets: rationale vs. hedging.
  • no-escape-hatch + no-approval-gate: for autonomous actions, both fire. Approval gate may partially satisfy escape hatch.
  • no-progress-signal + no-intent-handshake: long-running tasks that didn't confirm scope AND show no progress are doubly opaque.
  • memory-not-visible + under-contextual: complementary. One says the agent knows things the user can't see; the other says it doesn't know things it should.
  • over-conversational + no-generative-momentum: paradoxical pairing. Forcing chat where buttons would do, while failing to offer drafts where blanks would benefit.
  • no-approval-gate + thin-approval-payload: sequential, not simultaneous. The first asks whether the treatment matches the stakes, the second whether the prompt carries enough to decide. A surface with no gate at all is the first finding only; the second has nothing to inspect until a gate exists.
  • undisclosed-access-scope + memory-not-visible: what the agent can reach versus what it has kept. Different disclosures, so file both when both fail, each with its own evidence. Merging them hides whichever the team did not think of.
  • unrequested-action-no-consent + no-escape-hatch: an unattended run's notice is the only place an escape hatch can appear after the fact. If the notice is missing, report the consent finding; the escape-hatch fix has nowhere to attach until the user is told the action happened.

Source: SKILL.md on GitHub

No alerts13d3 checks · Risk SAFE
  • Gen Agent Trust Hub13d

    The skill is a specialized auditing framework for AI agent products, focusing on architectural integrity and user trust. It uses standard shell tools for static analysis of codebases. The analysis found no malicious behavior, obfuscation, or data exfiltration risks.

  • Socket13d

    No alerts

  • Snyk13d

    Risk: LOW · No issues

Signed by skilld at 57eb304. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 24 minutes ago.

Activeupdated 2 weeks ago

README badge

README badge for mblode/agent-skills/ax-audit