Quick Ref / Command

Engineer Kit

/ak:document-skills

Edit Office-style documents

Read, create, and edit Office-style documents: docx, pdf, pptx, xlsx, tables, forms, slides, and spreadsheets.

01

Identify Format

02

Clarify Operation

03

Load Underlying Material

04

Inspect Existing File

Rule 01

The file format drives the workflow: docx, pdf, pptx, and xlsx have different constraints.

Rule 02

Preserve document semantics instead of flattening everything into text.

Rule 03

Use references, scripts, and resources from the skill rather than improvising a document pipeline.

Rule 04

Verify the produced artifact, not only the command that wrote it.

Execution Map

Core lanes from input to output, aligned with the command's real execution path.

01

Start

Input, scope, route

  1. 1 Identify Format Determine whether the task targets docx, pdf, pptx, xlsx, tables, forms, slides, or spreadsheets.
  2. 2 Clarify Operation Classify the requested operation as read, create, edit, extract, populate, convert, or summarize.
02

Work

Agent / skill execution

  1. 3 Load Underlying Material Use the skill's references, scripts, or resources directory for the concrete document workflow.
  2. 4 Inspect Existing File When editing or reading, inspect document structure and content before deciding what to change or extract.
03

Verify

Gate, review, validation

  1. 5 Preserve Structure Keep tables, forms, slide hierarchy, spreadsheet sheets, and document semantics intact unless the user asked to restructure them.
  2. 6 Apply Document Change Create or edit the Office artifact using the appropriate scripts or resources for that file type.
04

Close

Report, handoff, artifact

  1. 7 Verify Artifact Re-open or inspect the produced file enough to confirm the requested content, formatting surface, and data placement.
  2. 8 Return Usable File Report the file path, format, operations performed, and any limitations in extraction or conversion.

Syntax, arguments, subcommands

How to invoke the skill: syntax, positional arguments, shared options, then each subcommand with its own syntax and outcome.

Syntax

/ak:document-skills <docx|pdf|pptx|xlsx> [path] [action]

Arguments

<docx|pdf|pptx|xlsx> Required

Document format

Required format selector that chooses the Word, PDF, PowerPoint, or spreadsheet workflow. For multiple formats, run each format workflow and validate each artifact.

/ak:document-skills xlsx approved-metrics.csv create
[path]

Source or output path

Optional existing file, template, or destination path for the selected format. Preserve supplied templates and existing content unless the action says otherwise.

/ak:document-skills docx proposal.docx edit
[action]

Document action

Optional read, create, edit, extract, populate, convert, or summarize action. Distinguish extraction from editing, and inspect layout when the requested result depends on it.

/ak:document-skills pdf intake-form.pdf read

Modes / Routes

docx

Word document

Research:
Load docx resources
Review:
Check headings/tables/forms
Validate:
Re-open produced document
pdf

PDF

Research:
Load pdf resources
Review:
Check extraction/conversion limits
Validate:
Inspect rendered output
pptx

Slides

Research:
Load pptx resources
Review:
Check hierarchy and layout
Validate:
Review generated deck
xlsx

Spreadsheet

Research:
Load xlsx resources
Review:
Check sheets/tables/formulas
Validate:
Inspect workbook data

Sample Prompt

Concrete invocations for each flag, subcommand, mode, or route available in the live workflow.

Create spreadsheet Recommended
/ak:document-skills xlsx approved-metrics.csv create
Use when:
Use when tabular source data needs to become a real XLSX workbook rather than a prose table.
Expected:
Selects the xlsx workflow, uses the bundled spreadsheet material, creates the workbook from the CSV path, and inspects formulas, sheets, and cell placement before returning the output path.
Edit Word document
/ak:document-skills docx proposal.docx edit
Use when:
Use when a DOCX needs targeted content or structure edits while retaining Office document semantics.
Expected:
Routes to the docx workflow, inspects the existing document structure, applies the requested edits while preserving headings and tables, and verifies the edited artifact before delivery.
Read PDF form
/ak:document-skills pdf intake-form.pdf read
Use when:
Use when a PDF needs structured extraction, form-field reading, or artifact inspection instead of a plain summary.
Expected:
Uses the pdf workflow, inspects the file for structured content and form fields, extracts the requested data, and names any conversion or inspection limits in the result.
Build slide deck
/ak:document-skills pptx outline.md create
Use when:
Use when a PowerPoint deliverable must be created or updated as a PPTX artifact with slide structure.
Expected:
Routes to the pptx workflow, uses the bundled slide guidance, creates the deck from the outline path, and reviews slide structure, notes, and layout surface before returning it.

Handled Scope

  • Word document reading, authoring, and editing
  • PDF inspection, extraction, and generated output review
  • PowerPoint slide creation and updates
  • Excel workbook, sheet, table, and form handling
  • Document structure preservation across conversions or edits

Next