Skill: chapati23/typefully-skill (version 1.0.0)

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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)