contract-redline-docx

Generates Word .docx contracts with native tracked changes from markdown redlines.

4|2|Updated May 13, 2026
One-click install
npx skills add https://github.com/BoardAI/vallor-plugins --skill contract-redline-docx-boardai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: contract-redline-docx
Source: https://github.com/BoardAI/vallor-plugins/tree/main/vallor/skills/contract-redline-docx
Command: npx skills add https://github.com/BoardAI/vallor-plugins --skill contract-redline-docx-boardai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-docx, pandoc, and includes references (resource) components.

What problem does it solve? Legal teams review contract redlines in markdown, but opposing counsel expects a Word file with native tracked changes and proper reviewer attribution. Manually converting markdown edits into Word revision marks is error-prone and risks leaking internal notes or misattributing authorship. ## Core Features & Use Cases - Tracked-Changes Conversion: Maps markdown redline entries (strikethroughs, bold insertions, WHY/FALLBACK annotations) to Word-native <w:ins>, <w:del>, and <w:comment> OOXML revisions using python-docx plus direct XML manipulation. - External/Internal Modes: External mode strips work-product headers, severity markers, and escalation references before sending to opposing counsel; internal mode preserves them and adds an INTERNAL DRAFT footer. - Reviewer Attribution & Cover Memo: Embeds confirmed reviewer name and email in revision metadata and generates a plain-text cover memo summarizing key positions for the outbound email. - Use Case: After running a contract redline on an MSA in markdown, convert it into a reviewer-ready .docx attributed to your GC, with fallback positions shown as comments, ready to email to opposing counsel. ## Quick Start Convert my markdown redline at redlines/acme-msa.md into a tracked-changes Word document in external mode attributed to Jane Smith.

Frequently Asked Questions about contract-redline-docx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a markdown contract redline to a Word tracked-changes document?

Point the skill at your markdown redline and the original source contract. It maps strikethroughs to w:del revisions, bold insertions to w:ins revisions, and annotations to Word comments, then writes a reviewer-ready .docx with tracked changes enabled.

How do I add tracked changes to a docx file with python-docx?

python-docx alone cannot write w:ins or w:del revision elements, so the skill combines it with direct OOXML manipulation. The reference implementation in references/docx-tracked-changes.md shows how to inject revision XML and set w:trackChanges in settings.

Can I generate a redline docx without a prior markdown redline?

Yes. Path B accepts a contract PDF or DOCX directly, runs the redline workflow internally using the same logic as contract-redline, and then converts the result to tracked changes. PDF inputs are converted to DOCX first via pandoc or python-docx.

What is the difference between external and internal mode for contract redlines?

External mode strips the work-product header, severity markers, and escalation references so the file is safe to send opposing counsel. Internal mode keeps those annotations and adds an INTERNAL DRAFT footer to every page.

What happens if a redline entry cannot be found in the source contract?

The skill surfaces the unmatched entry with its redline line number and asks whether the original clause was renumbered between drafts. It never silently drops a change, and it validates the output by re-reading the file with python-docx.