markdown-documents

Create and edit Markdown documents, notes, reports, and briefs as saved files.

19.1k|3.8k|Updated Jun 10, 2024
One-click install
npx skills add https://github.com/agent0ai/agent-zero --skill markdown-documents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-documents
Source: https://github.com/agent0ai/agent-zero/tree/main/plugins/_office/skills/markdown-documents
Command: npx skills add https://github.com/agent0ai/agent-zero --skill markdown-documents

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It gives the agent a consistent workflow for producing durable, editable Markdown files instead of losing writing in chat, and clarifies when Markdown should be preferred over binary office formats like ODT or DOCX.

Core Features & Use Cases

  • Markdown-first authoring: Creates notes, reports, briefs, and drafts as saved .md files using the text_editor tool with explicit paths.
  • Targeted editing: Reads existing files before changes and applies patch-based edits for small fixes or full rewrites for deliberate replacements.
  • Editor surface discipline: Keeps the user-owned Editor UI closed unless explicitly requested, reporting only the saved file path.
  • Use Case: Ask the agent to draft a project brief; it writes a structured Markdown file to the workdir and reports the path without forcing a document-editor workflow.

Quick Start

Ask the agent to create a Markdown project brief saved as a file in the working directory.

Frequently Asked Questions about markdown-documents

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

FAQPage Schema
How do I create a Markdown document with the agent?

Ask the agent to write the content as a Markdown file. It uses the text_editor tool with the write action and an explicit .md path, then reports the saved file location without opening the Editor automatically.

When should I use Markdown instead of DOCX or ODT?

Use Markdown for normal writing, notes, reports, and drafts since it stays editable and lightweight. Choose ODT, ODS, or ODP only when a LibreOffice file is explicitly needed, and DOCX or XLSX only for OOXML compatibility.

How are edits to an existing Markdown file handled?

The agent reads the existing file first when content matters, then applies a patch for targeted changes or a full write for deliberate replacement. Small fixes like typos are updated directly without a document-editor workflow.

Does the Markdown Editor open automatically after saving?

No. The Editor surface is user-owned UI and only opens when you explicitly ask for the canvas or Editor. Already-open Editor sessions refresh automatically when the underlying file changes.

When should a Markdown file not be created?

Skip file creation for tiny one-shot edits or answers that can be completed cleanly in chat. Saved Markdown artifacts are meant for substantial, reusable, or collaborative writing.