SkillHub

typefully-drafts

v1.0.0

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.

Sourced from ClawHub, Authored by chapati

Installation

Please help me install the skill `typefully-drafts` from SkillHub official store. npx skills add chapati23/typefully-drafts

Typefully Skill

Manage Typefully drafts via the v2 API.

Setup

  1. Set your API key via one of:
  2. Environment variable: export TYPEFULLY_API_KEY=your-key
  3. Password store: pass insert typefully/api-key
  4. (Optional) Set your social set ID:
  5. Environment variable: export TYPEFULLY_SOCIAL_SET_ID=123456
  6. Password store: pass insert typefully/social-set-id
  7. If not set, the script auto-detects (errors if multiple accounts exist — use list-social-sets to find yours)
  8. Enable "Development mode" in Typefully Settings → API to see draft IDs in the UI.

Script Usage

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 scripts/typefully.sh create-draft "Just shipped a new feature 🚀"

Create a thread:

bash scripts/typefully.sh create-draft "First tweet of the threadn---nSecond tweetn---nThird tweet" --thread

Create a thread from stdin (for longer content):

cat <<'EOF' | bash scripts/typefully.sh create-draft - --thread
First tweet of the threadn---nSecond tweetn---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 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.)