contract-review skill

Contract Review Skill

Overview

This skill performs contract reviews by adding comments only (no edits to the original text). It follows a three-layer review (basic, business, legal) and generates:

• Annotated contract (.docx)
• Contract summary (.docx)
• Consolidated review opinion (.docx)
• Business flowchart (Mermaid + rendered image)

Language rule: detect the contract’s dominant language and output all generated content (comments, summary, opinion, flowchart text) in that language. Use the guidance in references/language.md.

Workflow

1. Unpack the contract (.docx) for XML operations
2. Read contract text (pandoc or XML)
3. Execute three-layer review
4. Add comments to the document
5. Generate contract summary
6. Generate consolidated opinion
7. Generate business flowchart and render image
8. Repack to .docx

Output Naming

• Output directory: 审核结果：{ContractName} for Chinese or ReviewResult{ContractName} for English
• Reviewed contract: {ContractName}审核版.docx for Chinese or {ContractName}Reviewed.docx for English
• Review report: 审核报告.txt for Chinese or Review_Report.txt for English

Comment Principles

• Comments only: do not modify the original text or formatting
• Precise anchoring: comment should target specific clauses/paragraphs
• Structured content: each comment includes issue type, risk reason, and revision suggestion
• Risk level: carried by reviewer name; do not include a “risk level” line in comment body
• Output language: use labels in the contract’s language (see references/language.md)

Comment example (English):

[Issue Type] Payment Terms
[Risk Reason] The total amount is stated as USD 100,000 in Section 3.2, but the payment clause lists USD 1,000,000 in Section 5.1. This inconsistency may cause disputes.
[Revision Suggestion] Align the total amount across clauses and clarify whether tax is included.

Review Standards

Use the three-layer review model and the detailed checklist in references/checklist.md.

Layer 1: Basic (text quality)

• Accuracy of numbers, dates, terms
• Consistent numbering and references
• Clarity and lack of ambiguity
• Formatting and punctuation quality

Layer 2: Business terms

• Scope, deliverables, quantity/specs
• Pricing and payment schedule
• Delivery/acceptance procedures
• Rights/obligations and performance guarantees

Layer 3: Legal terms

• Effectiveness and term/termination
• Liability/penalties and remedies
• Dispute resolution and governing law
• Confidentiality, force majeure, IP, notice, authorization

Risk levels (encoded in reviewer name):

• 🔴 High: core business ambiguity (price, scope, rights/obligations)
• 🟡 Medium: material but non-core ambiguity
• 🔵 Low: minimal practical impact

Contract Summary

Generate a structured, objective summary in the contract’s language.

• See references/summary.md (English template)
• Use references/language.md for language selection and Chinese labels

Output file: 合同概要.docx for Chinese or Contract_Summary.docx for English (default font: 仿宋; adjust if language requires)

Consolidated Opinion

Generate a concise, two-paragraph response for the business team in the contract’s language.

• See references/opinion.md

Output file: 综合审核意见.docx for Chinese or Consolidated_Opinion.docx for English (default font: 仿宋; adjust if language requires)

Business Flowchart (Mermaid)

Generate Mermaid flowchart per requirements and render to image.

• See references/flowchart.md

Outputs:

• business_flowchart.mmd
• business_flowchart.png

li## Technical Notes

Core workflow:

1. Unpack → 2. Add comments → 3. Summary → 4. Opinion → 5. Flowchart → 6. Repack

API & implementation details:

• references/technical.md

Dependencies

• Python 3.9+ (3.10+ recommended)
• pandoc (system install)
• defusedxml
• Mermaid CLI (mmdc) for rendering
• python-docx for rich text output

Troubleshooting (Short)

• Comments missing in Word: run doc.verify_comments() and re-save
• findparagraph fails**: shorten search text; confirm actual paragraph text
• Mermaid render fails: ensure mmdc installed; use Chrome path or Puppeteer config

Examples

See references/examples.md for a full workflow example.

Important Rules

1. Never alter original contract text
2. Review all three layers, do not skip items
3. Ensure risk level is accurate and consistent
4. Keep comments precise, professional, and actionable
5. Flowchart must come strictly from the contract text
6. Summary is objective only; no risk analysis
7. Opinion only reflects findings already identified