markdown

markdown Skill

L0: One-line Summary

Create Markdown documents (.md) using the Write tool, with proper file output and delivery to the user.

L1: Overview and Use Cases

Capability

markdown is a Procedural Skill that serves as the default document format when users request written deliverables without specifying Word/PDF/Excel/PPT. Markdown files can be directly opened and edited in DesireCore's built-in SuperDoc editor.

Use Cases

• The user asks to create a report, summary, plan, outline, or any written document
• The user asks to organize information into a table or list
• The user asks to draft a memo, meeting notes, weekly report, etc.
• The user asks to "write something" or "make a document" without specifying format
• The user explicitly mentions "md", "markdown", or ".md"

L2: Detailed Specification

Output Rule (CRITICAL — violation = task failure)

After you create a .md file using the Write tool, you MUST complete these two final steps:

Final Step 1: Output a text reply containing:

• A brief summary of what was created or changed
• The file's full absolute path (copied from the Write tool result)

Template:

已为你创建「文档标题」，简要说明内容。

📄 文件位置：`/full/absolute/path/filename.md`

Final Step 2: Call SendUserMessage with the file as attachment. This MUST be your very last action. Do NOT output any text after this call.

SendUserMessage({
  message: "📄 点击下方附件打开文件",
  attachments: ["/full/absolute/path/filename.md"]
})

Correct vs Wrong

• ✅ Write → text reply (with absolute path) → SendUserMessage (with attachment) → done
• ❌ Write → text reply without absolute path
• ❌ Write → no SendUserMessage
• ❌ Write → SendUserMessage → more text output (e.g. "任务完成")
• ❌ No Write at all, content output directly in chat

Forbidden

• Outputting the full document content directly in the chat reply instead of writing to a file
• Saying "好的，已完成" / "整理好了" / "以下是内容" without calling Write tool
• Only giving a filename (e.g. "报告.md") without the full absolute path
• Not calling SendUserMessage to deliver the file attachment
• Outputting any text after SendUserMessage
• Writing memory files about the document creation task — creating/editing a document is a one-time task, NOT a user preference or fact to remember