markdown-writer

Write Markdown content to disk atomically via the MCP markdown-writer server.

2|Updated Aug 26, 2025
One-click install
npx skills add https://github.com/robertbagge/claude-starter --skill markdown-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-writer
Source: https://github.com/robertbagge/claude-starter/tree/main/.claude/skills/markdown-writer
Command: npx skills add https://github.com/robertbagge/claude-starter --skill markdown-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables writing Markdown content to disk reliably using the MCP markdown-writer server, with atomic writes, automatic directory creation, and optional verification. It helps automate persistence of generated docs, notes, or research outputs without prompts for user permission.

Core Features & Use Cases

  • Atomic writes: writes to a temporary file and then atomically renames to guarantee consistency.
  • Directory auto-creation & validation: creates parent directories as needed and validates paths to prevent traversal.
  • Guaranteed persistence: supports both absolute and repository-root relative paths for safe storage of Markdown content.
  • Use case: Generate a report and persist it as /docs/research/summary.md, ensuring the file is either fully written or not created at all.

Quick Start

Use the markdown-writer to save content to a file, for example: path: /tmp/notes.md content:

Your Markdown Content

Multi-line content is supported.

Frequently Asked Questions about markdown-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write markdown files to disk atomically without data loss?

Atomic writes ensure your markdown file is either fully written or not created at all. This Skill writes to a temporary file first, then atomically renames it to the target path, preventing partial or corrupted files if the process is interrupted.

Can I automatically create parent directories when writing markdown files?

Yes, this Skill automatically creates any missing parent directories as needed. When you specify a path like /docs/research/summary.md, all intermediate directories are created if they don't exist, so you don't need to set them up manually.

How do I persist generated documentation or reports without user prompts?

This Skill writes markdown content directly to disk without requiring user confirmation, making it ideal for agents that generate documentation, notes, or research outputs and need to save them automatically in the background.

What prevents directory traversal attacks when writing markdown files?

Path validation built into this Skill checks for traversal attempts and enforces safe paths. It supports both absolute and repository-root relative paths while blocking malicious path patterns, keeping your file writes secure.

Can I verify the file was written correctly after saving markdown?

Yes, optional verification reports file size and confirms successful writes. After the atomic write completes, you can retrieve metadata about the persisted file to ensure the operation succeeded.