diff --git a/skills/typefully/CHANGELOG.md b/skills/typefully/CHANGELOG.md index 2fe0688..c78e6cf 100644 --- a/skills/typefully/CHANGELOG.md +++ b/skills/typefully/CHANGELOG.md @@ -6,6 +6,11 @@ The format is based on Keep a Changelog. ## 2026-07-09 +### Changed + +- Skill frontmatter and top-level instructions now explicitly trigger on Typefully draft URLs such as `https://typefully.com/?a=&d=`. +- Draft URL guidance now maps `a` to `social_set_id`, `d` to `draft_id`, and shows the `drafts:get` command with the default-social-set fallback. + ### Fixed - `drafts:update` no longer crashes with `Cannot read properties of null (reading 'enabled')` when the draft response contains null platform entries (e.g. `x_article` on regular drafts). This affected every update that didn't pass `--platform`, plus all `--append` updates. diff --git a/skills/typefully/SKILL.md b/skills/typefully/SKILL.md index af5ca72..77c5357 100644 --- a/skills/typefully/SKILL.md +++ b/skills/typefully/SKILL.md @@ -3,7 +3,9 @@ name: typefully description: > Create, schedule, and manage social media posts via Typefully. ALWAYS use this skill when asked to draft, schedule, post, or check tweets, posts, threads, or - social media content for Twitter/X, LinkedIn, Threads, Bluesky, or Mastodon. + social media content for Twitter/X, LinkedIn, Threads, Bluesky, or Mastodon, + or when the user drops a Typefully draft URL such as + https://typefully.com/?a=&d=. last-updated: 2026-07-09 allowed-tools: Bash(./scripts/typefully.js:*) --- @@ -18,6 +20,24 @@ Create, schedule, and publish social media content across X, LinkedIn, Threads, > > **Authentication failures**: If the CLI returns **"API key not found"**, **"Authentication failed"**, **"HTTP 401"**, or any invalid/expired-key message, tell the user to run `./scripts/typefully.js setup` or update `TYPEFULLY_API_KEY`, then stop. Do not hunt for credentials or fall back to the Typefully web UI, browser scraping, or a localhost dev server. See [`references/setup.md`](references/setup.md). +## Dropped Typefully draft URLs + +When the user gives you a Typefully draft URL, use this skill instead of browsing or scraping the Typefully web UI. + +- `https://typefully.com/?a=&d=` maps to: + + ```bash + ./scripts/typefully.js drafts:get + ``` + +- `https://typefully.com/?d=` can use the configured default social set: + + ```bash + ./scripts/typefully.js drafts:get --use-default + ``` + +For draft comments, replies, resolving, or edits on a dropped draft URL, first fetch the draft with the mapping above, then load [`references/comments.md`](references/comments.md) when comment workflow details are needed. + ## Reference guides Load these only when the task needs them: @@ -264,7 +284,7 @@ X 280 · LinkedIn 3000 · Threads 500 · Bluesky 300 · Mastodon 500. ### Draft URLs -Typefully draft URLs encode the social set and draft IDs: `https://typefully.com/?a=&d=` (e.g. `a=12345` → social_set_id, `d=67890` → draft_id). +Typefully draft URLs encode the social set and draft IDs: `https://typefully.com/?a=&d=` (e.g. `a=12345` → social_set_id, `d=67890` → draft_id). See [Dropped Typefully draft URLs](#dropped-typefully-draft-urls) for the command mapping. ### Automation guidelines