Typefully Skill
by @chapati23
Create, schedule, list, edit, and delete drafts on Typefully. Supports single tweets, threads, and multi-platform posts (X, LinkedIn, Threads, Bluesky, Masto...
clawhub install typefully-draftsπ About This Skill
name: typefully description: Create, schedule, list, edit, and delete drafts on Typefully. Supports single tweets, threads, and multi-platform posts (X, LinkedIn, Threads, Bluesky, Mastodon). Use when user wants to draft, schedule, or manage social media posts via Typefully. version: 1.2.0 homepage: https://github.com/gisk0/typefully-skill requires: env: - TYPEFULLY_API_KEY tools: - curl - python3
Typefully Skill
Manage Typefully drafts via the v2 API.
Setup
1. Set your API key via one of:
- Environment variable: export TYPEFULLY_API_KEY=your-key
- Password store: pass insert typefully/api-key
2. (Optional) Set your social set ID:
- Environment variable: export TYPEFULLY_SOCIAL_SET_ID=123456
- Password store: pass insert typefully/social-set-id
- If not set, the script auto-detects (errors if multiple accounts exist β use list-social-sets to find yours)
3. Enable "Development mode" in Typefully Settings β API to see draft IDs in the UI.
Script Usage
bash scripts/typefully.sh [options]
Commands
| Command | Description |
|---------|-------------|
| list-drafts [status] [limit] | List drafts. Status: draft, scheduled, published (default: all). Limit default: 10. |
| create-draft | Create a draft. For threads, separate posts with \n---\n. Use - or omit text to read from stdin. Default platform: x. |
| get-draft | Get a single draft with full details. |
| edit-draft | Update draft content. Supports --thread for thread editing. |
| schedule-draft | Schedule or publish a draft. |
| delete-draft | Delete a draft. |
| list-social-sets | List available social sets (accounts). |
Examples
Create a simple tweet draft:
bash scripts/typefully.sh create-draft "Just shipped a new feature π"
Create a thread:
bash scripts/typefully.sh create-draft "First tweet of the thread\n---\nSecond tweet\n---\nThird tweet" --thread
Create a thread from stdin (for longer content):
cat <<'EOF' | bash scripts/typefully.sh create-draft - --thread
First tweet of the thread\n---\nSecond tweet\n---\nThird tweet with the punchline
EOF
Create cross-platform draft (X + LinkedIn):
bash scripts/typefully.sh create-draft "Exciting update!" --platform x,linkedin
Schedule a draft for a specific time:
bash scripts/typefully.sh create-draft "Morning thoughts βοΈ" --schedule "2026-03-01T09:00:00Z"
Schedule to next free slot:
bash scripts/typefully.sh schedule-draft 8196074 next-free-slot
List recent drafts:
bash scripts/typefully.sh list-drafts draft 5
Notes
publish_at: "now" publishes immediately β use with cautionpublish_at: "next-free-slot" uses the user's Typefully queue schedule\n---\n in the text argumentjq for formattingπ‘ Examples
Create a simple tweet draft:
bash scripts/typefully.sh create-draft "Just shipped a new feature π"
Create a thread:
bash scripts/typefully.sh create-draft "First tweet of the thread\n---\nSecond tweet\n---\nThird tweet" --thread
Create a thread from stdin (for longer content):
cat <<'EOF' | bash scripts/typefully.sh create-draft - --thread
First tweet of the thread\n---\nSecond tweet\n---\nThird tweet with the punchline
EOF
Create cross-platform draft (X + LinkedIn):
bash scripts/typefully.sh create-draft "Exciting update!" --platform x,linkedin
Schedule a draft for a specific time:
bash scripts/typefully.sh create-draft "Morning thoughts βοΈ" --schedule "2026-03-01T09:00:00Z"
Schedule to next free slot:
bash scripts/typefully.sh schedule-draft 8196074 next-free-slot
List recent drafts:
bash scripts/typefully.sh list-drafts draft 5
βοΈ Configuration
1. Set your API key via one of:
- Environment variable: export TYPEFULLY_API_KEY=your-key
- Password store: pass insert typefully/api-key
2. (Optional) Set your social set ID:
- Environment variable: export TYPEFULLY_SOCIAL_SET_ID=123456
- Password store: pass insert typefully/social-set-id
- If not set, the script auto-detects (errors if multiple accounts exist β use list-social-sets to find yours)
3. Enable "Development mode" in Typefully Settings β API to see draft IDs in the UI.
π Tips & Best Practices
publish_at: "now" publishes immediately β use with cautionpublish_at: "next-free-slot" uses the user's Typefully queue schedule\n---\n in the text argumentjq for formatting