How do I install the Drafts skill?

Run npx skillmds@latest add kbarbel640-del/drafts 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 Drafts safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Drafts?

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 Drafts free to use?

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

Who published Drafts?

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

Drafts by kbarbel640-del — Agent Skill

Name: Drafts
Rating: 4.2 (5 reviews)
Author: kbarbel640-del

Drafts

Manage Drafts app notes via CLI on macOS. Create, view, list, edit, append, prepend, and run actions on drafts. Use when a user asks to create a note, list drafts, search drafts, or manage their Drafts inbox. IMPORTANT - Drafts app must be running on macOS for this to work.

kbarbel640-del Updated Sep 8, 2026 1 repo stars

File contents

Drafts CLI

Manage Drafts notes from the terminal on macOS.

IMPORTANT REQUIREMENTS

This CLI ONLY works on macOS with Drafts app running.

macOS only - Uses AppleScript, will not work on Linux/Windows
Drafts must be RUNNING - The app must be open for any command to work
Drafts Pro required - Automation features require Pro subscription

If commands fail or hang, first check: open -a Drafts

Setup

Install via Go:

go install github.com/nerveband/drafts/cmd/drafts@latest

Or build from source:

git clone https://github.com/nerveband/drafts
cd drafts && go build ./cmd/drafts

Commands

Create a Draft

# Simple draft
drafts create "Meeting notes for Monday"

# With tags
drafts create "Shopping list" -t groceries -t todo

# Flagged draft
drafts create "Urgent reminder" -f

# Create in archive
drafts create "Reference note" -a

List Drafts

# List inbox (default)
drafts list

# List archived drafts
drafts list -f archive

# List trashed drafts
drafts list -f trash

# List all drafts
drafts list -f all

# Filter by tag
drafts list -t mytag

Get a Draft

# Get specific draft
drafts get <uuid>

# Get active draft (currently open in Drafts)
drafts get

Modify Drafts

# Prepend text
drafts prepend "New first line" -u <uuid>

# Append text
drafts append "Added at the end" -u <uuid>

# Replace entire content
drafts replace "Completely new content" -u <uuid>

Edit in Editor

drafts edit <uuid>

Run Actions

# Run action on text
drafts run "Copy" "Text to copy to clipboard"

# Run action on existing draft
drafts run "Copy" -u <uuid>

Get Schema

# Full schema for LLM integration
drafts schema

# Schema for specific command
drafts schema create

Output Format

JSON (default) - All commands return structured JSON:

{
  "success": true,
  "data": {
    "uuid": "ABC123",
    "content": "Note content",
    "title": "Note title",
    "tags": ["tag1", "tag2"],
    "folder": "inbox"
  }
}

Plain text - Human-readable output:

drafts list --plain

Common Workflows

Quick Capture

drafts create "Remember to call dentist tomorrow" -t reminder

Daily Journal

drafts append "$(date): Completed project review" -u <journal-uuid>

Search and Review

# List all drafts with a specific tag
drafts list -t work

# Get full content of a draft
drafts get <uuid>

Troubleshooting

Commands fail or return empty:

Is Drafts running? → open -a Drafts
Is Drafts Pro active? → Automation requires Pro
Permissions granted? → System Settings > Privacy > Automation

Commands hang:

Check if Drafts is showing a dialog

Notes

macOS ONLY (AppleScript-based)
Drafts app MUST be running
Requires Drafts Pro subscription
All UUIDs are Drafts-generated identifiers
Tags are case-sensitive

Version

Latest (from go install)

---name: draftsdescription: Manage Drafts app notes via CLI on macOS. Create, view, list, edit, append, prepend, and run actions on drafts. Use when a user asks to create a note, list drafts, search drafts, or manage their Drafts inbox. IMPORTANT - Drafts app must be running on macOS for this to work.---# Drafts CLIManage [Drafts](https://getdrafts.com) notes from the terminal on macOS.## IMPORTANT REQUIREMENTS> **This CLI ONLY works on macOS with Drafts app running.**- **macOS only** - Uses AppleScript, will not work on Linux/Windows- **Drafts must be RUNNING** - The app must be open for any command to work- **Drafts Pro required** - Automation features require Pro subscriptionIf commands fail or hang, first check: `open -a Drafts`## SetupInstall via Go:```bashgo install github.com/nerveband/drafts/cmd/drafts@latest```Or build from source:```bashgit clone https://github.com/nerveband/draftscd drafts && go build ./cmd/drafts```## Commands### Create a Draft```bash# Simple draftdrafts create "Meeting notes for Monday"# With tagsdrafts create "Shopping list" -t groceries -t todo# Flagged draftdrafts create "Urgent reminder" -f# Create in archivedrafts create "Reference note" -a```### List Drafts```bash# List inbox (default)drafts list# List archived draftsdrafts list -f archive# List trashed draftsdrafts list -f trash# List all draftsdrafts list -f all# Filter by tagdrafts list -t mytag```### Get a Draft```bash# Get specific draftdrafts get <uuid># Get active draft (currently open in Drafts)drafts get```### Modify Drafts```bash# Prepend textdrafts prepend "New first line" -u <uuid># Append textdrafts append "Added at the end" -u <uuid># Replace entire contentdrafts replace "Completely new content" -u <uuid>```### Edit in Editor```bashdrafts edit <uuid>```### Run Actions```bash# Run action on textdrafts run "Copy" "Text to copy to clipboard"# Run action on existing draftdrafts run "Copy" -u <uuid>```### Get Schema```bash# Full schema for LLM integrationdrafts schema# Schema for specific commanddrafts schema create```## Output Format**JSON (default)** - All commands return structured JSON:```json{ "success": true, "data": { "uuid": "ABC123", "content": "Note content", "title": "Note title", "tags": ["tag1", "tag2"], "folder": "inbox" }}```**Plain text** - Human-readable output:```bashdrafts list --plain```## Common Workflows### Quick Capture```bashdrafts create "Remember to call dentist tomorrow" -t reminder```### Daily Journal```bashdrafts append "$(date): Completed project review" -u <journal-uuid>```### Search and Review```bash# List all drafts with a specific tagdrafts list -t work# Get full content of a draftdrafts get <uuid>```## Troubleshooting**Commands fail or return empty:**1. Is Drafts running? → `open -a Drafts`2. Is Drafts Pro active? → Automation requires Pro3. Permissions granted? → System Settings > Privacy > Automation**Commands hang:**- Check if Drafts is showing a dialog## Notes- macOS ONLY (AppleScript-based)- Drafts app MUST be running- Requires Drafts Pro subscription- All UUIDs are Drafts-generated identifiers- Tags are case-sensitive## VersionLatest (from go install)

Frequently asked questions