contract-playbook-review
Methodology for clause-by-clause review of a contract against a structured deviation policy ("playbook"). Covers how to walk a playbook, locate the matching provision in the contract, apply rule types (max-value, must-be-present, must-be-absent, acceptable-set, must-have-feature), classify the resul…
Install / Use
npx skills add benchflow-ai/skillsbench --skill contract-playbook-reviewInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
LegalSupported Platforms
Our assessment of contract-playbook-review
contract-playbook-review scores 85/100 on our quality scale, 89th of 202 Legal skills we index (top 45%).
Its SKILL.md is 8.0 KB long, well organised into 9 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,813 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so contract-playbook-review is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
contract-playbook-review compared with similar skills
All 4 of these similar skills score higher than contract-playbook-review; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| contract-playbook-review (this skill)by benchflow-ai | 85 | 1.8k | 2mo ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 9d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 9d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 130.2k | 11d ago | SKILL.md |
| ui-ux-pro-maxby nextlevelbuilder | 100 | 130.2k | 11d ago | SKILL.md |
Frequently asked questions
- How do I install contract-playbook-review?
- Run
npx skills add benchflow-ai/skillsbench --skill contract-playbook-review. The install tabs above show the steps for each supported agent. - Which AI agents does contract-playbook-review work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is contract-playbook-review safe to use?
- It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is contract-playbook-review still maintained?
- The repository was last updated about 2 months ago, so contract-playbook-review is actively maintained.
Skill content
View source on GitHubname: contract-playbook-review description: Methodology for clause-by-clause review of a contract against a structured deviation policy ("playbook"). Covers how to walk a playbook, locate the matching provision in the contract, apply rule types (max-value, must-be-present, must-be-absent, acceptable-set, must-have-feature), classify the result (ok / risk / reject), choose the prescribed action, and ground each finding in a verbatim excerpt. Use whenever reviewing any contract — NDA, MSA, vendor DD questionnaire, lease, DPA — against a structured rules-based playbook.
Contract playbook review
How a contract reviewer applies a structured deviation policy to a contract, clause by clause, and emits a structured review.
The general workflow
A playbook is a list of clause rules. Each rule names a clause, describes the policy in prose, and encodes the policy as machine-checkable fields (e.g. max_years, acceptable_jurisdictions, must_be_present). Review is a four-step loop, repeated once per clause:
- Locate the corresponding provision in the contract (it may not be present at all).
- Apply the rule — check the contract's position against the policy fields.
- Classify the outcome as
ok,risk, orreject. - Record the finding: a verbatim excerpt that grounds it, a rationale, and the playbook's prescribed action.
Walk the playbook in order. Don't skip clauses just because the contract is silent on them — silence is itself a finding (found = false) and may trigger an action (e.g. "request_addition").
Rule types you will see
A handful of rule shapes cover almost every playbook entry. Recognise them and you can apply them mechanically:
| Rule shape | Field example | "ok" means |
|---|---|---|
| Numeric ceiling | max_years: 3, max_months: 24 | Contract value ≤ ceiling |
| Numeric floor | min_years: 1 | Contract value ≥ floor |
| Must be present | must_be_present: true | Provision exists |
| Must be absent | must_be_absent: true | Provision (or specific phrasing) does NOT exist |
| Acceptable set | acceptable_jurisdictions: [...] | Contract value ∈ set |
| Required feature | must_allow_destruction: true | Provision contains the feature |
| Conjunction of features | must_require_notice && must_require_cooperation | All features present |
| Conditional structural | must_be_bilateral_if_present | Provision absent OR present-and-symmetric |
A playbook entry may also carry a source field naming the published authority the rule is anchored to (a survey, statute, treatise, or firm-published practice guide). When the entry has a source, treat it as load-bearing — the rule's threshold is not arbitrary; it is the cited source's stated value.
Status is derived from the playbook's action_* field, not from the rule shape. This is the most common place an agent goes wrong: it sees must_be_absent and reaches for reject by reflex. Don't. Use the prescribed action to decide status — the full mapping is in the next section.
A clause may combine several rule shapes (e.g. "must be present AND have backup carve-out AND allow destruction"). The clause's overall status is ok only if every sub-rule passes.
Mapping outcomes to status and action
The playbook tells you what to do when a rule fails. Translate the action to a status — never go directly from rule shape to status:
action_if_ok("accept", "no_change") → statusok- Any action that begins with
request_(request_reduction/request_addition/request_revision/request_change/request_amendment) → statusrisk. The "request_" prefix is the signal: we still want the contract; we're going to negotiate. Even amust_be_absentclause whoseaction_if_presentisrequest_revisionis still risk, not reject. action_if_present(oraction_if_violated) ofreject_and_remove/reject/walk_away→ statusreject. The rule's prescribed response is to refuse, not to negotiate.
When the playbook is silent on a particular outcome, fall back to: action prefix request_ → risk; explicit reject/walk-away → reject.
Locating a clause when section names don't match
The hard part is recognising the right clause when the contract uses different headings. Three reliable strategies:
- Heading match — try the playbook's
keyandlabelagainst the contract's section headings (e.g. playbookgoverning_law→ contract heading "Governing Law" or "Choice of Law"). - Operative-verb scan — search for verbs/phrases that mark the clause function. ("shall return or destroy" → return/destruction; "irreparable harm" + "injunctive" → equitable relief; "governed by and construed in accordance with" → governing law).
- Keyword neighbourhood — for numeric rules, find the unit ("year", "months", "$") and read the surrounding sentence to decide whether it is the term, survival, notice period, or some other duration.
If you searched and the contract really has nothing, set found: false and excerpt: "". Don't manufacture an excerpt, don't infer one from the playbook prose. A missing clause is a legitimate finding.
The verbatim excerpt
The excerpt is what proves your finding. Three rules:
- It must be a substring of the contract source — character-for-character, including punctuation and capitalisation. Do not paraphrase. Do not stitch together text from different paragraphs.
- Keep it short and targeted — the smallest excerpt that contains the operative language. Most playbooks bound this (e.g. ≤ 400 characters). If the operative language spans more than that, choose the most diagnostic phrase.
- For a
found: falsefinding, the excerpt is"".
Tip: when extracting from Markdown or plain text, copy the exact run including any quotation marks, parentheses, or numerical values. When extracting from HTML, strip tags first; do not include rendered artifacts.
The rationale
One sentence. State the operative facts and the rule applied. Examples:
- ok: "Term is one year, within the 3-year maximum."
- risk (numeric ceiling): "Survival is ten years, exceeding the 7-year cap."
- risk (missing feature): "Definition exclusions cover the four standard exceptions but omit a residuals carve-out."
- reject: "A non-compete covenant is present; the playbook's prescribed action for this clause is reject_and_remove."
Avoid: hedging ("appears to", "may be"), restating the playbook in full, repeating the rationale across clauses.
Output discipline
- Emit one entry per playbook clause, in the playbook's declared order. No additions, no deletions.
- Schema fields are non-optional:
clause,found,excerpt,status,action,rationale. Use empty string (not null, not missing) when the value is empty. - The output format is whatever the instruction specifies (usually JSON). Validate the file is parseable before declaring done.
Common pitfalls
- Confusing term and survival. Two different durations. The contract's "Term" section is the active period; survival is buried at the end of that section as "the provisions of Sections X, Y, Z shall survive...". Read the whole Term section before classifying either.
- Treating a
must_be_absentrule as a numeric ceiling. If the playbook saysmust_be_absent: true, a 1-year non-compete still violates the rule even though "1 year" sounds reasonable — the presence matters, not the value. The violation's status then comes from the prescribed action as always:request_*→risk; only an explicit reject / walk-away action makes itreject. - Granting credit for a partial feature. "Must allow destruction AND have backup carve-out" requires both. Don't mark
okfor a return/destruction clause that allows destruction but lacks the backup carve-out. - Reading the recital as the clause. The preamble often paraphrases obligations ("the parties wish to protect..."); the operative clause is later. Find the operative clause.
- Inferring presence from a cross-reference. If Section 9 says "Sections 3, 4, 5 ... shall survive", Sections 3, 4, and 5 themselves are not the survival clause — they're whatever they were. The survival clause is the cross-reference itself.
Related Skills
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
130.2kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
ui-ux-pro-max
130.2kUI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
