Typefully 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 <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 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