Format Docs

Prepare markdown documents for clean Confluence publishing via orbit confluence publish. This skill analyzes and transforms markdown files — individually or as a directory tree — to follow the conventions that Confluence expects.

When to Use

• Before running orbit confluence publish for the first time on a docs directory
• When adding new markdown files to an existing published docs tree
• When docs render poorly in Confluence and need structural fixes
• When migrating docs from another system (GitHub wiki, Notion export, etc.)

Process

1. Assess the Scope

Determine whether the user is asking about a single file or a directory.

• Single file: Read it and apply the file-level checks below.
• Directory: List the full tree, then work through both directory-level and file-level checks.