--topic "Project Proposal for Mobile App Development" -o proposal.docx

Generate DOCX

Create professional Microsoft Word documents from markdown content, plain text, or let AI generate complete documents from a topic or outline.

This is a CLI skill. It requires the skills CLI to execute. Install it with npm install -g @hasna/skills, then run the commands below.

Features

•Markdown to DOCX: Convert markdown files to Word documents
•AI Generation: Generate complete documents from topics/prompts
•Rich Formatting: Headers, lists, tables, code blocks, quotes
•Custom Styling: Fonts, colors, margins, spacing
•Templates: Professional templates (report, letter, memo, resume)
•Table of Contents: Auto-generated TOC
•Headers/Footers: Page numbers, dates, custom text
•Images: Embed images from local files or URLs

Installation

bash

skills install generate-docx

Quick Start

From Markdown

bash

# Convert markdown to Word
skills run generate-docx -- document.md -o output.docx

# With custom styling
skills run generate-docx -- document.md --template report --font "Times New Roman"

AI Generation

bash

# Generate from topic
skills run generate-docx -- --topic "Project Proposal for Mobile App Development" -o proposal.docx

# With more control
skills run generate-docx -- --topic "Employee Handbook" \
  --sections 10 \
  --style formal \
  --template report \
  -o handbook.docx

From Text/Prompt

bash

# Generate from prompt
skills run generate-docx -- --prompt "Write a cover letter for a software engineer position at Google" -o cover-letter.docx

Options

Input Options

Flag	Description
`<file>`	Input markdown file
`--topic <text>`	Topic for AI to write about
`--prompt <text>`	Direct prompt for AI generation
`--text <text>`	Plain text content

AI Options

Flag	Default	Description
`--sections <n>`	5	Number of sections to generate
`--style <type>`	professional	Style: professional, casual, formal, academic
`--tone <type>`	neutral	Tone: neutral, friendly, authoritative
`--length <type>`	medium	Length: short, medium, long, comprehensive

Output Options

Flag	Default	Description
`-o, --output <path>`	auto	Output file path
`--dir <path>`	.skills/exports	Output directory

Template Options

Flag	Default	Description
`--template <name>`	default	Template: default, report, letter, memo, resume, article
`--title <text>`	auto	Document title
`--author <text>`	-	Author name
`--company <text>`	-	Company name
`--date <text>`	today	Document date

Styling Options

Flag	Default	Description
`--font <name>`	Calibri	Font family
`--font-size <pt>`	11	Base font size
`--heading-font <name>`	Calibri Light	Heading font
`--line-spacing <n>`	1.15	Line spacing multiplier
`--margins <inches>`	1	Page margins
`--page-size <size>`	letter	Page: letter, a4, legal

Content Options

Flag	Default	Description
`--toc`	false	Include table of contents
`--page-numbers`	true	Include page numbers
`--header <text>`	-	Header text
`--footer <text>`	-	Footer text

Templates

default

Clean, minimal document with standard formatting.

report

Professional report with title page, TOC, headers/footers.

letter

Business letter format with date, addresses, signature block.

memo

Internal memo format with To/From/Subject/Date header.

resume

CV/Resume format with sections for experience, education, skills.

article

Article/essay format with abstract and section numbering.

Examples

Example 1: Simple Markdown Conversion

bash

skills run generate-docx -- notes.md -o notes.docx

Example 2: Professional Report

bash

skills run generate-docx -- \
  --topic "Q4 2024 Sales Analysis" \
  --template report \
  --sections 8 \
  --style formal \
  --toc \
  --author "Sales Team" \
  --company "Acme Corp" \
  -o q4-report.docx

Example 3: Business Letter

bash

skills run generate-docx -- \
  --prompt "Write a business letter declining a partnership offer politely" \
  --template letter \
  --author "John Smith" \
  --company "Tech Solutions Inc" \
  -o decline-letter.docx

Example 4: Resume from Markdown

bash

skills run generate-docx -- resume.md \
  --template resume \
  --font "Garamond" \
  --margins 0.75 \
  -o my-resume.docx

Example 5: Academic Paper

bash

skills run generate-docx -- paper.md \
  --template article \
  --font "Times New Roman" \
  --font-size 12 \
  --line-spacing 2 \
  --toc \
  -o research-paper.docx

Example 6: Company Memo

bash

skills run generate-docx -- \
  --prompt "Write a memo announcing the new remote work policy" \
  --template memo \
  --author "HR Department" \
  -o remote-work-memo.docx

Markdown Support

The skill supports standard markdown plus extensions:

markdown

# Heading 1

## Heading 2

### Heading 3

Regular paragraph text with **bold**, _italic_, and `code`.

- Bullet list item 1
- Bullet list item 2
  - Nested item

1. Numbered list
2. Second item

> Block quote text

| Column 1 | Column 2 |
| -------- | -------- |
| Cell 1   | Cell 2   |

![Image](path/to/image.png)

---

Horizontal rule above

Environment Variables

bash

# Required for AI generation
export OPENAI_API_KEY="sk-..."

Credits

•Base conversion: 3 credits
•AI generation: +5 credits

Troubleshooting

Document won't open

•Ensure .docx extension is used
•Try opening in Google Docs or LibreOffice

Formatting looks wrong

•Different Word versions render slightly differently
•Try adjusting font and spacing options

Images not appearing

•Use absolute paths for local images
•Ensure image files exist

AI generation failed

•Check OPENAI_API_KEY is set
•Use markdown input instead of --topic

Related Skills

•generate-pdf - Create PDF documents
•generate-slides - Create presentations
•parse-pdf - Extract content from PDFs

Support

For issues or feature requests, visit skills.md/skills/generate-docx

code