Back to Skills

minimax-docx

Professional DOCX document creation, editing, and formatting using OpenXML SDK (.NET). Three pipelines: (A) create new documents from scratch, (B) fill/edit content in existing documents, (C) apply template formatting with XSD validation gate-check. MUST use this skill whenever the user wants to produce, modify, or format a Word document — including when they say "write a report", "draft a proposal", "make a contract", "fill in this form", "reformat to match this template", or any task whose fin

11,899stars1,011forksUpdated 5/18/2026

Security Assessment

Safe(100/100)
Security Score100/100

About minimax-docx

The minimax-docx skill is designed to handle professional DOCX document creation, editing, and formatting using the OpenXML SDK for .NET. It provides a structured approach for working with Word documents, enabling users to generate new documents from scratch, modify existing content, or apply template-based formatting with validation. This skill solves the common challenge of producing formally structured, standards-compliant Word documents efficiently, whether for reports, proposals, contracts, or other printable materials, without the user needing to manually handle raw XML or Word-specific styling details.

The skill features three main pipelines: creating new documents, filling or editing existing documents, and applying templates or style formatting. Each pipeline is guided by explicit signals derived from the user task, ensuring the correct processing path is selected. Users can work through a command-line interface or write direct C# scripts for advanced structural manipulations, such as multi-section layouts, custom styles, tables, headers, footers, tables of contents, and embedded images. Additionally, the skill includes setup scripts, environment checks, and pre-processing tools to convert older `.doc` files to `.docx` format and preview documents before editing.

Target users include professionals and developers who need to automate or standardize Word document generation in line with industry standards, such as ECMA-376 and GB/T 9704-2012, or following widely recognized style guides like IEEE, APA, or MLA. Common use cases include drafting business reports, formal proposals, legal contracts, structured forms, or any scenario requiring precise formatting and template consistency. This skill ensures that users can produce high-quality documents quickly, maintain compliance with formatting standards, and reduce manual editing errors.

FAQ

How do I start using minimax-docx for the first time?

Run the setup script `scripts/setup.sh` on Linux/macOS or `scripts/setup.ps1` on Windows. Use the `--minimal` option to skip optional dependencies. Then perform an initial environment check with `scripts/env_check.sh`.

Can I work with existing Word documents?

Yes, the skill supports filling, editing, and reformatting existing `.docx` files through Pipeline B (FILL-EDIT) and Pipeline C (FORMAT-APPLY).

Do I need to write C# code for all tasks?

Not always. CLI commands can handle many tasks, but for complex document structures like custom styles, multi-section layouts, tables, or headers/footers, direct C# scripting is recommended.

Is this skill compatible with `.doc` files?

Pre-processing is available to convert `.doc` to `.docx` using the provided script `scripts/doc_to_docx.sh` before performing edits or formatting.

Are there limitations or prerequisites?

Yes, you need a .NET environment and the OpenXML SDK. Users should read the provided `Samples/*.cs` files before writing scripts to ensure compatibility with tested patterns and SDK versions.

All Files

75 files
LICENSE1.0 KB
View
references/cjk_typography.md10.4 KB
View
assets/xsd/wml-subset.xsd25.1 KB
View
references/openxml_namespaces.md5.4 KB
View
references/typography_guide.md9.6 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Commands/ApplyTemplateCommand.cs12.7 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/CommentSynchronizer.cs6.3 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs37.1 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/HeaderFooterSamples.cs32.7 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Typography/FontDefaults.cs0.9 KB
View
scripts/setup.ps19.9 KB
View
.gitignore0.0 KB
View
references/cjk_university_template_guide.md6.3 KB
View
references/scenario_a_create.md7.6 KB
View
scripts/doc_to_docx.sh0.9 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Commands/DiffCommand.cs6.0 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/NamespaceConstants.cs3.5 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs43.4 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/ListAndNumberingSamples.cs33.2 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Validation/BusinessRuleValidator.cs9.0 KB
View
SKILL.md15.3 KB
View
assets/styles/corporate_styles.xml8.3 KB
View
references/comments_guide.md6.4 KB
View
references/scenario_b_edit_content.md7.7 KB
View
scripts/docx_preview.sh0.8 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Commands/EditContentCommand.cs19.3 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/RunMerger.cs2.6 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs45.4 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/ParagraphFormattingSamples.cs50.1 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Validation/GateCheckValidator.cs5.8 KB
View
assets/styles/academic_styles.xml7.2 KB
View
assets/styles/default_styles.xml12.0 KB
View
references/design_good_bad_examples.md26.6 KB
View
references/openxml_element_order.md10.4 KB
View
references/scenario_c_apply_template.md17.8 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Commands/FixOrderCommand.cs4.4 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/StyleAnalyzer.cs2.9 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/CharacterFormattingSamples.cs40.4 KB
View
assets/xsd/aesthetic-rules.xsd24.5 KB
View
references/openxml_encyclopedia_part1.md137.0 KB
View
scripts/dotnet/MiniMaxAIDocx.Cli/MiniMaxAIDocx.Cli.csproj0.5 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Commands/MergeRunsCommand.cs4.7 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/TrackChangesHelper.cs3.0 KB
View
assets/xsd/business-rules.xsd5.5 KB
View
references/design_principles.md26.6 KB
View
references/openxml_encyclopedia_part2.md92.0 KB
View
references/track_changes_guide.md5.2 KB
View
scripts/dotnet/MiniMaxAIDocx.Cli/Program.cs0.6 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Commands/ValidateCommand.cs4.1 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/UnitConverter.cs1.0 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/FieldAndTocSamples.cs23.4 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/TrackChangesSamples.cs22.8 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Validation/XsdValidator.cs2.1 KB
View
scripts/setup.sh16.1 KB
View
assets/xsd/common-types.xsd5.1 KB
View
references/openxml_encyclopedia_part3.md116.3 KB
View
references/troubleshooting.md18.4 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Commands/AnalyzeCommand.cs6.0 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/MiniMaxAIDocx.Core.csproj0.4 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples.cs72.7 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/FootnoteAndCommentSamples.cs27.9 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Typography/CjkHelper.cs1.2 KB
View
references/openxml_units.md2.3 KB
View
references/xsd_validation_guide.md4.9 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Commands/CreateCommand.cs14.2 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/ElementOrder.cs4.1 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs41.0 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/ImageSamples.cs38.0 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Typography/PageSizes.cs1.0 KB
View
scripts/dotnet/MiniMaxAIDocx.slnx0.1 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/DocumentCreationSamples.cs47.6 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/TableSamples.cs45.6 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Validation/ValidationResult.cs0.6 KB
View
scripts/env_check.sh6.9 KB
View
scripts/dotnet/MiniMaxAIDocx.Core/Samples/StyleSystemSamples.cs60.4 KB
View

Install minimax-docx

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill