How do I install the Mdx Artifacts skill?

Run npx skillmds@latest add srobinson/mdx-artifacts in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Mdx Artifacts safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mdx Artifacts?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mdx Artifacts free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mdx Artifacts?

srobinson (@srobinson) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mdx Artifacts by srobinson — Agent Skill

Name: Mdx Artifacts
Author: srobinson

Mdx Artifacts

Choose and verify storage for agent artifacts. Use when work produces a review, research report, architecture or design document, plan, decision record, session trail, handoff, reusable verification file, or delegated report that may matter after the current turn.

srobinson cb03123 2 files · 1.6 KB Updated Sep 17, 2026

File contents

MDX artifacts

Classify an artifact before choosing its path.

Class	Location
Persistent research, review, or audit	`~/.mdx/research/`
Persistent architecture, design, specification, or plan	`~/.mdx/design/`
Persistent decision	`~/.mdx/decisions/`
Persistent session trail or handoff	`~/.mdx/sessions/`
Persistent project status or working knowledge	`~/.mdx/projects/`
Temporary worker or candidate material	`~/.mdx/TMP/pstack/<session>/`
Reproducible command output or transfer file	`/tmp`
Repository deliverable	A repository path only when the user asks or the repository already owns it

Never keep the only copy of a genuine artifact in /tmp.

For persistent Markdown:

Read ~/.mdx/_schema.md before writing.
Use its category, frontmatter, filename, and versioning rules.
Verify the final file exists and is readable.
Refresh the Markdown index when the md_index tool is available.
Return the absolute path.

For delegation, give each worker an exact artifact class and output path. Keep scratch separate from the final persistent artifact.

Frequently asked questions