Markdown artifacts

SkillFiles & storage

Build or revise a plain markdown file (md) deliverable such as notes, a README, meeting minutes, documentation, or text the user will edit or paste elsewhere. Use whenever a build task's artifact kind is markdown. Covers markdown formatting conventions and read-back verification.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Markdown artifacts skill

What this skill tells your AI

The instructions your AI receives, as published by win4r/museai-skills in opt/hatch/skills/artifacts/markdown/SKILL.md and read by ahel’s review.

A markdown deliverable is plain text written directly with the file tools: append sections with muse.write in append mode, keep each write small, and use muse.edit for surgical fixes. There is no compile step; the file at <slug>.md in the project directory root is the deliverable.

TaskRead first
Formatting (tables, lists, emphasis, headings)/opt/hatch/skills/artifacts/references/markdown.md (shared)

Structure follows the content: real markdown headings, real list syntax, tables only where rows and columns genuinely align. The file ships as the user's own text, so no build scaffolding, no HTML unless the user asked for it, and no trailing commentary that isn't part of the document.

Verification

Follow /opt/hatch/skills/artifacts/testing/SKILL.md: read the finished file back in full before returning the link, checking structure renders as intended and no placeholder or scratch content remains.

Signals

GitHub stars
293
Forks
93
Last commit
Sep 2026
Advanced
Item type
skill
Key
artifact-markdown
Source
github.com/win4r/museai-skills