Word Document Management Skill

What this skill does

• •Extract raw text content from existing .docx files
• •Generate new Word documents with custom titles and paragraphs
• •Apply hierarchical heading levels to new document structures
• •Insert data-driven tables into document bodies
• •Modify existing files by appending new content

When to use it

• ✓Automating the generation of recurring weekly status reports
• ✓Converting structured JSON or log data into readable document formats
• ✓Extracting specific content from legacy Word files for documentation cleanup
• ✓Templating standardized project documentation for consistent formatting

When not to use it

• ✕Processing non-Word formats like ODT or rich text files
• ✕Handling complex documents with heavily embedded macros or tracked changes
• ✕Performing advanced visual styling beyond basic formatting tags

How to invoke it

Example prompts that trigger this skill:

• “Read the contents of the report at /documents/summary.docx.”
• “Create a new document at project-doc.docx with these sections: Title, Paragraphs, and a table of task statuses.”
• “Extract all text from the meeting minutes file.”
• “Add a new section for Q4 findings to the existing Q3-report.docx.”

Example workflow

1. Identify the source .docx file or the desired output path.
2. Pass the content structure as a JSON object to the create function.
3. Run the ts-node command via the agent's bash executor.
4. Verify the output file existence in the file system.
5. Open the generated document to confirm the hierarchy and table alignment.

Prerequisites

• –Node.js installed in the environment
• –TypeScript/ts-node configured
• –Project dependencies: docx and mammoth

Pitfalls & limitations

• !Does not support legacy .doc files, only .docx
• !Cannot execute complex Word macros or VBA scripts
• !Formatting is limited to the capabilities defined by the underlying npm libraries

FAQ

How it compares

This tool automates file interactions that would otherwise require manual software usage or heavy external API dependencies, allowing for scripting within the local development flow.

Source & trust

From the source: “# Word Document Tool This skill allows you to work with Microsoft Word documents using Node.js tools. ## Capabilities - **Read** existing Word documents and extract text content - **Create** new Word documents with formatted text, headings, paragraphs, and tables - **Modify** existing documents by a…”

# Word Document Tool

This skill allows you to work with Microsoft Word documents using Node.js tools.

## Capabilities

- **Read** existing Word documents and extract text content
- **Create** new Word documents with formatted text, headings, paragraphs, and tables
- **Modify** existing documents by appending content
- **Extract** document structure and formatting

## When to Use

Invoke this skill when the user:
- Mentions Word documents, .docx files, or document creation
- Asks to read, create, modify, or format text documents
- Needs to generate reports, letters, or formatted documents
- Wants to extract text from existing Word files

## How to Use

The Word tool is implemented as a TypeScript script at `src/tools/word-tool.ts`. You can invoke it using the Bash tool:

### Reading a Document
```bash
ts-node src/tools/word-tool.ts read "/path/to/document.docx"
```

### Creating a Document
```bash
ts-node src/tools/word-tool.ts create "/path/to/new-document.docx" '{"title":"My Document","paragraphs":["First paragraph","Second paragraph"]}'
```

## JSON Structure for Creating Documents

When creating documents, use this JSON format:
```json
{
  "title": "Document Title",
  "paragraphs": ["Paragraph 1", "Paragraph 2"],
  "headings": [{"text": "Section 1", "level": 1}],
  "tables": [{"headers": ["Col1", "Col2"], "rows": [["A", "B"]]}]
}
```

## Implementation

Uses the `docx` and `mammoth` npm libraries for reading and writing Word documents.

Quoted from Fergana-Labs/claude_agent_desktop for reference — see the original for the authoritative, latest version.

Recommended Rules

Recommended Workflows

Recommended MCP Servers