Typefully Skill

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.

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

bash scripts/typefully.sh <command> [options]

Commands

Command	Description
list-drafts [status] [limit]	List drafts. Status: draft, scheduled, published (default: all). Limit default: 10.
create-draft <text> [--thread] [--platform x,linkedin,...] [--schedule <iso8601|next-free-slot>]	Create a draft. For threads, separate posts with \n---\n. Use - or omit text to read from stdin. Default platform: x.
get-draft <draft_id>	Get a single draft with full details.
edit-draft <draft_id> <text> [--thread] [--platform x,linkedin]	Update draft content. Supports --thread for thread editing.
schedule-draft <draft_id> <iso8601|next-free-slot|now>	Schedule or publish a draft.
delete-draft <draft_id>	Delete a draft.
list-social-sets	List available social sets (accounts).

Examples

Create a simple tweet draft:

bash

bash scripts/typefully.sh create-draft "Just shipped a new feature 🚀"

Create a thread:

bash

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):

bash

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

bash scripts/typefully.sh create-draft "Exciting update!" --platform x,linkedin

Schedule a draft for a specific time:

bash

bash scripts/typefully.sh create-draft "Morning thoughts ☀️" --schedule "2026-03-01T09:00:00Z"

Schedule to next free slot:

bash

bash scripts/typefully.sh schedule-draft 8196074 next-free-slot

List recent drafts:

bash

bash scripts/typefully.sh list-drafts draft 5

Notes

• publish_at: "now" publishes immediately — use with caution
• publish_at: "next-free-slot" uses the user's Typefully queue schedule
• Thread posts are separated by \n---\n in the text argument
• The script outputs JSON; pipe through jq for formatting
• All API errors surface meaningful messages (401, 404, 429, etc.)