This is the skill you reach for when DOCX structure matters, not just plain text. It handles headings, tables, styles, comments, footnotes, and PDF conversion through Word's MCP server when available, falling back to python-docx automation when it's not. The workflow is deliberate: build structure first, apply styling second, verify the output by actually opening the file before you ship it. It includes a verification protocol that stops you from claiming success until the document renders correctly, which is surprisingly easy to skip when you're generating files programmatically. The anti-patterns section calling out "writing for the author instead of the reader" is a good reminder that formatted output doesn't fix unclear thinking.

skills.sh installs
795
GitHub stars
24
last updated
Aug 21, 2026

Install

$ npx -y skills add practicalswan/agent-skills --skill word-document --agent claude-code

Installs into .claude/skills of the current project.

Files

Word Document Workflows

Tech Stack Target / Version: Word desktop or python-docx automation with current OOXML-compatible workflows.

Use this skill when .docx layout and document structure matter, not just the raw text.

  • Leverage native parallel subagent dispatch and 200k+ context windows where available.

Current MCP Reality

Microsoft publicly documents a Word MCP server in the Microsoft 365 Agents Toolkit preview, but tool availability still depends on the host. In GitHub Copilot you may see Word-specific tools; in other clients they may be missing. If direct Word MCP access is unavailable, use the included local script workflow.

Activation Conditions

Use symptom -> action triggers: when one matches, apply this skill and verify with the protocol below.

  • Creating or editing .docx reports, memos, or structured deliverables
  • Applying headings, tables, images, or styles
  • Reviewing or extracting document structure
  • Preparing Word output before a later PDF conversion

Practical Workflow

Sponsors

Details

Repository
github.com/practicalswan/agent-skills
Categories
Backend & APIs, AI & Agent Building, Marketing & SEO, Office & Documents
First seen
Jun 3, 2026

More from practicalswan/agent-skills

All 2
1shreefentsar avatarremotion-video-toolkitshreefentsar/remotion-video-toolkitComplete toolkit for programmatic video creation with Remotion + React. Covers animations, timing, rendering (CLI/Node.js/Lambda/Cloud Run), captions, 3D, chart793skills.sh installs
2subframeapp avatardesignsubframeapp/subframeDesign and edit anything in Subframe — pages, components, snippets, design documents, the theme. Also handles deletion of those resources except theme. Always l793skills.sh installs
3pproenca avatarreact-refactorpproenca/dot-skillsArchitectural refactoring guide for React applications covering component architecture, state architecture, hook patterns, component decomposition, coupling and791skills.sh installs
4hairyf avatarvitesthairyf/skillsVitest fast unit testing framework powered by Vite with Jest-compatible API. Use when writing tests, mocking, configuring coverage, or working with test filteri789skills.sh installs
5uni-helper avatarvue-best-practicesuni-helper/skillsMUST be used for Vue.js tasks. Strongly recommends Composition API with `<script setup>` and TypeScript as the standard approach. Covers Vue 3, SSR, Volar, vue-787skills.sh installs
6railwayapp avatarnewrailwayapp/railway-skillsThis skill should be used when the user says "setup", "deploy to railway", "initialize", "create project", "create service", or wants to deploy from GitHub. Han786skills.sh installs