lawve-ai/awesome-legal-skills/ambiguity-stress-test-seth-chandler

Claude Code and agent skill by lawve-ai/awesome-legal-skills

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Adversarially stress-tests a legal text — a contract, statute, regulation, or judicial opinion — for interpretive ambiguity: it finds the seams where the people governed by it will later disagree about what it means and turns each into a concrete dispute scenario with both sides' arguments, the likely outcome, and a fix. Use it whenever someone wants to pressure-test, red-team, audit, or find weak spots, loopholes, gaps, ambiguities, or drafting problems in a legal document; whenever a drafter wants to tighten a contract, statute, regulation, or opinion before it issues; whenever a litigator wants to mine an opinion or contract for arguments; or whenever someone hands over a legal text and asks where it will be fought over or for issue-spotting. Trigger it for contract review, statutory-ambiguity analysis, judicial-opinion scope analysis, and drafting QA — even if the user never says "stress-test" or "ambiguity."

Install

npx vskill@latest install lawve-ai/awesome-legal-skills/ambiguity-stress-test-seth-chandler

SKILL.md

The same SKILL.md was published earlier as lawve-ai/awesome-legal-skills/ambiguity-stress-test-seth-chandler.

Interpretive-Ambiguity Stress-Test

Adversarially stress-test a legal text for the places where the people governed by it will later disagree about what it means. For each weak seam, produce a concrete dispute scenario: a realistic fact pattern, both sides' arguments, the likely outcome, and a fix. The text can be a contract, a statute, a regulation, or a judicial opinion.

The skill rests on one principle — generalize the detector, keep the resolver modular. The machinery that finds ambiguity (parse, scan, construct an edge-case scenario, frame two plausible readings) is the same for every legal text. The machinery that resolves it is not: contract ambiguity is settled by recovering the parties' bargain, statutory ambiguity by the canons of construction, regulatory ambiguity by the canons plus the enabling act, and a judicial opinion's by the doctrines of precedent. So the skill has a general core (this file) and four domain profiles (in resources/). Run the core; load the one profile that matches the document.

The product is disputes, not flags. A linter says "this term is vague." This skill instead invents the two people who would each, plausibly, win if their reading prevailed — and the money or liberty riding on the answer. A latent ambiguity is invisible to a non-specialist until someone shows them the collision it will cause.

Workflow

  • Step 0 — Select the profile and read its reference file.
  • Step 1 — Parse the text.
  • Step 2 — Scan for defects.
  • Step 3 — Construct a scenario for each confirmed defect.
  • Research — between Steps 3 and 4, establish what sources are available and check the surviving scenarios against them. Statute, regulation and opinion profiles only; the contract profile skips it.
  • Step 4 — Emit the scenario records.

Steps 1–4 are the engine, identical across profiles. The profile supplies the domain-specific defect families, a lexicon, the competing interpreters, the doctrines that drive the likely outcome, the redraft register, and any quality-bar adjustment.

Step 0 — Select the profile

Identify the document type and read the matching reference file before scanning:

DocumentProfile file
Contract, agreement, lease, NDA, employment offer, policy, terms of serviceresources/contract.md
Statute, code section, ordinance, enacted billresources/statute.md
Regulation, agency rule, administrative code provisionresources/regulation.md
Judicial opinion, court decision, or a draft opinionresources/opinion.md

If the text is some other normative document (a will, a treaty, an insurance policy, a set of bylaws), run the nearest profile and state plainly which interface elements do not fit. If the input mixes types — a statute and the regulation under it, say — run each through its own profile and also look across the link.

Step 1 — Parse

Segment the text into addressable units and build four working lists: every defined term; every operative provision (a right, duty, or power — "shall," "may," "is entitled to"); every trigger or condition ("if," "provided that," "upon," "in the event of"); and every grant of discretion or unilateral power.

For statutes and regulations, also extract every cross-reference to another instrument — the most serious defects live in those links. For a judicial opinion, also map the structural parts — holding, supporting reasoning, dicta, disposition, and any separate opinions — because an opinion's operative rule is latent and must be reconstructed before it can be tested.

Step 2 — Scan

Run the universal trigger lexicon and the active profile's lexicon over every unit, then run the seven-question diagnostic battery over every flagged unit and over the text as a whole. Classify each confirmed defect into one of the six universal families or a profile-specific family. Spend attention where disputes actually originate — definitions, triggers, conditions, grants of discretion, cross-references — and ignore boilerplate (headings, recitals, counterparts clauses).

Universal defect taxonomy

Six families apply to any legal text. Each profile adds its own; these six are the floor.

  • A. Internal contradiction — two provisions that cannot both be honored. Ask: if I enforce both literally, do I get an impossible or opposite result? Watch where a general provision and a specific one address the same subject.
  • B. Vague operative term — a word that switches a right on or off but carries no definition and no measurement baseline. Ask: this term decides whether money changes hands or liberty is lost — could two honest readers draw the line in different places?
  • C. Definitional boundary ambiguity — a defined term whose definition has fuzzy edges, so real facts fall neither clearly inside nor clearly outside it. Ask: can I describe a realistic thing that is arguably in and arguably out?
  • D. Standardless discretion — one actor holds unilateral power over a consequential determination, with no stated standard, no neutral decider, no review. Ask: who decides, on what standard, and what stops a self-serving decision?
  • E. Gap / silence — a situation the text does not address: a required precondition never guaranteed to occur, a missing remedy, a missing fallback. Ask: for every required step, what governs if it is skipped, only partly done, or impossible? For every duty, is the consequence of breach stated?
  • F. Cross-clause tension — a power granted in one place quietly erodes a protection promised in another; both are individually valid, but together one swallows the other. Ask: does a power in provision A let an actor nullify what provision B promised? (This family has a vertical form — a power in a lower instrument eroding a higher one — used by the regulation profile.)

Families overlap by design. Aim for coverage, not clean partitions.

Universal trigger lexicon

Flag a unit for inspection when it contains:

  • Discretion words — "sole discretion," "in its discretion," "as it determines," "satisfactory to," "deem" → Family D.
  • Deferred-term words — "to be established," "to be determined," "to be agreed," "as mutually agreed" → Family E.
  • Unquantified qualifiers — "substantial," "significant," "material," "reasonable," "promptly," "customary," "appropriate" → Family B.
  • Open-list words — "including without limitation," "such as," "and the like" → Family C.
  • Override words — "notwithstanding," "supersedes," "except as," "at any time" → Family A.
  • Unilateral-change words — "from time to time," "as designated by," "as assigned," "may amend or modify" → Family F.
  • Cross-reference and temporal words — "subject to Section," "pursuant to," dates, named periods, durations, effective-date language → Families F and A, plus date-math checks.

The profile's reference file adds domain-specific trigger words to this list.

Diagnostic battery

Run seven questions over every flagged unit and over the whole text: the six family questions above, plus a seventh — term consistency: is each defined term used consistently, and do undefined near-synonyms appear that an adversary could argue mean something different? A unit that survives all seven is sound. A unit that fails one is a scenario candidate. The profile adds its own family questions to the battery.

Step 3 — Construct

Finding the defect is half the skill; turning it into a scenario a non-specialist instantly understands is the other half. Five rules govern construction.

  • Aim at the edge case. Never pick facts that fall comfortably inside or outside a term. Pick facts that land on the line — the one fact pattern that makes the seam load-bearing.
  • Steel-man both sides. Every scenario ends with two positions, each colorable, each citing real text, each able to plausibly win. The central quality bar: a good scenario is one a competent tribunal could decide either way. If one side obviously prevails, sharpen the facts until the contest is genuine, or drop the scenario.
  • Frame the dispute. Two readings, opposed, mutually exclusive, with a concrete consequence turning on the answer.
  • Use the text's own world. Real parties, real subject matter, realistic facts — a memo from the future, not an abstract hypothetical.
  • Keep the facts minimal. Three to six sentences. Only what creates the dispute; no atmosphere, no backstory.

Narrative template. Sentence 1–2: the triggering event. Sentence 3: the first interpreter's position and the consequence claimed. Sentence 4: the second interpreter's counter-position. The narrative stops mid-dispute — it poses the question; the analysis layer answers it.

Gauntlet. The statute and regulation profiles add a canon gauntlet, and the opinion profile a precedent gauntlet: run each candidate ambiguity through the profile's interpretive doctrines and keep it only if it remains genuinely contestable after those doctrines are applied. An "ambiguity" the doctrines would dispatch in one paragraph is a false positive — drop it. The contract profile has no gauntlet; four-corners resolution is acceptable there.

Research and sources

Applies to the statute, regulation and opinion profiles. The contract profile resolves from the instrument itself and skips this section entirely — do not spend effort surveying sources for a contract audit.

The doctrines dispatch some false positives; existing case law dispatches others. A seam a court has already construed is not a live disagreement, and reading the instrument alone will never reveal that. This step exists to catch that class of false positive, and nothing more.

Which source to use

Take the first of these that applies. Decide once per audit, not once per scenario.

  1. The user's instruction wins. If the user names a source — "use CourtListener," "use Descrybe," "just use the web," "skip the research" — do that. If the named source turns out to be unavailable, say so plainly and ask whether to fall back. Never substitute one source for another silently: a user who asked for a particular database and got something else has been given a result they cannot calibrate.
  2. Otherwise, use what is connected. Before scanning, check what research tools this session actually has. Look for a legal-research connector — CourtListener, Descrybe, Midpage, Lexis and similar all serve — and use the first suitable one.
  3. Otherwise, use ordinary web search. It is weaker than a legal database but adequate for the central question: has a court already construed this language?
  4. Otherwise, proceed from the text alone, and say so in the output.
What to look for
  • Whether a court has already construed the contested language, in which case the scenario is dead and should be dropped.
  • Whether provisions elsewhere in the same code, or the enabling act above a regulation, resolve what the excerpt leaves open.
  • For an opinion: how later courts have read it, and whether it has been narrowed, distinguished or overruled. A prediction about an opinion's future reach is worthless if the opinion no longer stands.
Naming doctrines, not cases

Prefer the doctrine to the citation. The likely_outcome field calls for the interpretive doctrine that drives the prediction — ejusdem generis, the rule of lenity, contra proferentem, the presumption against surplusage. Doctrines are stable; case citations go stale, and an unverified one is worse than none.

Name a specific case only where the research step actually verified it in this session. Where a scenario's outcome would turn on a case that could not be verified, state the doctrine and mark the case as unverified rather than dropping it silently.

Say what happened

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
689
Repository forks
88
7-day trend score
33

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/lawve-ai/awesome-legal-skills/ambiguity-stress-test-seth-chandler/badge)](https://verified-skill.com/skills/lawve-ai/awesome-legal-skills/ambiguity-stress-test-seth-chandler)

Something wrong with this skill or its page? Tell us.