How do I install the Typefully skill?

Run npx skillmds@latest add gisk0/typefully in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Typefully safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Typefully?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Typefully free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Typefully?

gisk0 (@gisk0) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Typefully by gisk0 — Agent Skill

Name: Typefully
Author: gisk0

Typefully

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.

gisk0 9934926 5 files · 5.8 KB Updated Sep 17, 2026

File contents

Typefully Skill

Manage Typefully drafts via the v2 API.

Setup

Set your API key via one of:
- Environment variable: export TYPEFULLY_API_KEY=your-key
- Password store: pass insert typefully/api-key
(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)
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

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

---name: typefullydescription: 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.---# Typefully SkillManage Typefully drafts via the v2 API.## Setup1. 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```bashbash 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:**```bashbash scripts/typefully.sh create-draft "Just shipped a new feature 🚀"```**Create a thread:**```bashbash 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):**```bashcat <<'EOF' | bash scripts/typefully.sh create-draft - --threadFirst tweet of the thread\n---\nSecond tweet\n---\nThird tweet with the punchlineEOF```**Create cross-platform draft (X + LinkedIn):**```bashbash scripts/typefully.sh create-draft "Exciting update!" --platform x,linkedin```**Schedule a draft for a specific time:**```bashbash scripts/typefully.sh create-draft "Morning thoughts ☀️" --schedule "2026-03-01T09:00:00Z"```**Schedule to next free slot:**```bashbash scripts/typefully.sh schedule-draft 8196074 next-free-slot```**List recent drafts:**```bashbash 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.)

Frequently asked questions