Jay Griffin

Renaming the new-doc Skill to md-artifact

Why we renamed the new-doc skill to md-artifact and tightened up its trigger description.

May 7, 2026

The new-doc Cline skill got a rename today. It's now md-artifact.

Why

The original name and description were too generic. "Create a new markdown document summarizing a conversation or topic" could match almost anything - write a file, save some notes, document some code. The agent was at risk of firing this skill when you just wanted a quick file written somewhere, not a full structured post routed through Postmaster.

The fix was to make the trigger more intentional. md-artifact borrows from Anthropic's "artifact" concept - a deliberate, structured output meant to be reviewed and dispatched, not just a file that gets written and forgotten. The description now explicitly says not to use it for general file writing or code tasks.

What Changed

  • Skill directory renamed from new-doc/ to md-artifact/
  • Skill name and description updated in SKILL.md
  • Script path updated to reflect the new directory
  • Port reference fixed (was pointing to localhost:3000, Postmaster runs on 3333)
  • Removed the instruction to check if the drafts/ directory exists - it's part of the Postmaster repo, it's always there
  • Clarified the body-writing step: read the draft to get the script-generated frontmatter, don't rewrite it, just append the body

The Naming Logic

The name md-artifact is scoped intentionally. If other skills produce artifacts in the future (JSON artifacts, code artifacts, whatever), they'd be json-artifact, code-artifact, etc. The md- prefix keeps this one clearly in its lane.