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 "<document task>"

Arguments

"<document task>" Required

Document task

Natural-language request naming the source file, target output, operation, preservation needs, and verification standard. The Skill declares no separate positional arguments or default output directory.

/ak:document-skills "Create board-report.xlsx from approved-metrics.csv with formulas for totals and growth, preserve source precision, add a Sources sheet, recalculate with LibreOffice, scan every formula result for errors, and save to ./deliverables without changing the CSV."

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 "Create board-report.xlsx from approved-metrics.csv with formulas for totals and growth, add a Sources sheet, and verify the workbook before returning the output path."
Use when:
Use when tabular source data needs to become a real XLSX workbook rather than a prose table.
Expected:
Classifies the request as xlsx work, uses the bundled document material for spreadsheets, creates the workbook artifact, and inspects formulas, sheets, and cell placement before delivery.
Edit Word document
/ak:document-skills "Update proposal.docx with the approved executive summary, preserve existing headings and tables, and return a verified edited copy instead of overwriting the original."
Use when:
Use when a DOCX needs targeted content or structure edits while retaining Office document semantics.
Expected:
Routes the task to docx handling, inspects the existing document structure, applies the requested edits to a separate artifact, and verifies that headings, tables, and requested content survived.
Read PDF form
/ak:document-skills "Read intake-form.pdf, extract its form fields and table content, and report any extraction limits or fields that require visual inspection."
Use when:
Use when a PDF needs structured extraction, form-field reading, or artifact inspection instead of a plain summary.
Expected:
Uses the PDF route, 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 "Create a 10-slide project-update.pptx from outline.md, use the supplied template, keep speaker notes where provided, and verify the deck layout before delivery."
Use when:
Use when a PowerPoint deliverable must be created or updated as a PPTX artifact with slide structure.
Expected:
Routes the request to pptx handling, uses the bundled document guidance for slides, creates the deck artifact, 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