file-generator

name	file-generator
description	Generate downloadable files from provided content, including basic exports, styled DOCX documents, HTML-rendered PDFs, and static editable PPTX decks.
when_to_use	Use this skill when the user asks to create, export, save, download, or produce a file such as TXT, Markdown, HTML, JSON, CSV, DOCX, XLSX, PDF, or PPTX.
provider_type	builtin
provider_id	file_generator
runtime_type	tool
tools	["generate_file","generate_docx","generate_pdf","generate_pptx"]
supported_callers	["aichat","agent","workflow"]
max_calls_per_turn	5
timeout_seconds	60
display	{"icon":"file-plus","category":"productivity","label":{"en_US":"File Generator","zh_Hans":"文件生成器"},"description":{"en_US":"Creates downloadable TXT, Markdown, HTML, JSON, CSV, DOCX, XLSX, PDF, and PPTX files.","zh_Hans":"创建可下载的 TXT、Markdown、HTML、JSON、CSV、DOCX、XLSX、PDF 和 PPTX 文件。"},"when_to_use":{"en_US":"Use when the answer should be delivered as a generated file.","zh_Hans":"当回答需要以生成文件交付时启用。"},"tags":{"en_US":["File","Export"],"zh_Hans":["文件","导出"]}}

File Generator Skill

Use this skill when the user wants an answer delivered as a downloadable file artifact. This skill creates new workflow files; it does not edit an existing uploaded file.

Workflow

1. Decide the target file format from the user's request.
2. If the user did not specify a format, choose the most appropriate supported format:
   • Use md for reports, notes, plans, structured prose, and documentation drafts.
   • Use docx when the user explicitly asks for Word, an editable document, or a formal document file.
   • Use xlsx when the user explicitly asks for Excel or a spreadsheet workbook. Provide valid CSV content.
   • Use pdf when the user explicitly asks for PDF or a simple read-only distribution file.
   • Use pptx when the user explicitly asks for PowerPoint, slides, a deck, or an editable presentation.
   • Use txt for plain text without formatting.
   • Use html for runnable HTML pages or previewable web documents.
   • Use json for machine-readable structured data.
   • Use csv for table-like data.
3. Read the reference document for the selected format before calling a tool.
4. Use generate_file for simple exports.
5. Use generate_docx when a Word document needs headings, fonts, font sizes, alignment, spacing, page margins, page breaks, colored/bold/underlined text, or simple tables.
6. Use generate_pdf when a PDF needs richer layout, print CSS, tables, colors, page margins, page breaks, or business-report formatting.
7. Use generate_pptx when the user needs an editable static PowerPoint deck.
8. For PPTX, plan the slide layout before writing JSON. Use non-overlapping boxes for titles, text, and tables. Split dense content into more slides instead of shrinking text or stacking elements.
9. For PPTX with Chinese or other dense text, treat "more text" as more slides, not denser text boxes. Keep body paragraphs short; use bullets, columns, or additional slides before exceeding the readable capacity of a box.
10. Before calling generate_pptx, self-check that each slide's readable content fits within the slide bounds, does not overlap, uses explicit x, y, w, and h when the layout matters, and avoids long unbroken lines.
11. Use persistent lifecycle by default unless the user asks for a temporary file.
12. In the final answer, briefly mention the generated filename and format.
13. Do not invent, rewrite, shorten, or manually format download links. The system UI displays generated file download controls from structured artifact events.

References

Read exactly one reference after choosing the target format:

Requested format	Read reference
txt, text	format-txt.md
md, markdown	format-md.md
html, htm	format-html.md
json	format-json.md
csv	format-csv.md
simple docx, word	format-docx.md
styled docx, word	format-docx-rich.md
xlsx, excel	format-xlsx.md
simple pdf	format-pdf.md
HTML-rendered pdf	format-pdf-html.md
pptx, powerpoint, presentation, slides	format-pptx.md

Constraints

• The skill creates new files only. It does not edit existing uploaded files or preserve an existing template.
• Do not call generate_file, generate_docx, generate_pdf, or generate_pptx until the selected format reference has been read.
• generate_file accepts only its documented simple parameters. Do not invent format-specific parameters such as sheets, styles, pages, columns, headers, or metadata. XLSX output applies the default table styling documented in format-xlsx.md; the caller cannot customize those styles through generate_file.
• generate_docx accepts a JSON string document specification. Do not pass raw Markdown or HTML as document.
• generate_pdf accepts self-contained HTML and optional inline CSS. Do not pass JSON document specs.
• generate_pptx accepts a JSON string presentation specification. Do not pass HTML or Markdown as presentation.
• PPTX readable content should not use negative coordinates. Negative x or y is only appropriate for decorative shapes that intentionally bleed off an edge.
• Generated file content must fit within the backend file size limit.
• Do not include filesystem paths in filenames.
• Do not claim a file was generated unless the tool call succeeded.
• If the user asks for advanced document features that the selected reference says are unsupported, generate the closest supported file only when that still satisfies the request.

Tool Usage

generate_file accepts:

• content: text content to write into the file.
• format: txt, md, html, json, csv, docx, xlsx, or pdf.
• filename: optional display filename. The extension is added automatically.
• title: optional title used by generated HTML, XLSX, and PDF files. For XLSX, this becomes a merged title row above the table.
• lifecycle: optional file lifecycle, persistent or temporary. Defaults to persistent.

generate_docx accepts:

• document: JSON string describing the styled DOCX document.
• filename: optional display filename. The .docx extension is added automatically.
• title: optional title hint. Visible content must be in document.blocks.
• lifecycle: optional file lifecycle, persistent or temporary. Defaults to persistent.

generate_pdf accepts:

• html: self-contained HTML body or full HTML document.
• css: optional inline CSS appended to the document.
• filename: optional display filename. The .pdf extension is added automatically.
• title: optional title used when wrapping an HTML fragment. Visible content must be in html.
• lifecycle: optional file lifecycle, persistent or temporary. Defaults to persistent.

generate_pptx accepts:

• presentation: JSON string describing the editable static PPTX deck.
• filename: optional display filename. The .pptx extension is added automatically.
• title: optional title hint. Visible content must be in presentation.slides.
• lifecycle: optional file lifecycle, persistent or temporary. Defaults to persistent.