open-agreements/edit-docx-agreement
skills/edit-docx-agreement/SKILL.md
Make bespoke edits to a DOCX agreement generated by OpenAgreements (or any existing DOCX), using Safe Docx MCP tools for surgical, formatting-preserving edits and tracked-changes outputs. Use when user says "edit this contract," "change a clause," "modify the agreement," "custom edits to the docx," or "bespoke changes to the document."
$ install --global
skillsauthnpx skillsauth add open-agreements/open-agreements edit-docx-agreementInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 27, 2026, 9:03 AM68.3s2 files scanned
SKILL.md
- name:
- edit-docx-agreement
- description:
- >-
- license:
- MIT
- compatibility:
- >-
- author:
- open-agreements
- version:
- 0.2.0
- catalog_group:
- Editing And Client Workflows
- catalog_order:
- 10
edit-docx-agreement
Use this skill when a user asks for custom edits that are not exposed as template fields in an OpenAgreements-generated (or any existing) DOCX agreement.
Interactivity note: Always ask the user for missing inputs (file path, change intent, output preferences).
Security model
This skill bridges two separate systems:
- OpenAgreements (remote MCP or local CLI) — for template filling. Follows the OpenAgreements zero-download security model.
- Safe Docx (local MCP server) — for surgical DOCX editing. Requires separate setup. This is not part of the OpenAgreements skill set and has its own trust/security model.
The agent must have Safe Docx MCP tools available to perform edits. If Safe Docx tools are not detected, inform the user and provide setup guidance (see Connectors).
Decision rule: refill vs edit vs both
-
Field-only changes (e.g., party name, date, amount, valuation cap): Re-run OpenAgreements
fill_templatewith the updated field values. No Safe Docx needed. -
Boilerplate-only changes (e.g., custom clause, modified standard language): Use Safe Docx MCP tools to surgically edit the existing DOCX.
-
Mixed changes (field updates + bespoke edits): Re-fill via OpenAgreements first (to get a clean base with updated fields), save the output locally, then use Safe Docx to apply bespoke edits on the fresh file.
Execution
Step 0: Confirm you have a local .docx file path
- If OpenAgreements was run via remote MCP, the fill response returns a download URL (with
expires_at). Save the DOCX to a local path immediately. - If the download link has expired, re-run
fill_templateto get a fresh URL. - If OpenAgreements was run via local CLI, use the output file path directly.
Step 1: Verify Safe Docx MCP is available
Check whether Safe Docx tools (e.g., read_file, replace_text, apply_plan) are available in the current session.
- If available: proceed to Step 2.
- If not available: inform the user that Safe Docx MCP is required for bespoke edits and provide setup instructions from CONNECTORS.md. Stop here until the user configures it.
Step 2: Apply the decision rule
Follow the routing logic above (field-only / boilerplate-only / mixed).
For Safe Docx edits:
- Use
read_fileto locate target paragraphs - Use
replace_textorinsert_paragraphfor surgical changes - Use
apply_planfor batch edits (fails safely if any step is invalid) - Re-read edited paragraphs to verify changes
Step 3: Deliver reviewable outputs
Use Safe Docx download to save:
- A tracked-changes DOCX for legal review
- A clean DOCX for signing (optional but recommended)
Summarize edits for the user (paragraph IDs, before/after text).
Licensing note
Some templates (notably YC SAFEs) are licensed under CC-BY-ND-4.0. You can fill them for your own use but must not redistribute modified versions of the template itself. The filled output may constitute an "adapted work" — do not redistribute your filled output publicly without reviewing the license terms. See docs/licensing.md for details.
This tool does not provide legal advice — consult an attorney.
Connectors
For MCP server setup (OpenAgreements remote MCP + Safe Docx local MCP), see CONNECTORS.md.
Related Skills
open-agreements/canonical-markdown-authoring
development
VerifiedTrustedCommunity
Convert plain markdown contract drafts into OpenAgreements' canonical template.md authoring format — YAML frontmatter, Kind|Label|Value|Show When cover-term tables, oa:clause directives, [[Defined Term]] paragraphs, and oa:signer directives that compile to validated JSON specs and DOCX artifacts. Use when the user says "convert this to canonical markdown," "author a new OpenAgreements template," "migrate template to template.md," or "write a canonical-form contract."
33SKILL.mdUpdated May 4, 2026
open-agreements/venture-financing
testing
VerifiedTrustedCommunity
Draft and fill NVCA model documents — stock purchase agreement, certificate of incorporation, investors rights agreement, voting agreement, ROFR, co-sale, indemnification, management rights letter. Series A and venture financing templates. Produces signable DOCX files. Use when user says "Series A documents," "NVCA," "stock purchase agreement," "investors rights agreement," "voting agreement," or "venture financing docs."
32SKILL.mdUpdated Apr 27, 2026
open-agreements/services-agreement
documentation
VerifiedTrustedCommunity
Draft and fill services agreement templates — consulting contract, contractor agreement, SOW, statement of work, professional services agreement. Produces signable DOCX files from Common Paper and Bonterms standard forms. Use when user says "consulting contract," "contractor agreement," "SOW," "statement of work," "services agreement," or "freelancer contract."
32SKILL.mdUpdated Apr 27, 2026
open-agreements/safe
documentation
VerifiedTrustedCommunity
Draft and fill Y Combinator SAFE templates — valuation cap, discount, MFN, pro rata side letter. Standard startup fundraising documents for convertible equity. Produces signable DOCX files. Use when user says "SAFE," "simple agreement for future equity," "YC SAFE," "valuation cap," "seed round documents," or "fundraising paperwork."
32SKILL.mdUpdated Apr 27, 2026