| name | word-maker |
| description | Guided Word document generation for editable DOCX reports, proposals, minutes, contracts, SOPs, and enterprise templates. |
name: word-maker
description: Create, revise, audit, and export Word documents through the Word Maker plugin.
risk_class: mutating_scoped
word-maker Skill Card
Use this plugin when the user asks to create, revise, audit, or export a Word
document. Prefer it over ad-hoc DOCX scripts when the task needs guided
requirements, source files, template variables, section iteration, or a
downloadable editable DOCX.
Trigger Scenarios
- Weekly, monthly, or daily reports.
- Meeting minutes.
- Project proposals and acceptance reports.
- Contract or agreement drafts.
- SOPs, policies, and internal process documents.
- Preparing a structured brief before making a PPT.
Tool Order
word_start_project
word_ingest_sources when files or notes are provided
word_upload_template and word_extract_template_vars when a template is used
word_generate_outline
word_confirm_outline
word_fill_template
word_audit
word_export
Do not claim a document is generated unless word_export returns a real output
path. Ask the user to confirm missing template fields instead of silently
leaving them blank.
Brain Usage
Use Brain for lightweight sub-tasks only:
- requirement clarification;
- outline generation;
- template field extraction;
- section rewriting;
- summary for future PPT generation.
If brain.access is unavailable, continue with manual fields and template
rendering.
Output Schema
Every tool response should include enough state for the user to continue:
project_id;
status;
next_action when a user decision is needed;
output_path when a file exists;
error and missing when generation is blocked.
Error Policy
Never return a vague "generation failed" message. Prefer specific categories:
missing_template_vars;
source_parse_failed;
template_render_failed;
brain_unavailable;
dependency_missing;
audit_failed.
PPT Handoff
When the user asks to turn the document into a PPT, export first and then call
word_export with publish_for_ppt=true. This publishes a
word_document_brief asset for ppt-maker when assets.publish is granted.
Testing
Run:
py -3.11 -m pytest plugins/word-maker/tests -q
py -3.11 -m ruff check plugins/word-maker --ignore N999
The N999 ignore is needed because OpenAkita plugin IDs use hyphenated
directories such as word-maker.