Skip to content
cccskills
FreePublished on GitHub

docx-generation

Create Word reports from Markdown with consistent typography, page layout, tables, and lists using a bundled Python converter and reference document. The workflow also helps choose how to edit existing DOCX files while preserving their structure and styles.

OriginalShow the original description

Use when creating a Word DOCX report from Markdown, converting Markdown tables and lists to DOCX, or choosing a workflow for editing an existing DOCX while preserving its structure and styles. Use this workflow before running Markdown-to-DOCX shell commands. Includes report typography, table layout, a reusable reference document, and a Python converter.

aipoch/open-science5,396 stars(GitHub 5,396 + cccskills 0)
Works withWord

Run score Not tested

See how to install

Good for

  • Turning a Markdown report into a formatted Word document
  • Converting Markdown tables and lists to DOCX
  • Choosing how to edit an existing DOCX safely
  • Applying a supplied Word template to a new report

Files included (8)

  • SKILL.md5.1 KB
  • assets/reference.docx10.8 KB
  • kernel.py29.2 KB
  • open-science.json254 B
  • README.md4.3 KB
  • scripts/build_kernel.py1.6 KB
  • scripts/build_reference.py5.8 KB
  • scripts/convert.py8.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

DOCX generation and editing

Choose a workflow that preserves the user's requested content, structure, and presentation. User requirements take precedence over defaults. Keep tables, headings, and lists as native document structures.

Markdown to a new DOCX

For ordinary reports, use the bundled converter with an existing Pandoc 3.12.1 executable and Python 3.9 or newer. It uses a versioned reference document, separates ordinary table paragraphs from the Compact style shared by lists, and records converter/template provenance inside the DOCX. It does not install software. Run this converter rather than a bare pandoc source.md -o output.docx command: that command bypasses the report template and its typography, page geometry, table spacing, and provenance.

In Open Science, first prepare the workflow through the registered Notebook helper:

{
  "kernelSkillIds": ["docx-generation"],
  "code": "docx_workflow = prepare_docx_conversion('.')\nprint(docx_workflow)"
}

Call the function directly, without importing it. Repeat kernelSkillIds in every cell using this function. The helper writes the fixed converter and reference into a new directory inside the authorized Notebook working directory and returns script_path, reference_path, and workflow_directory. This uses the registered skill transport; the Notebook and shell cannot necessarily read the framework's skill directory.

Then run the returned script_path through the session's approved shell tool:

python "<returned-script_path>" "<source.md>" "<output.docx>"

Use the interpreter configured for the session. If the helper is unavailable, report that prerequisite through the normal execution recovery flow; do not probe or copy from the isolated framework skill directory. In environments outside Open Science that already allow reading this package, the original scripts/convert.py is also a standalone CLI.

Optional arguments:

  • --reference-doc "<template.docx>": use the user's template. Its styles and page settings take precedence; the bundled TableBody normalization is not applied.
  • --from gfm or --from markdown+pipe_tables: select the dialect that matches the source. The default is Pandoc Markdown.
  • --pandoc "<absolute-executable-path>": select an existing executable.

The bundled report profile uses A4 with 2 cm margins, 10.5 pt body text with approximately 1.33 line spacing, coordinated heading sizes (17/14/11.5 pt), and tighter list spacing. Tables use 9.5 pt text, 3 pt vertical and 4 pt horizontal cell padding, visible outer and internal grid lines, and bold headers without background shading. Top-level tables with automatic width fill the text area; explicit widths and column proportions remain intact. The default faces are Arial and PingFang SC for East Asian text; fonts are not embedded, and viewers substitute missing fonts. For a specific viewing platform or font requirement, use a reference with appropriate available fonts. A reference document's body content is not copied into the output. Use another workflow when the task requires filling a template's existing content.

Do not substitute the bundled template when the user supplied a template or requested a different design. For special page layouts or table widths, use an appropriate reference or targeted document editing; do not impose fixed page/column dimensions on every document.

For Pandoc Markdown pipe tables, retain intentional delimiter-row widths. Padding or reformatting a wide Markdown table can change the column proportions inferred by Pandoc.

The converter emits one JSON receipt with the output path, MIME type, versions, and template hash. It requires a new output filename and leaves existing files intact. If the supported Pandoc version is unavailable, report the missing prerequisite or use another suitable document-generation workflow under the session's normal environment rules. This skill does not require Pandoc for every DOCX task.

Editing existing DOCX files

Modify the existing package with an appropriate document library or narrowly scoped OOXML edits. Preserve unrelated styles, numbering, relationships, sections, and embedded objects. Avoid rebuilding a richly formatted source through Markdown when the task requires preserving its layout. For complex tables and precise forms, choose a library suited to that structure; library choice alone does not guarantee style preservation.

Artifact delivery

Pass the generated file's local path and MIME type to write_artifact_file. When Notebook or shell execution produced it, include the exact execution runId as producerRunId. The converter receipt is not an Artifact receipt; claim availability only after the Artifact tool succeeds.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

alphafold2

FreeSummary

Predict structures for single proteins or protein complexes with AlphaFold2 through ColabFold. Use confidence scores and comparisons with a designed structure to assess whether a designed sequence folds as intended.

  • Predicting a single protein's structure from its sequence
  • Predicting structures of protein complexes
  • Checking designed sequences against a target structure
aipoch/open-science5.4KUpdated Oct 29, 2026

boltz

FreeSummary

Use Boltz-2 to predict structures of complexes containing proteins, DNA, RNA, and small molecules. Obtain structure files and confidence scores to assess designed binders, with optional predictions of binding strength between a protein and a small molecule.

  • Assessing a designed binder against its target
  • Predicting a protein and small-molecule complex
  • Predicting complexes containing DNA or RNA
aipoch/open-science5.4KUpdated Oct 29, 2026

borzoi

FreeSummary

Predict patterns of gene expression and other genomic measurements from DNA sequences with Borzoi. Compare reference and altered sequences to estimate regulatory effects, generate predicted coverage tracks, and prioritize variants in regions that do not encode proteins.

  • Comparing predicted effects before and after a DNA variant
  • Generating predicted coverage tracks for a genomic region
  • Prioritizing variants in non-coding regions
aipoch/open-science5.4KUpdated Oct 29, 2026

chai1

FreeSummary

Predict three-dimensional structures of complexes containing proteins, RNA, DNA, and small molecules with Chai-1. Compare candidate structures using confidence scores and clash indicators, or run repeated predictions from Python to evaluate designed binders.

  • Predicting antibody–antigen complex structures
  • Evaluating protein–ligand binding structures
  • Reassessing designed binders
aipoch/open-science5.4KUpdated Oct 29, 2026

Prepare reproducible setup and removal instructions for software environments on Open-Science SSH hosts, including Slurm clusters. Check available tools, define named activation settings, and validate the environment where jobs run after the user installs it.

  • Preparing a remote environment for required packages
  • Making job environment activation repeatable
  • Checking software and GPU operation on Slurm nodes
aipoch/open-science5.4KUpdated Oct 29, 2026

customize

FreeSummary

Create and manage focused Specialist agents and Skills through conversation. Draft agent roles, review available Skills and Connectors, configure access, and manage changes, with Skill creation and publishing handled by the application's internal skill-creator.

  • Creating a Specialist for a focused role
  • Updating an agent's Skills and Connectors
  • Creating, revising, and publishing Skills
aipoch/open-science5.4KUpdated Oct 29, 2026

See all skills by aipoch

Report a problem with this skill