feat(skill): teach the skill to generate documents, not just parse them

The generators shipped; every discovery surface here still described a
parser. An agent asked to "turn these notes into a PowerPoint" matched
nothing in the frontmatter description, and mcpConvert was the only tool
without a fallback script.

- description now triggers on create/generate/write/author/build/make
- new "Generating Documents" section: Markdown is the authoring format,
  what survives the trip, and what cannot — headers, footers, comments
  and tracked changes have no Markdown syntax, so the skill says so
  rather than letting an agent promise a running header
- new scripts/convert.sh, the missing fallback
- /api/v1/convert documented in Core Endpoints, api-reference.md (four
  input modes, response shape, metering) and integration-guide.md
  (Python/TS/curl)
- prompt-based AI generation recorded as CLI-only, absent from the
  hosted API, so agents do not offer it

Also fixes a live bug found on the way: all six scripts and all ten
resource-file examples defaulted to the dev Cloud Run URL while SKILL.md
stated "Default: production".

- block types 9 -> the real 11 (Link and Comment were missing)
- `encoding` documented as load-bearing everywhere it appears: base64
  for the six ZIP targets, utf8 for html/md/qmd, branch on the field
  and never on the target
- deployment/GCP section removed from the public skill; preserved in
  sunholo/docparse internal-docs/deploy-pipeline.md
- every sunholo.com link verified 200. Docs pages move to
  /ailang-parse/ (the /docparse/ ones are live 404s); the dashboard
  correctly stays on /docparse/

convert.sh usage, error and both decode paths verified; the error path
against production. The success path is NOT yet verified — the local
key is expired.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: MarkEdmondson1234

AGENTS.md

@@ -45,4 +45,4 @@ Per-document pricing (not per-page). Free: 1,000 requests/month, 50 AI parses. P
 
 Base URL: `https://docparse.ailang.sunholo.com`
 MCP endpoint: `https://docparse.ailang.sunholo.com/mcp/`
-Documentation: `https://www.sunholo.com/docparse/`
+Documentation: `https://www.sunholo.com/ailang-parse/`

CLAUDE.md

@@ -1,6 +1,6 @@
 # AILANG Parse — Claude Code Plugin
 
-This is the Claude Code plugin for [AILANG Parse](https://www.sunholo.com/docparse/), a universal document parsing and generation API.
+This is the Claude Code plugin for [AILANG Parse](https://www.sunholo.com/ailang-parse/), a universal document parsing and generation API.
 
 ## MCP Server
 
@@ -9,7 +9,7 @@ This plugin registers an MCP server at `https://docparse.ailang.sunholo.com/mcp/
 | Tool | Purpose | Auth Required |
 |------|---------|---------------|
 | `mcpParse` | Parse any document into blocks, Markdown, or HTML | Hosted: yes |
-| `mcpConvert` | Convert between 17 input and 9 output formats | Hosted: yes |
+| `mcpConvert` | Generate a document — docx, pptx, xlsx, odt, odp, ods, html, md, qmd | Hosted: yes |
 | `mcpFormats` | Discover formats, 26 samples, pricing tiers, capabilities | No |
 | `mcpEstimate` | Predict cost/latency before parsing | No |
 | `mcpAuth` | Start device auth to get an API key (RFC 8628) | No |

GEMINI.md

@@ -16,7 +16,7 @@ The plugin registers an MCP server at `https://docparse.ailang.sunholo.com/mcp/`
 1. **mcpFormats** — Discover formats, samples, pricing. Call this first.
 2. **mcpEstimate** — Predict cost/latency before parsing.
 3. **mcpParse** — Parse documents into blocks, Markdown, or HTML.
-4. **mcpConvert** — Convert between 17 input and 9 output formats.
+4. **mcpConvert** — Generate a document — docx, pptx, xlsx, odt, odp, ods, html, md, qmd.
 5. **mcpAuth** — Start RFC 8628 device auth to get an API key.
 6. **mcpAuthPoll** — Poll for auth completion.
 7. **mcpAccount** — View tier, quota, usage, pricing, history.
@@ -47,5 +47,5 @@ bash skills/ailang-parse/scripts/device-auth.sh       # Get API key
 ## API
 
 - Base URL: `https://docparse.ailang.sunholo.com`
-- Docs: `https://www.sunholo.com/docparse/`
+- Docs: `https://www.sunholo.com/ailang-parse/`
 - Pricing: Per-document (not per-page). Free tier: 1,000/month.

README.md

@@ -1,6 +1,6 @@
 # AILANG Parse — Claude Code Plugin
 
-Parse any document into structured blocks using the [AILANG Parse API](https://www.sunholo.com/docparse/).
+Parse any document into structured blocks — and generate documents in 9 formats — using the [AILANG Parse API](https://www.sunholo.com/ailang-parse/).
 
 ## Install
 
@@ -13,31 +13,44 @@ Inside Claude Code, add the marketplace and install the plugin:
 
 ## What It Does
 
-This plugin registers an **MCP server** and a **skill** for document parsing. When installed, Claude automatically gets 7 tools:
+This plugin registers an **MCP server** and a **skill** for document parsing and generation. When installed, Claude automatically gets these tools:
 
 | Tool | Purpose |
 |------|---------|
 | `mcpParse` | Parse any document into blocks, Markdown, or HTML |
-| `mcpConvert` | Convert between 17 input and 9 output formats |
+| `mcpConvert` | Generate a document — docx, pptx, xlsx, odt, odp, ods, html, md, qmd |
 | `mcpFormats` | Discover formats, samples, pricing, capabilities |
 | `mcpEstimate` | Predict cost/latency before parsing |
 | `mcpAuth` | Get an API key via device auth (RFC 8628) |
 | `mcpAuthPoll` | Poll for auth completion |
 | `mcpAccount` | View tier, quota, usage, pricing, history |
 
-Just ask Claude to parse a document — the MCP tools handle everything automatically, including authentication.
+Just ask Claude to parse or produce a document — the MCP tools handle everything automatically, including authentication.
 
 ## Quick Start
 
 ```
-# Ask Claude directly:
+# Reading documents:
 "Parse this DOCX file and show me the headings"
 "Extract tables from report.xlsx"
 "Convert this PDF to markdown"
-"What formats do you support for document parsing?"
+
+# Producing documents:
+"Turn these notes into a PowerPoint"
+"Write this up as a Word document"
+"Give me that summary as an .xlsx"
+"Export this analysis as Quarto"
+
+# About the service:
+"What formats do you support?"
 "How much would it cost to parse this file?"
 ```
 
+To generate a document, Claude writes Markdown and converts it — front matter,
+tables, inline formatting, links and embedded images all carry through. Headers,
+footers, comments and tracked changes have no Markdown syntax, so those survive
+only when converting *from* a document that already has them.
+
 No manual API key setup needed. If auth is required, Claude will walk you through the device auth flow.
 
 ## Manual API Key (Optional)
@@ -53,13 +66,19 @@ Or get one via:
 
 ## Supported Formats
 
+**Parsing:**
+
 | Category | Formats | Speed |
 |----------|---------|-------|
 | Office | DOCX, PPTX, XLSX, ODT, ODP, ODS | 5-50ms deterministic |
-| Text | CSV, Markdown, HTML, EPUB, EML, MBOX | 5-15ms deterministic |
+| Text | CSV, Markdown, HTML, EPUB, EML, MBOX, TEX, RTF | 5-15ms deterministic |
 | PDF/Image | PDF, PNG, JPG | AI-powered |
 | Audio/Video | MP3, MP4 | AI-powered |
 
+**Generation (9):** DOCX, PPTX, XLSX, ODT, ODP, ODS, HTML, Markdown, QMD (Quarto)
+
+Ask `mcpFormats` for the live list — it is the service's own answer and never goes stale.
+
 ## Pricing
 
 Per-document pricing (not per-page). A 1-page or 1,000-page document costs the same.
@@ -72,7 +91,7 @@ Per-document pricing (not per-page). A 1-page or 1,000-page document costs the s
 
 ## Links
 
-- [Documentation](https://www.sunholo.com/docparse/)
-- [API Reference](https://www.sunholo.com/docparse/api.html)
-- [MCP Server Guide](https://www.sunholo.com/docparse/mcp.html)
-- [Pricing](https://www.sunholo.com/docparse/pricing.html)
+- [Documentation](https://www.sunholo.com/ailang-parse/)
+- [API Reference](https://www.sunholo.com/ailang-parse/api.html)
+- [MCP Server Guide](https://www.sunholo.com/ailang-parse/mcp.html)
+- [Pricing](https://www.sunholo.com/ailang-parse/pricing.html)

plugins/ailang-parse/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ailang-parse",
-  "description": "AILANG Parse — Universal document parsing and generation. Parse 17 formats into structured blocks via MCP. Includes auth, billing, cost estimation, and account management tools for AI agents.",
-  "version": "0.10.0",
+  "description": "AILANG Parse — Universal document parsing and generation. Parse documents into structured blocks and generate DOCX, PPTX, XLSX, ODT, ODP, ODS, HTML, Markdown and Quarto via MCP. Includes auth, billing, cost estimation, and account tools.",
+  "version": "0.11.0",
   "author": {
     "name": "Holosun ApS"
   }