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

1. word_start_project
2. word_ingest_sources when files or notes are provided
3. word_upload_template and word_extract_template_vars when a template is used
4. word_clarify_requirements when requirements are vague or incomplete
5. word_generate_outline
6. word_confirm_outline
7. word_extract_fields when a template needs values from sources
8. word_fill_template
9. word_audit
10. 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:

bash
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.