Claude Drafts Actions Skill

A comprehensive Claude Code skill for creating and scripting actions in Drafts, the powerful text capture and automation app for iOS and macOS.

Overview

This skill provides Claude with expert knowledge about Drafts actions, including:

• Creating and configuring actions through UI and programmatic approaches
• Understanding all 37+ action step types (System, Service, Utility, and Advanced)
• Working with Drafts' template system and custom template tags
• JavaScript scripting with the complete Drafts API
• API integrations and HTTP requests
• Best practices for action organization and workflow design

Features

Comprehensive Action Coverage

• System Steps: Share, Clipboard, Mail, Message, Reminders, Calendar, Export, Print, and more
• Service Integrations: Dropbox, Google Drive, Notion, Todoist, WordPress, Medium, Mastodon, and 15+ others
• Utility Steps: Create drafts, insert text, define template tags, configure UI
• Advanced Steps: JavaScript scripting, HTML previews, prompts, shortcuts integration, URL schemes

Template System Mastery

• All template tag types and modifiers
• Date/time formatting with strftime and DateFormatter
• Custom template tag creation
• URL encoding and Markdown conversion
• Template files and external content loading

JavaScript API Reference

Complete API documentation for:

• Draft object (content, metadata, tags, queries)
• Editor object (text manipulation, selection control)
• App object (UI messages, navigation, clipboard)
• HTTP requests and network operations
• Service integrations (Mail, Reminders, Calendar, file storage)
• Utility objects (Prompt, HTMLPreview, FileManager)

Real-World Examples

• Quick capture to external services
• File export with timestamps
• Multi-service publishing workflows
• Conditional processing with scripts
• Batch operations on drafts
• API integrations (includes complete Claude API translation example)

Installation

For Claude Code Users

1. Download or clone this repository

2. Copy the entire claude-drafts-action-skill folder to your Claude Code skills directory:

   • User skills: ~/.claude/skills/
   • Project skills: <project>/.claude/skills/

3. The skill will be automatically loaded and available in Claude Code

Directory Structure

claude-drafts-action-skill/
├── SKILL.md                              # Main skill documentation
└── references/
    ├── action-steps-reference.md         # Detailed step type reference
    └── scripting-api-reference.md        # Complete JavaScript API docs

Usage

Once installed, Claude will automatically use this skill when you ask about Drafts-related tasks:

Examples:

"Create a Drafts action that sends my draft to Notion"

"How do I use template tags to format dates in Drafts?"

"Write a script to batch process all flagged drafts"

"Help me integrate the Claude API into a Drafts action"

"What's the best way to export drafts to Markdown files with timestamps?"

The skill provides context-aware assistance with:

• Action design and configuration
• Template syntax and usage
• JavaScript scripting
• API integration patterns
• Troubleshooting and best practices

What This Skill Covers

Action Creation

• UI-based and programmatic action creation
• Action sharing and export
• Action groups and organization

Action Steps

• 11 System steps (native iOS/macOS integration)
• 22 Service integrations (cloud storage, task managers, publishing platforms)
• 4 Utility steps (draft management, UI control)
• 9 Advanced steps (scripting, shortcuts, HTML, callbacks)

Scripting

• Core objects: Draft, Editor, App, Context, Script
• HTTP and network requests
• Service integrations via API
• Error handling and flow control
• Asynchronous operations

Templates

• Content tags (draft, title, body, selection)
• Date/time formatting
• Location data
• Custom tags and modifiers
• Template files

Reference Documentation

The skill includes two comprehensive reference documents:

references/action-steps-reference.md

Detailed documentation for all 37+ action step types with:

• Configuration options
• Parameters and settings
• Example use cases
• Platform-specific notes

references/scripting-api-reference.md

Complete JavaScript API reference covering:

• All major objects with method signatures
• HTTP request patterns
• Service integration examples
• Common code patterns
• Error handling best practices

Requirements

• Claude Code with skills support
• Drafts app knowledge is helpful but not required (skill provides full context)

Contributing

Contributions are welcome! If you find errors, have suggestions for improvements, or want to add examples:

1. Fork this repository
2. Create a feature branch
3. Submit a pull request with your changes

License

This skill documentation is provided as-is for use with Claude Code. Feel free to modify and distribute.

Resources

• Drafts Official Website
• Drafts Documentation
• Drafts Scripting Reference
• Drafts Action Directory
• Claude Code Documentation

Acknowledgments

This skill was created to enhance Claude Code's ability to assist with Drafts automation. All Drafts features and APIs are created and maintained by Agile Tortoise.

---

Note: This is a Claude Code skill for AI assistance, not an official Drafts extension or plugin. It provides knowledge and guidance for working with Drafts but does not modify or extend the Drafts app itself.