docx-placeholder-replacement SKILL.md skillA
docx-placeholder-replacement from cxcscmu/skilllearnbench is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add cxcscmu/skilllearnbench/docx-placeholder-replacement@git:20260424.d50cf5aPins git:20260424.d50cf5a in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- cxcscmu/skilllearnbench
- Path
skills/b1-one-shot-claude-sonnet-4-6/offer-letter-generator/docx-placeholder-replacement/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260424.d50cf5a, committed Apr 24, 2026
- Size
- 2,458 bytes
- Repository stars
- 91
- License
- MIT
Robustly replace {{PLACEHOLDER}} tokens in Word documents, handling split runs across paragraphs, tables, headers, and footers.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Robust Placeholder Replacement in Word Documents
## The Split-Run Problem
Word's XML engine often breaks a single word like `{{CANDIDATE_NAME}}` across multiple runs:
```
run[0]: '{{CANDI'
run[1]: 'DATE_NAME}}'
```
A naive `run.text.replace()` will miss these. Always reconstruct from `para.text`.
## Safe Replacement Algorithm
```python
import re
def replace_in_paragraph(para, data):
"""Replace all {{KEY}} placeholders in paragraph, handling split runs."""
full_text = para.text
pattern = re.compile(r'\{\{([A-Z0-9_]+)\}\}')
if not pattern.search(full_text):
return # Nothing to do
# Build replacement
def replacer(m):
key = m.group(1)
return str(data[key]) if key in data else m.group(0)
new_text = pattern.sub(replacer, full_text)
if new_text != full_text and para.runs:
# Put all text in first run, clear the rest
para.runs[0].text = new_text
for run in para.runs[1:]:
run.text = ''
```
## Apply to Entire Document
```python
def replace_all_placeholders(doc, data):
"""Replace placeholders everywhere: body, tables, headers, footers."""
# Body paragraphs
…Read the whole file at its exact version.
How to install
mdr add cxcscmu/skilllearnbench/docx-placeholder-replacement@sha256:4496ef0169492e19The line at the top of this page pins the label git:20260424.d50cf5a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_jqk24pgcnhr23tp6)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Apr 24, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2458 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
cxcscmu/skilllearnbench · 91 stars · license MIT · pushed 2026-10-02 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_jqk24pgcnhr23tp6 GET https://markdownregistry.com/api/v1/resolve?ref=cxcscmu/skilllearnbench/docx-placeholder-replacement GET https://markdownregistry.com/api/v1/blob/4496ef0169492e19ce809a7370089d7591030090c001aa5e31ea803d1127b5c5
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.