superx-cli 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.8.0 (2026-10-07)
+
+- `posts:remix` gains `--author-handle <@handle>`, the handle that originally posted the text. Pass the account's own handle when remixing one of its own posts: the remix then keeps that post's subject and products instead of re-grounding them in the profile. The API (`author_handle` on `POST /v1/posts/remix`) and MCP `remix_post` take the same field
+- Deleting a scheduled post (`scheduled:delete`, `scheduled:bulk-delete`, MCP `delete_scheduled_post` / `bulk_delete_scheduled_posts`) or moving one to draft (`scheduled:update --status draft`) now re-points scheduled posts that quote it to the post it quoted when that is one of your own posts (still scheduled earlier, or already published); otherwise they lose the quote
+- Image-only posts: `scheduled:create` and `posts:publish` take `--media <key>` without `--text`, `scheduled:update` takes `--text "" --media <key>` (it replaces the whole post, so the empty text is explicit), and `--parts-json` parts may leave out `text` when they carry `media`. The API and the MCP `schedule_post`, `update_scheduled_post` and `publish_post` tools accept a part with media and no text the same way. Nothing accepted before changes; a post with no text and no media at all is still refused
+- `inspiration:search` gains `--min-outlier-score <n>` (0-1000) and `--min-length <n>`. `outlier_score` is a post's engagement relative to what is expected for its author's follower count: 1.0 = expected, 3 = three times expected. `--min-outlier-score 3` keeps only posts at or above 3, and posts whose author's follower count is unknown are left out. `--min-length` keeps posts with at least that many characters
+- MCP `find_inspiration` gained the same filters as the CLI and API: `min_followers` / `max_followers`, `min_outlier_score`, `sort` (including `outlier`), `min_reposts`, `min_replies`, `min_bookmarks`, `min_impressions`, `min_length`, `exclude_topics` and `page`. Each post now returns `outlier_score` and `bookmarks`, and the result carries `page` and `has_more`. Reconnect the server to see the new schema
+
 ## 0.7.1 (2026-09-18)
 
 - New skill Worth a Reply (worth-a-reply): `posts:triage` reads a topic, then the skill hands back the posts worth replying to, ordered by how much room there is to add something in a reply, each with its link, one line on why and the angle a reply could take. Skim posts come back as one-liners and the Pass pile stays out unless the person asks. It drafts nothing until they pick a post. Skills are now 32.

package/README.md

@@ -126,9 +126,10 @@ Every stored reply your audience has sent you across all your posts: the reply t
 superx inspiration:search "build in public" --limit 10
 superx inspiration:search "indie hackers" --sort outlier --min-likes 500
 superx inspiration:search "AI tools" --min-followers 1000 --max-followers 50000
+superx inspiration:search "SaaS pricing" --min-outlier-score 3 --min-length 100
 ```
 
-Searches a library of 50M+ real high-performing posts by topic. Options: `--sort relevant|recent|likes|reposts|impressions|outlier`, `--min-likes/--min-reposts/--min-replies/--min-bookmarks/--min-impressions`, `--min-followers/--max-followers` (author size), `--since/--until` (UTC ISO-8601), `--lang` (default en), `--exclude-topics "crypto,politics"`, `--limit` (max 50), `--page` (1-7). Each result carries an `outlier_score`: how far the post outperformed the norm for its author's follower tier. Results are relevance-ranked, strongest matches first, with weak and promotional matches filtered out, so a page may return fewer than `--limit` posts. Use them for structures and hooks to remix, never to copy.
+Searches a library of 50M+ real high-performing posts by topic. Options: `--sort relevant|recent|likes|reposts|impressions|outlier`, `--min-likes/--min-reposts/--min-replies/--min-bookmarks/--min-impressions`, `--min-length` (characters), `--min-followers/--max-followers` (author size), `--min-outlier-score` (0-1000), `--since/--until` (UTC ISO-8601), `--lang` (default en), `--exclude-topics "crypto,politics"`, `--limit` (max 50), `--page` (1-7). Each result carries an `outlier_score`: how far the post outperformed the norm for its author's follower tier (1.0 = expected, 3 = three times expected). `--min-outlier-score` keeps only posts at or above that score. Results are relevance-ranked, strongest matches first, with weak and promotional matches filtered out, so a page may return fewer than `--limit` posts. Use them for structures and hooks to remix, never to copy.
 
 ### Contacts (who engages with you)
 
@@ -206,7 +207,7 @@ superx scheduled:create --text "Post" --at "2026-08-01T15:00:00Z" --idempotency-
 
 superx scheduled:list --status draft,scheduled       # draft | scheduled | sent | error
 superx scheduled:list --from "2026-08-01T00:00:00Z" --to "2026-08-08T00:00:00Z"
-superx scheduled:delete <post-id>
+superx scheduled:delete <post-id>                    # posts quoting it re-point to its quoted post if yours (scheduled earlier or published), else lose the quote
 ```
 
 Images attach in two steps: upload, then reference the `object_key`.
@@ -217,7 +218,7 @@ superx scheduled:create --text "Chart of the week" --media "$KEY" --alt-text "We
 superx scheduled:create --parts-json '[{"text":"1/ Hook","media":[{"object_key":"'"$KEY"'"}]},{"text":"2/ Detail"}]'
 ```
 
-`media:upload` accepts JPG, PNG, and WEBP up to 5MB and GIF up to 15MB; a post part carries up to 4 images or exactly 1 GIF. `--media` takes a comma list of keys; `--alt-text` (max 1,000 chars) works with a single key, and `--parts-json` covers threads and per-image alt text. Uploads are capped at 100 per day and expire after 24 hours if never attached. Video is not supported yet.
+`media:upload` accepts JPG, PNG, and WEBP up to 5MB and GIF up to 15MB; a post part carries up to 4 images or exactly 1 GIF. `--media` takes a comma list of keys; `--alt-text` (max 1,000 chars) works with a single key, and `--parts-json` covers threads and per-image alt text. A post can be image-only: `--media` without `--text` on `scheduled:create` and `posts:publish`, `--text "" --media <key>` on `scheduled:update`, or a `--parts-json` part with `media` and no `text`. Uploads are capped at 100 per day and expire after 24 hours if never attached. Video is not supported yet.
 
 Drafts can carry organizer fields: `--title` (max 300 chars) and `--scratchpad` (max 30,000 chars) are shown in the SuperX app and never posted; `--tag <id>` (repeatable, max 20) attaches tags from `tags:list`.
 

package/dist/index.js

@@ -800,6 +800,7 @@ async function postsRemix(argv) {
     closeness: argv.closeness
   };
   if (argv.instructions) body.instructions = argv.instructions;
+  if (argv.authorHandle) body.author_handle = argv.authorHandle;
   if (argv.account) body.account_id = argv.account;
   const api = new SuperXAPI(getConfig());
   printJson(await api.remixPost(body));
@@ -874,6 +875,8 @@ async function inspirationSearch(argv) {
       min_impressions: argv.minImpressions,
       min_followers: argv.minFollowers,
       max_followers: argv.maxFollowers,
+      min_outlier_score: argv.minOutlierScore,
+      min_length: argv.minLength,
       since: argv.since,
       until: argv.until,
       lang: argv.lang,
@@ -1559,8 +1562,10 @@ function parsePartsJson(raw) {
     process.exit(1);
     throw new Error("unreachable");
   }
-  if (!Array.isArray(parsed) || parsed.some((p) => !p || typeof p !== "object" || typeof p.text !== "string")) {
-    note("--parts-json must be an array of { text, media? } objects.");
+  if (!Array.isArray(parsed) || parsed.some(
+    (p) => !p || typeof p !== "object" || typeof p.text !== "string" && !(p.text === void 0 && Array.isArray(p.media) && p.media.length > 0)
+  )) {
+    note("--parts-json must be an array of { text, media? } objects (text may be left out on a part with media).");
     process.exit(1);
   }
   return parsed;
@@ -1682,21 +1687,21 @@ async function scheduledCreate(argv) {
     note("Use exactly one of --text (single post), --part (thread), or --parts-json.");
     process.exit(1);
   }
-  if (sourceCount === 0) {
+  if (sourceCount === 0 && argv.media === void 0) {
     note("Provide --text for a single post, --part flags for a thread, or --parts-json.");
     process.exit(1);
   }
-  if (argv.media !== void 0 && !argv.text) {
+  if (argv.media !== void 0 && (parts.length > 0 || argv["parts-json"] !== void 0)) {
     note("--media applies to the --text single-post form. For threads, put media in --parts-json.");
     process.exit(1);
   }
   const body = {};
   if (argv["parts-json"] !== void 0) {
     body.parts = parsePartsJson(argv["parts-json"]);
-  } else if (argv.text) {
+  } else if (argv.text || argv.media !== void 0) {
     const media = mediaFromFlags(argv.media, argv["alt-text"]);
     if (media) {
-      body.parts = [{ text: argv.text, media }];
+      body.parts = [{ text: argv.text || "", media }];
     } else {
       body.text = argv.text;
     }
@@ -1728,8 +1733,12 @@ async function scheduledUpdate(argv) {
     note("Use exactly one of --text (single post), --part (thread), or --parts-json.");
     process.exit(1);
   }
-  if (argv.media !== void 0 && !argv.text) {
-    note("--media applies to the --text single-post form. For threads, put media in --parts-json.");
+  if (argv.media !== void 0 && argv.text === void 0) {
+    if (parts.length > 0 || argv["parts-json"] !== void 0) {
+      note("--media applies to the --text single-post form. For threads, put media in --parts-json.");
+    } else {
+      note('--media replaces the whole post, text included. Pass --text with it, or --text "" for a media-only post.');
+    }
     process.exit(1);
   }
   if (argv.title !== void 0 && argv["clear-title"]) {
@@ -1748,10 +1757,10 @@ async function scheduledUpdate(argv) {
   const body = {};
   if (argv["parts-json"] !== void 0) {
     body.parts = parsePartsJson(argv["parts-json"]);
-  } else if (argv.text) {
+  } else if (argv.text || argv.media !== void 0) {
     const media = mediaFromFlags(argv.media, argv["alt-text"]);
     if (media) {
-      body.parts = [{ text: argv.text, media }];
+      body.parts = [{ text: argv.text || "", media }];
     } else {
       body.text = argv.text;
     }
@@ -1794,21 +1803,21 @@ async function postsPublish(argv) {
     note("Use exactly one of --text (single post), --part (thread), or --parts-json.");
     process.exit(1);
   }
-  if (sourceCount === 0) {
+  if (sourceCount === 0 && argv.media === void 0) {
     note("Provide --text for a single post, --part flags for a thread, or --parts-json.");
     process.exit(1);
   }
-  if (argv.media !== void 0 && !argv.text) {
+  if (argv.media !== void 0 && (parts.length > 0 || argv["parts-json"] !== void 0)) {
     note("--media applies to the --text single-post form. For threads, put media in --parts-json.");
     process.exit(1);
   }
   const body = { scheduled_for: "now" };
   if (argv["parts-json"] !== void 0) {
     body.parts = parsePartsJson(argv["parts-json"]);
-  } else if (argv.text) {
+  } else if (argv.text || argv.media !== void 0) {
     const media = mediaFromFlags(argv.media, argv["alt-text"]);
     if (media) {
-      body.parts = [{ text: argv.text, media }];
+      body.parts = [{ text: argv.text || "", media }];
     } else {
       body.text = argv.text;
     }
@@ -2677,7 +2686,10 @@ var advancedSettingsOptions = (y) => y.option("auto-retweet", {
   }).option("instructions", {
     describe: "Extra direction for this remix (max 500 chars)",
     type: "string"
-  }).example('$0 posts:remix --text "$(cat post.txt)" --closeness 70', "A close rewrite in your voice").example('$0 posts:remix --text "..." --closeness 20 --instructions "make it a question"', "A loose reinterpretation").epilogue(
+  }).option("author-handle", {
+    describe: "The @handle that originally posted the text. Pass this account's own handle when remixing one of its own posts so the subject stays",
+    type: "string"
+  }).example('$0 posts:remix --text "$(cat post.txt)" --closeness 70', "A close rewrite in your voice").example('$0 posts:remix --text "..." --closeness 20 --instructions "make it a question"', "A loose reinterpretation").example('$0 posts:remix --text "$(cat old-post.txt)" --closeness 60 --author-handle @you', "Say one of your own posts again, same subject").epilogue(
     "Returns TEXT ONLY. Nothing is posted or scheduled: save the result with posts:draft or scheduled:create once you are happy with it."
   ),
   run(postsRemix)
@@ -2783,7 +2795,10 @@ var advancedSettingsOptions = (y) => y.option("auto-retweet", {
     describe: "Sort order",
     type: "string",
     choices: ["relevant", "recent", "likes", "reposts", "impressions", "outlier"]
-  }).option("min-likes", { describe: "Only posts with at least this many likes", type: "number" }).option("min-reposts", { describe: "Only posts with at least this many reposts", type: "number" }).option("min-replies", { describe: "Only posts with at least this many replies", type: "number" }).option("min-bookmarks", { describe: "Only posts with at least this many bookmarks", type: "number" }).option("min-impressions", { describe: "Only posts with at least this many impressions", type: "number" }).option("min-followers", { describe: "Only posts from authors with at least this many followers", type: "number" }).option("max-followers", { describe: "Only posts from authors with at most this many followers", type: "number" }).option("since", { describe: "Only posts after this time (UTC ISO-8601)", type: "string" }).option("until", { describe: "Only posts before this time (UTC ISO-8601)", type: "string" }).option("lang", { describe: "Language code (default en)", type: "string" }).option("exclude-topics", { describe: "Comma-separated topics to exclude", type: "string" }).example('$0 inspiration:search "build in public" --limit 10', "Ten posts about building in public").example('$0 inspiration:search "indie hackers" --sort outlier --min-likes 500', "Overperformers with 500+ likes"),
+  }).option("min-likes", { describe: "Only posts with at least this many likes", type: "number" }).option("min-reposts", { describe: "Only posts with at least this many reposts", type: "number" }).option("min-replies", { describe: "Only posts with at least this many replies", type: "number" }).option("min-bookmarks", { describe: "Only posts with at least this many bookmarks", type: "number" }).option("min-impressions", { describe: "Only posts with at least this many impressions", type: "number" }).option("min-followers", { describe: "Only posts from authors with at least this many followers", type: "number" }).option("max-followers", { describe: "Only posts from authors with at most this many followers", type: "number" }).option("min-outlier-score", {
+    describe: "Only posts with at least this outlier score (1.0 = expected engagement for the author's size, max 1000)",
+    type: "number"
+  }).option("min-length", { describe: "Only posts with at least this many characters", type: "number" }).option("since", { describe: "Only posts after this time (UTC ISO-8601)", type: "string" }).option("until", { describe: "Only posts before this time (UTC ISO-8601)", type: "string" }).option("lang", { describe: "Language code (default en)", type: "string" }).option("exclude-topics", { describe: "Comma-separated topics to exclude", type: "string" }).example('$0 inspiration:search "build in public" --limit 10', "Ten posts about building in public").example('$0 inspiration:search "indie hackers" --sort outlier --min-likes 500', "Overperformers with 500+ likes"),
   run(inspirationSearch)
 ).command(
   "inspiration:media [query]",
@@ -3399,7 +3414,7 @@ var advancedSettingsOptions = (y) => y.option("auto-retweet", {
     type: "string",
     array: true
   }).option("media", {
-    describe: "Comma list of image object_keys (from media:upload) to attach; single-post form only (max 4 images or 1 GIF)",
+    describe: "Comma list of image object_keys (from media:upload) to attach; single-post form only (max 4 images or 1 GIF). Without --text it makes a media-only post",
     type: "string"
   }).option("alt-text", {
     describe: "Accessibility description for the attached image (single --media key only, max 1000 chars)",
@@ -3417,7 +3432,7 @@ var advancedSettingsOptions = (y) => y.option("auto-retweet", {
   }).option("idempotency-key", {
     describe: "Idempotency-Key header (max 64 chars); retries with the same key return the original result",
     type: "string"
-  }).example('$0 scheduled:create --text "Hello"', "Create a draft").example('$0 scheduled:create --text "Hello" --at "2026-08-01T15:00:00Z"', "Schedule a post").example('$0 scheduled:create --part "1/ Hook" --part "2/ Detail" --part "3/ CTA"', "Draft a 3-part thread").example('$0 scheduled:create --text "Hello" --title "Launch teaser" --tag abc123', "Draft with a title and a tag").example('$0 scheduled:create --text "Chart of the week" --media "<object_key>" --alt-text "Revenue chart"', "Draft with an image").example('$0 scheduled:create --text "Hello" --at "2026-08-01T15:00:00Z" --auto-retweet 6 --auto-retweet-remove 4', "Schedule with an auto retweet").example('$0 scheduled:create --text "Hello" --at "2026-08-01T15:00:00Z" --no-auto-retweet --no-auto-plug', "Schedule with your defaults off for this post"),
+  }).example('$0 scheduled:create --text "Hello"', "Create a draft").example('$0 scheduled:create --text "Hello" --at "2026-08-01T15:00:00Z"', "Schedule a post").example('$0 scheduled:create --part "1/ Hook" --part "2/ Detail" --part "3/ CTA"', "Draft a 3-part thread").example('$0 scheduled:create --text "Hello" --title "Launch teaser" --tag abc123', "Draft with a title and a tag").example('$0 scheduled:create --text "Chart of the week" --media "<object_key>" --alt-text "Revenue chart"', "Draft with an image").example('$0 scheduled:create --media "<object_key>"', "Draft an image-only post (no text)").example('$0 scheduled:create --text "Hello" --at "2026-08-01T15:00:00Z" --auto-retweet 6 --auto-retweet-remove 4', "Schedule with an auto retweet").example('$0 scheduled:create --text "Hello" --at "2026-08-01T15:00:00Z" --no-auto-retweet --no-auto-plug', "Schedule with your defaults off for this post"),
   run(scheduledCreate)
 ).command(
   "scheduled:update <id>",
@@ -3427,7 +3442,7 @@ var advancedSettingsOptions = (y) => y.option("auto-retweet", {
     type: "string",
     array: true
   }).option("media", {
-    describe: "Comma list of image object_keys to attach with --text (full replace: re-list existing keys to keep them; --text without --media removes the post's media)",
+    describe: `Comma list of image object_keys to attach with --text (full replace: re-list existing keys to keep them; --text without --media removes the post's media; --text "" with --media makes the post media-only)`,
     type: "string"
   }).option("alt-text", {
     describe: "Accessibility description for the attached image (single --media key only, max 1000 chars)",
@@ -3439,18 +3454,18 @@ var advancedSettingsOptions = (y) => y.option("auto-retweet", {
     describe: "New schedule time (UTC ISO-8601 with explicit Z or offset). On its own it never schedules a draft; add --status scheduled.",
     type: "string"
   }).option("status", {
-    describe: "Explicit transition; scheduled needs a future time (via --at or already set)",
+    describe: "Explicit transition; scheduled needs a future time (via --at or already set). Moving a scheduled post to draft re-points scheduled posts that quote it to the post it quoted when that is one of your own posts (still scheduled earlier, or already published); otherwise they lose the quote",
     type: "string",
     choices: ["draft", "scheduled"]
   }).option("title", { describe: "New draft title (max 300 chars)", type: "string" }).option("clear-title", { describe: "Remove the title", type: "boolean" }).option("scratchpad", { describe: "New private notes (max 30000 chars)", type: "string" }).option("clear-scratchpad", { describe: "Remove the notes", type: "boolean" }).option("tag", {
     describe: "Replacement tag id set (repeat the flag, max 20; replaces ALL current tags)",
     type: "string",
     array: true
-  }).option("clear-tags", { describe: "Remove all tags", type: "boolean" }).example('$0 scheduled:update abc123 --title "Better hook"', "Retitle a draft, everything else untouched").example('$0 scheduled:update abc123 --at "2026-08-01T15:00:00Z" --status scheduled', "Promote a draft to the queue").example("$0 scheduled:update abc123 --status draft", "Pull a post back to drafts (quota refunds)").example("$0 scheduled:update abc123 --auto-delete 8 --auto-delete-threshold 500", "Add an auto delete to the post").example("$0 scheduled:update abc123 --no-auto-retweet", "Remove the post's auto retweet"),
+  }).option("clear-tags", { describe: "Remove all tags", type: "boolean" }).example('$0 scheduled:update abc123 --title "Better hook"', "Retitle a draft, everything else untouched").example('$0 scheduled:update abc123 --at "2026-08-01T15:00:00Z" --status scheduled', "Promote a draft to the queue").example("$0 scheduled:update abc123 --status draft", "Pull a post back to drafts (quota refunds)").example("$0 scheduled:update abc123 --auto-delete 8 --auto-delete-threshold 500", "Add an auto delete to the post").example("$0 scheduled:update abc123 --no-auto-retweet", "Remove the post's auto retweet").example('$0 scheduled:update abc123 --text "" --media "<object_key>"', "Make the post image-only (removes its text)"),
   run(scheduledUpdate)
 ).command(
   "scheduled:delete <id>",
-  "Delete a draft or scheduled post by id",
+  "Delete a draft or scheduled post by id. Scheduled posts that quote it are re-pointed to the post it quoted when that is one of your own posts (still scheduled earlier, or already published); otherwise they lose the quote",
   (y) => y.positional("id", { describe: "Post id (from scheduled:list or scheduled:create)", type: "string" }),
   run(scheduledDelete)
 ).command(
@@ -3461,7 +3476,7 @@ var advancedSettingsOptions = (y) => y.option("auto-retweet", {
     type: "string",
     array: true
   }).option("media", {
-    describe: "Comma list of image object_keys (from media:upload) to attach; single-post form only (max 4 images or 1 GIF)",
+    describe: "Comma list of image object_keys (from media:upload) to attach; single-post form only (max 4 images or 1 GIF). Without --text it makes a media-only post",
     type: "string"
   }).option("alt-text", {
     describe: "Accessibility description for the attached image (single --media key only, max 1000 chars)",
@@ -3476,7 +3491,7 @@ var advancedSettingsOptions = (y) => y.option("auto-retweet", {
   }).option("idempotency-key", {
     describe: "REQUIRED (max 64 chars). Reuse the SAME key when retrying so a timed-out call cannot post twice; use a new key only for new content",
     type: "string"
-  }).example('$0 posts:publish --text "Shipping now." --idempotency-key launch-2026-09-07', "Publish a single post").example('$0 posts:publish --part "1/ Hook" --part "2/ Detail" --idempotency-key thread-42', "Publish a thread").example('$0 posts:publish --text "Shipping now." --auto-retweet 6 --idempotency-key launch-2026-09-07', "Publish with an auto retweet"),
+  }).example('$0 posts:publish --text "Shipping now." --idempotency-key launch-2026-09-07', "Publish a single post").example('$0 posts:publish --part "1/ Hook" --part "2/ Detail" --idempotency-key thread-42', "Publish a thread").example('$0 posts:publish --media "<object_key>" --idempotency-key gif-2026-10-03', "Publish an image-only post").example('$0 posts:publish --text "Shipping now." --auto-retweet 6 --idempotency-key launch-2026-09-07', "Publish with an auto retweet"),
   run(postsPublish)
 ).command(
   "scheduled:bulk-retime",
@@ -3493,7 +3508,7 @@ var advancedSettingsOptions = (y) => y.option("auto-retweet", {
   run(scheduledBulkAutoRetweet)
 ).command(
   "scheduled:bulk-delete",
-  "Delete up to 100 QUEUED posts and refund their post quota (sent posts and drafts are left alone)",
+  "Delete up to 100 QUEUED posts and refund their post quota (sent posts and drafts are left alone). Scheduled posts that quote them are re-pointed to the post each one quoted when that is one of your own posts (still scheduled earlier, or already published); otherwise they lose the quote",
   (y) => accountOption(y).option("ids", { describe: "Comma list of post ids (max 100, from scheduled:list)", type: "string" }).example("$0 scheduled:bulk-delete --ids abc,def", "Delete two queued posts"),
   run(scheduledBulkDelete)
 ).command(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superx-cli",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "SuperX CLI - command line interface to the SuperX API for Twitter/X growth: read posts and analytics, find engaged contacts, and schedule posts and threads",
   "main": "dist/index.js",
   "bin": {

package/skills/superx/SKILL.md

@@ -32,7 +32,7 @@ official website: https://superx.so
 
 **Rule 2: Read `references/growth-strategy.md` before creating any content.** This skill ships a growth strategy guide (`references/growth-strategy.md`, also inside the installed npm package). It tells you WHAT to post, WHEN, and WHY: the action hierarchy, out-of-network discovery, the engagement loop, and the failure modes that kill reach. The CLI gives you data and actions; the strategy guide gives you judgment. Do not schedule content without it. For a goal-shaped task ("give me my weekly recap", "DM the people who replied to this post"), open the matching skill under `references/skills/`: the named SuperX skills, each with its exact command chain, MCP tool names and stopping point.
 
-**Rule 3: Know the write constraints.** `scheduled:create` without `--at` creates a DRAFT (nothing publishes). With `--at` it schedules for that time. `scheduled:update` changes only the flags you pass, and a new `--at` alone never schedules a draft; add `--status scheduled` to promote. Writes work on your main account or any linked account (pass the same `--account` you used to read it); accounts shared with you by other people are read-only, and tags are workspace-wide. Images attach via `media:upload` then `--media` (JPG/PNG/WEBP up to 5MB, GIF up to 15MB; max 4 images or 1 GIF per post); video is not supported. Timestamps MUST be UTC ISO-8601 with an explicit `Z` or offset; naive timestamps are rejected with 400. `posts:publish` and `articles:publish` post to X IMMEDIATELY and irreversibly; treat them like hitting Publish in public and get human confirmation of the exact text unless the user already gave it. `posts:publish` also requires `--idempotency-key`, which you reuse verbatim on any retry. `posts:draft` writes post text in the user's voice and saves NOTHING: show the drafts, let the user pick and edit one, then pass the final text to `scheduled:create` yourself; it costs AI credits per draft, so ask for the count the user actually wants. `--voice mine` is the voice of the `--account` you pass (its own posts and style guide); shared accounts are refused.
+**Rule 3: Know the write constraints.** `scheduled:create` without `--at` creates a DRAFT (nothing publishes). With `--at` it schedules for that time. `scheduled:update` changes only the flags you pass, and a new `--at` alone never schedules a draft; add `--status scheduled` to promote. Writes work on your main account or any linked account (pass the same `--account` you used to read it); accounts shared with you by other people are read-only, and tags are workspace-wide. Images attach via `media:upload` then `--media` (JPG/PNG/WEBP up to 5MB, GIF up to 15MB; max 4 images or 1 GIF per post), and a post can be image-only (`--media` with no `--text`; on `scheduled:update` use `--text "" --media KEY`, since an update replaces the whole post); video is not supported. Timestamps MUST be UTC ISO-8601 with an explicit `Z` or offset; naive timestamps are rejected with 400. `posts:publish` and `articles:publish` post to X IMMEDIATELY and irreversibly; treat them like hitting Publish in public and get human confirmation of the exact text unless the user already gave it. `posts:publish` also requires `--idempotency-key`, which you reuse verbatim on any retry. `posts:draft` writes post text in the user's voice and saves NOTHING: show the drafts, let the user pick and edit one, then pass the final text to `scheduled:create` yourself; it costs AI credits per draft, so ask for the count the user actually wants. `--voice mine` is the voice of the `--account` you pass (its own posts and style guide); shared accounts are refused.
 
 ---
 

package/skills/superx/references/commands.md

@@ -81,11 +81,12 @@ superx replies:received --limit 20                 # Replies the audience has se
 superx inspiration:search "build in public" --limit 10          # Topic search
 superx inspiration:search "indie hackers" --sort outlier        # Biggest overperformers
 superx inspiration:search "AI tools" --min-likes 500 --min-followers 1000 --max-followers 50000
+superx inspiration:search "SaaS pricing" --min-outlier-score 3 --min-length 100   # 3x+ expected engagement, 100+ chars
 ```
 
 - Searches a library of 50M+ real high-performing posts. Use results for structures, hooks, and angles to remix. Never copy them.
-- Flags: `--sort relevant|recent|likes|reposts|impressions|outlier`, `--min-likes/--min-reposts/--min-replies/--min-bookmarks/--min-impressions`, `--min-followers/--max-followers` (author size), `--since/--until`, `--lang` (default en), `--exclude-topics "crypto,politics"`, `--limit` (max 50), `--page` (1-7).
-- `outlier_score` on each result = how far the post outperformed the norm for its author's follower tier. Sorting by `outlier` surfaces content that won on substance, not audience size.
+- Flags: `--sort relevant|recent|likes|reposts|impressions|outlier`, `--min-likes/--min-reposts/--min-replies/--min-bookmarks/--min-impressions`, `--min-length` (characters), `--min-followers/--max-followers` (author size), `--min-outlier-score` (0-1000), `--since/--until`, `--lang` (default en), `--exclude-topics "crypto,politics"`, `--limit` (max 50), `--page` (1-7).
+- `outlier_score` on each result = how far the post outperformed the norm for its author's follower tier (1.0 = expected, 3 = three times expected). Sorting by `outlier` surfaces content that won on substance, not audience size; `--min-outlier-score` drops everything below a floor.
 - Results are relevance-ranked, strongest matches first. Weak and promotional matches are filtered out, so a page may return fewer than `--limit` posts.
 
 ### Live X lookups
@@ -358,6 +359,7 @@ superx engage:reply-draft --text "hot take about pricing" --handle levelsio --au
 # Rewrite a post, near or far from the original
 superx posts:remix --text "$(cat post.txt)" --closeness 70
 superx posts:remix --text "..." --closeness 20 --instructions "make it a question"
+superx posts:remix --text "$(cat old-post.txt)" --closeness 60 --author-handle @you
 
 # Change one selected piece, keeping the surrounding style
 superx tools:inline-edit --text "the hook line" --full "$(cat post.txt)" --type hook
@@ -380,7 +382,7 @@ superx posts:triage "indie SaaS" --days 7
 
 - **Every one of these returns TEXT and posts NOTHING.** `engage:reply-draft` writes a reply for a person to review and post; there is still no reply-sending command anywhere in the CLI. Show the draft, let the user edit it, and never say a reply went out.
 - `engage:reply-draft` takes exactly one of `--post <id>` (the API reads the post live, so the draft sees the real text, author and any quoted post) or `--text` with optional `--author` and `--handle`. Add `--thoughts` with what the USER wants to say - ask them, never invent an opinion for them - and `--tone engaging|humorous|creative|sarcastic|inspirational|concise`. `--post` also spends one live X lookup on top of the credit.
-- `posts:remix` needs `--closeness` 0-100: 0 keeps only the idea, 100 stays very close to the original wording. Use it on a proven post the user wants to say again in their own words, then save the result with `posts:draft` or `scheduled:create`.
+- `posts:remix` needs `--closeness` 0-100: 0 keeps only the idea, 100 stays very close to the original wording. Use it on a proven post the user wants to say again in their own words, then save the result with `posts:draft` or `scheduled:create`. When the post is one of the account's OWN (from `posts:list`, analytics or an old post the user pastes), add `--author-handle` with that account's handle so the remix keeps its subject instead of re-grounding it in the profile.
 - `tools:inline-edit` needs `--instruction`, `--type`, or both, and works best with `--full` so the edit blends into the post around it. `--type` presets: grammar, translate, hook, details, concise, engaging, humorous, creative, sarcastic, inspirational.
 - `tools:rephrase` presets: improve, grammar, translate, hook, details, clarity, engaging, humorous, positive, creative, sarcastic, inspirational, concise. The style ones write in the user's voice; grammar, translate, clarity, details and concise stay mechanical.
 - `tools:factcheck` reports `result` (true, false or unknown), a one-sentence `comment` and the `sources` it read. It is a model's reading of a couple of search results, NOT a guarantee: show the sources and never present the verdict as settled.
@@ -452,6 +454,7 @@ superx scheduled:delete <post-id>
 - Replays add `"replayed": true` to the JSON output and print a stderr note.
 - `scheduled:list` filters: `--status draft,scheduled,sent,error` (comma list), `--tags id,id` (any-of), `--from/--to` bounds on the scheduled time.
 - `media:upload` accepts JPG/PNG/WEBP (5MB) and GIF (15MB); a post part carries up to 4 images OR exactly 1 GIF. Uploads are capped at 100/day and expire after 24h if never attached.
+- Image-only posts work: `--media <key>` with no `--text` (on `scheduled:update` pass `--text "" --media <key>`, since it replaces the whole post), or a `--parts-json` part with `media` and no `text`.
 
 ### Publishing now (irreversible)
 

package/skills/superx/references/skills/viral-format-remix/recipe.md

@@ -10,6 +10,6 @@ superx scheduled:create --text "<approved text>" --idempotency-key "remix-<slug>
 
 `--mirror` copies the SHAPE of a proven post, not its words. Pick a reference with room for the account's own facts.
 
-MCP: `find_inspiration` -> `draft_post` -> `schedule_post`
+MCP: `find_inspiration` (`sort: "outlier"`, optionally `min_outlier_score: 3` for posts with 3x the expected engagement for the author's size) -> `draft_post` -> `schedule_post`
 
 Stops at: reference posts plus drafts, for the person to pick from. 3 AI credits per draft written.