---
name: format-prepare-document
description: "Plan a multi-section document before rendering it: section plan, brand-aware structure, complementary charts and diagrams, sign-off, then handoff to the right `format-*` renderer. Use when someone asks for a proposal, pitch, report, white paper, executive brief or board deck and the structure is not yet decided, or says 'help me plan or outline the document'. Not for a one-page memo, a single slide, an edit of an existing file, or when an approved section plan or envelope already exists: go straight to format-pdf-hd, format-pptx-hd, format-docx-hd or format-html-hd. Branding comes from the invoking plugin's brand overlay."
metadata:
  stromy-client-summary: "Start here for any substantial document: plan the structure together, then produce it in the right format."
---
<!--
  GENERATED FILE — DO NOT EDIT.
  Owner:       scripts/sync-mcp-skill-stubs.py (via sync-on-mcp-skill-change.yml)
  Source:      MCPs/stromy-format-mcp/skills/format-prepare-document/SKILL.md
  This workflow pushes DIRECT to this repo's main — a local edit here will be
  overwritten or rejected non-fast-forward. Edit the source, push, then:
    gh workflow run sync-on-mcp-skill-change.yml -R stromy-org/stromy-org
  Hand-authored skill? Set `_local: true` in frontmatter instead.
-->

# Format Prepare Document (MCP-hosted skill)

This skill's full instructions are hosted on the `stromy-format` MCP server. Do not hardcode workflow logic locally — always fetch the live version from the MCP.

## Loading instructions

1. Read the main skill instructions:
   → call the `fs_read` tool on the `stromy-format` MCP with `path="skills/format-prepare-document/SKILL.md"`.

   **Read it to the end.** `fs_read` returns one page at a time. If the result's `next_offset_chars` is not null — or the returned text ends in a `<<< PARTIAL READ … >>>` block — the body is incomplete: call `fs_read` again with `offset_chars` set to that value and concatenate, repeating until it comes back null. Do **not** start work on a partial skill body. Hard rules and anti-patterns often sit in the final third, and a partial read fails silently — it looks like a complete skill.

2. Discover reference files (and any other skill assets), then read on demand:
   → call `fs_list` with `path="skills/format-prepare-document"` (and `path="skills/format-prepare-document/references"`),
   → call `fs_read` with `path="skills/format-prepare-document/references/<file>"`.

Follow the instructions returned by the MCP exactly.

## This MCP is the only correct path

Produce this skill's output **only** by following the live SKILL.md fetched above and calling the `stromy-format` MCP's own tools. Do **not** substitute a local or identically-named base skill from elsewhere, and do **not** invent your own output path. A locally-produced or unbranded artifact is **wrong output, not a fallback** — it bypasses the server-side brand and quality gates.