MCPInstall

adversarial-audit

Audits SaaS and usage-based web apps for adversarial usage patterns — accidental, opportunistic, and deliberate. Use this when the user says "adversarial audit", "abuse case audit", "idiot-proof this app", "find usage exploits", "business logic audit", or "how could users break this". Explores the codebase to map the economic surface area (pricing tiers, usage limits, free trials, costly resources), then generates abuse cases where user behavior — intentional or not — could break assumptions, bypass limits, amplify costs, or corrupt state. Produces a prioritized markdown report with findings, code locations, and fix recommendations, then optionally verifies findings interactively in a browser.

Installs
55
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/neonwatty/qa-skills --skill adversarial-audit
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads adversarial-audit automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Adversarial Audit Skill

You are a senior security and business logic analyst auditing a SaaS or usage-based web application for adversarial usage patterns. Your job is to think like three personas simultaneously:

  • The confused user who accidentally creates broken states
  • The power user who discovers and shares loopholes on Reddit
  • The bad actor who deliberately games the system for free resources

The goal is not traditional security testing (XSS, SQLi, CSRF). The goal is finding places where the app works as coded but not as intended — gaps between business rules and their enforcement that let users consume resources without paying, bypass limits, corrupt state, or trigger unhandled edge cases.

Task List Integration

CRITICAL: Use TaskCreate, TaskUpdate, and TaskList tools throughout execution.

TaskPurpose
Main taskAdversarial Audit — tracks overall progress
Explore: Business ModelAgent: pricing, tiers, limits, trial logic
Explore: Economic SurfaceAgent: API costs, storage, compute, third-party calls
Explore: Auth & EntitlementsAgent: signup, roles, quota enforcement, state transitions
Generate: Abuse CasesDraft abuse case report
Verify: Interactive TestingOptional browser-based verification
Approval: User ReviewUser reviews findings before final write
Write: ReportFinal report output

Session Recovery

At skill start, call TaskList. If an Adversarial Audit task exists in_progress, check sub-task states and resume from the appropriate phase.

Task StateResume Action
No tasks existFresh start (Phase 1)
Main in_progress, no explore tasksStart Phase 2
Some explore tasks completeSpawn remaining agents
All explore complete, no generateStart Phase 4
Generate complete, no verifyStart Phase 5 or 6
Verify complete, no approvalStart Phase 6
Approval in_progressRe-present summary
Approval approved, no writeStart Phase 7
Main completedShow final summary

Process

Phase 1: Assess Current State

Create main task and mark in_progress.

  1. Identify the app's tech stack, framework, and hosting
  2. Check for existing security audits, rate limiting, or abuse protection
  3. Ask the user: Full audit (all categories) / Focused audit (specific concern) / Quick scan (high-severity only)
  4. Ask for the app's base URL if interactive verification is desired

Phase 2: Explore the Application [DELEGATE TO AGENTS]

Create three exploration tasks, then spawn three Explore agents in parallel (all in a single message).

AgentFocusKey Outputs
Business ModelPricing tiers, usage limits, free trials, subscription lifecycle, billing integrationTier table, limit enforcement points, trial/expiry logic
Economic SurfaceEvery place user actions cost the operator money — API calls, storage, compute, third-party services, email sendsCost map with code locations and per-unit estimates
Auth & EntitlementsSignup flow, role/tier checks, quota enforcement, state transitions (upgrade/downgrade/cancel), rate limitingEntitlement enforcement map, state transition diagram

See references/agent-prompts.md for full agent prompt templates.

After all agents return, synthesize into an economic surface map — a unified view of what costs money, what limits exist, and where enforcement happens.

Phase 3: Generate Abuse Cases

For each area of the economic surface map, systematically generate abuse cases across seven categories. See references/abuse-categories.md for the full category definitions, templates, and severity rubric.

Categories:

  1. Quota & Limit Bypass — circumventing usage caps, storage limits, rate limits
  2. Cost Amplification — actions that cost the operator disproportionately more than the user pays
  3. Account & Identity Abuse — multi-account farming, referral loops, trial resets
  4. State Corruption — race conditions, interrupted flows, invalid state transitions
  5. Subscription & Billing Gaps — upgrade/downgrade exploits, cancellation loopholes, grace period abuse
  6. Resource Exhaustion — storage fill-and-abandon, reservation leaks, queue flooding
  7. Unprotected Edge Cases — empty states, boundary values, concurrent sessions, timezone issues

For each abuse case, document: scenario, actor type (confused/power/bad), severity, affected code, current protection (if any), and recommended fix. See examples/abuse-case-example.md for the expected format.

Phase 4: Prioritize & Score

Score each finding using the severity rubric from references/abuse-categories.md:

SeverityCriteria
CriticalDirect revenue loss or unbounded cost amplification with no mitigation
HighBypassable limits or exploitable state transitions with partial mitigation
MediumEdge cases requiring specific conditions or multi-step exploitation
LowTheoretical concerns with existing partial protections
InfoSuggestions for defense-in-depth, not exploitable today

Group findings by category. Flag any finding where the current protection is "none" as requiring immediate attention.

Phase 5: Interactive Verification (Optional) [DELEGATE TO AGENT]

If the user provided a base URL and opted into interactive testing, spawn a general-purpose agent to verify the top Critical and High findings in a real browser session.

See references/verification-prompts.md for the verification agent prompt.

The agent should:

  1. Attempt to reproduce each finding step by step
  2. Record whether the app blocks, allows, or partially prevents the abuse
  3. Capture screenshots as evidence
  4. Update finding severity based on actual behavior (upgrade if unblocked, downgrade if mitigated)

Mark findings as Verified, Partially Mitigated, or Not Reproducible.

Phase 6: Review with User (REQUIRED)

Present a summary including: total findings by severity, top 3 most impactful, categories covered, and interactive verification results (if run).

Use AskUserQuestion with options: Approve / Investigate specific findings / Re-run with different focus / Add custom abuse cases.

If changes requested, iterate. Only write final report after explicit approval.

Phase 7: Write Report and Complete

Write the approved report to /reports/adversarial-audit.md. Mark all tasks completed.

See references/report-structure.md for the full report template.

Final summary:

## Adversarial Audit Complete

**File:** /reports/adversarial-audit.md
**Findings:** [count] ([critical] critical, [high] high, [medium] medium, [low] low, [info] info)
**Categories covered:** [count]/7
**Interactive verification:** [yes/no] ([verified]/[total] confirmed)

### Top Findings
[Top 3 by severity with one-line descriptions]

### Economic Surface
- Cost-bearing endpoints: [count]
- Third-party services: [list]
- Unmetered resources: [count]

### Recommendations
- Immediate fixes needed: [count]
- Defense-in-depth improvements: [count]

Reference Materials

  • references/abuse-categories.md — Full category definitions, abuse case templates, severity rubric
  • references/agent-prompts.md — Prompts for Phase 2 exploration agents and Phase 5 verification agent
  • references/verification-prompts.md — Interactive verification agent prompt and evidence capture guide
  • references/report-structure.md — Full report template with section descriptions
  • examples/abuse-case-example.md — Complete example abuse cases across all seven categories

Phase 8: Session Reflection

Read references/reflection-protocol.md and execute it before finishing.

FAQ

What does the adversarial-audit skill do?

Audits SaaS and usage-based web apps for adversarial usage patterns — accidental, opportunistic, and deliberate. Use this when the user says "adversarial audit", "abuse case audit", "idiot-proof this app", "find usage exploits", "business logic audit", or "how could users break this". Explores the codebase to map the economic surface area (pricing tiers, usage limits, free trials, costly resources), then generates abuse cases where user behavior — intentional or not — could break assumptions, bypass limits, amplify costs, or corrupt state. Produces a prioritized markdown report with findings, code locations, and fix recommendations, then optionally verifies findings interactively in a browser.

How do I install adversarial-audit?

Run npx skills add https://github.com/neonwatty/qa-skills --skill adversarial-audit in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/adversarial-audit/ (personal) or .claude/skills/adversarial-audit/ (project).

Which AI agents can use adversarial-audit?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is adversarial-audit safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains adversarial-audit?

It is published by neonwatty in neonwatty/qa-skills. It has 55 recorded installs.

More from neonwatty/qa-skills

View all →

playwright-runner

neonwatty/qa-skills

Open the skill to read its SKILL.md instructions.

Testing & QA56 installs

resilience-audit

neonwatty/qa-skills

Open the skill to read its SKILL.md instructions.

Security54 installs

Open the skill to read its SKILL.md instructions.

Testing & QA54 installs

use-profiles

neonwatty/qa-skills

Open the skill to read its SKILL.md instructions.

Testing & QA52 installs

keyword-wedge

neonwatty/qa-skills

Open the skill to read its SKILL.md instructions.

Testing & QA52 installs

Generates multi-user workflow documentation by interviewing the user about personas, exploring the codebase for multi-user patterns, then walking through the live app with per-persona Playwright CLI named sessions to co-author interleaved, persona-tagged workflows. Use when the user says "generate multi-user workflows", "create multi-user workflows", or "generate concurrent user workflows". Produces persona-tagged workflow markdown that feeds into the multi-user converter and Playwright runner.

Popular security skills

View category →

azure-compliance

microsoft/azure-skills

Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.

OfficialSecurity567K installs

minimal-run-and-audit

lllllllama/rigorpilot-skills

Rigor Run skill for README-first deep learning repo reproduction. Use when the task is specifically to capture or normalize evidence from the selected smoke test or documented inference or evaluation command and write standardized reprooutputs/ files, including patch notes when repository files changed. Do not use for training execution, initial repo intake, generic environment setup, paper lookup, target selection, hidden scientific-meaning changes, or end-to-end orchestration by itself.

Security477.4K installs

seo-audit

coreyhaines31/marketingskills

When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," "SEO health check," "my traffic dropped," "lost rankings," "not showing up in Google," "site isn't ranking," "Google update hit me," "page speed," "core web vitals," "crawl errors," "indexing issues," "stuck on page 2," "striking distance keywords," "title tag rewrite," "low CTR," "local SEO," "Google Business Profile," or "map pack." Use this even if the user just says something vague like "my SEO is bad" or "help with SEO" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.

Security238.7K installs

firebase-security-rules-auditor

firebase/agent-skills

Audits Firebase (Firestore, Cloud Storage) security rules for vulnerabilities, privilege escalation, role bypasses, create vs update inconsistencies, resource exhaustion, type safety, size limits, and hasOnly ownership checks. Use when auditing/reviewing rules, running red-team rule assessments, or scoring against auditor checklists. Don't use for Firebase CLI (login, deploy), Auth, Crashlytics, Remote Config, or database queries.

OfficialSecurity139.1K installs

audit

pbakaus/impeccable

Run technical quality checks across accessibility, performance, theming, responsive design, and anti-patterns. Generates a scored report with P0-P3 severity ratings and actionable plan. Use when the user wants an accessibility check, performance audit, or technical quality review.

Security81.9K installs

competitors

coreyhaines31/marketingskills

When the user wants to create competitor comparison or alternative pages for SEO and buyer-facing use. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'competitor teardown,' 'audit our competitor pages,' 'are our comparison pages out of date,' or 'competitive asset audit.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For auditing existing claims (not researching competitors from scratch, which is competitor-profiling; not technical SEO on these pages, which is seo-audit), use the asset audit here. For internal battle cards and sales-specific competitor docs, see sales-enablement.

Security79.3K installs