surface-skill

Decide which output format (HTML, Markdown, JSON, SVG, hybrid) an agent should generate based on the task's intent, consumer, lifecycle, size, and content type. Use this skill whenever the user asks for a report, spec, code review, dashboard, summary, plan, doc, data extraction, or any deliverable where the format choice is implicit — even when they don't explicitly ask "what format should I use?". Apply this skill before generating any substantive artifact (>20 lines) to avoid defaulting to Markdown when HTML, JSON, or a hybrid would serve the consumer better.

Decide which output format (HTML, Markdown, JSON, SVG, hybrid) an agent should generate based on the task's intent, consumer, lifecycle, size, and content type. Use this skill whenever the user asks for a report, spec, code review, dashboard, summary, plan, doc, data extraction, or any deliverable where the format choice is implicit — even when they don't explicitly ask "what format should I use?". Apply this skill before generating any substantive artifact (>20 lines) to avoid defaulting to Markdown when HTML, JSON, or a hybrid would serve the consumer better.