@sellable/install 0.1.195 → 0.1.196

package/README.md

@@ -70,15 +70,18 @@ source-scout agents.
 Use the same public entrypoints in both hosts:
 
 - Claude Code: `/sellable:create-campaign`
+- Claude Code: `/sellable:create-ab-test`
 - Claude Code: `/sellable:foundation`
 - Claude Code: `/sellable:content`
 - Claude Code: `/sellable:create-post`
 - Codex: `$sellable:create-campaign`
+- Codex: `$sellable:create-ab-test`
 - Codex: `$sellable:foundation`
 - Codex: `$sellable:content`
 - Codex: `$sellable:create-post`
 - Codex Desktop plugin: `sellable@sellable`
 - Codex visible skill: `Sellable Create Campaign`
+- Codex visible skill: `Sellable Create A/B Test`
 - Codex visible skill: `Sellable Foundation`
 - Codex visible skill: `Sellable Content`
 - Codex visible skill: `Sellable Create Post`

package/bin/sellable-install.mjs

@@ -180,6 +180,7 @@ function printCreateCommandHint() {
   console.log("");
   printAgentBox("Using Claude Code?", "claude", [
     { label: "Campaign", command: "/sellable:create-campaign" },
+    { label: "A/B Test", command: "/sellable:create-ab-test" },
     { label: "Foundation", command: "/sellable:foundation" },
     { label: "Content", command: "/sellable:content" },
     { label: "Post", command: "/sellable:create-post" },
@@ -188,6 +189,7 @@ function printCreateCommandHint() {
   console.log("");
   printAgentBox("Using Codex?", "codex", [
     { label: "Campaign", command: "$sellable:create-campaign" },
+    { label: "A/B Test", command: "$sellable:create-ab-test" },
     { label: "Foundation", command: "$sellable:foundation" },
     { label: "Content", command: "$sellable:content" },
     { label: "Post", command: "$sellable:create-post" },
@@ -1196,6 +1198,40 @@ then retry \`get_subskill_prompt\`.
 `;
 }
 
+function createAbTestSkillMd() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const templatePath = join(
+      here,
+      "..",
+      "skill-templates",
+      "create-ab-test.md"
+    );
+    if (existsSync(templatePath)) {
+      return readFileSync(templatePath, "utf8");
+    }
+  } catch {
+    // fall through to hardcoded fallback below
+  }
+  return `---
+name: create-ab-test
+description: Create a Sellable campaign A/B test from a clean source lead list.
+visibility: public
+allowed-tools:
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__get_active_workspace
+  - mcp__sellable__get_campaign
+  - mcp__sellable__prepare_campaign_ab_test
+  - mcp__sellable__load_csv_linkedin_leads
+  - mcp__sellable__wait_for_lead_list_ready
+---
+
+# Sellable Create A/B Test
+
+Use \`prepare_campaign_ab_test\` to create clean A/B split lead lists and review-copy campaigns. Do not call \`export_table_csv\` from generated campaign workflow tables as lead source data, and do not call \`start_campaign\`.
+`;
+}
+
 function genericSellableSkillMd({ name, title, description }) {
   return `---
 name: ${name}
@@ -1371,7 +1407,7 @@ then retry \`get_subskill_prompt\`.
 function createPostSkillMd() {
   return `---
 name: create-post
-description: Capture rough LinkedIn post ideas, develop a valuable premise, research current hooks and market beliefs, then save validated drafts in the user's voice.
+description: Capture rough LinkedIn post ideas, develop a valuable premise, research current hooks and audience tension, then save validated drafts in the user's voice.
 allowed-tools:
   - mcp__sellable__get_auth_status
   - mcp__sellable__get_subskill_prompt
@@ -1382,9 +1418,15 @@ allowed-tools:
   - mcp__sellable__get_post_idea
   - mcp__sellable__list_post_ideas
   - mcp__sellable__save_hook_research
+  - mcp__sellable__calculate_linkedin_hook_preview
+  - mcp__sellable__render_linkedin_post_preview
   - mcp__sellable__save_post_draft
+  - mcp__sellable__update_post_draft
+  - mcp__sellable__list_post_draft_iterations
   - mcp__sellable__get_post_draft
   - mcp__sellable__mark_post_published
+  - mcp__sellable__get_published_post
+  - mcp__sellable__update_published_post_metrics
   - mcp__sellable__list_published_posts
   - mcp__sellable__search_engagement_posts
   - mcp__sellable__fetch_linkedin_posts
@@ -1397,7 +1439,7 @@ allowed-tools:
 
 Use this as the customer-facing entrypoint for the Sellable \`create-post\`
 workflow. It captures raw LinkedIn post ideas, preserves the user's source
-wording, researches currently working hooks, extracts market beliefs, develops
+wording, researches currently working hooks, extracts audience tension, develops
 a premise with story/tension/reader value, validates proof/voice/AI tells, and
 saves drafts under \`~/.sellable/content/linkedin/**\`.
 
@@ -1633,6 +1675,12 @@ function codexPluginSkills() {
       skillMd: createCampaignSkillMd(),
       soulMd: createCampaignSoulMd(),
     },
+    {
+      dir: "sellable-create-ab-test",
+      displayName: "Sellable Create A/B Test",
+      description: "Create clean A/B campaign review copies",
+      skillMd: createAbTestSkillMd(),
+    },
     {
       dir: "sellable-content",
       displayName: "Sellable Content",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/install",
-  "version": "0.1.195",
+  "version": "0.1.196",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code and Codex",
   "bin": {

package/skill-templates/create-ab-test.md

@@ -0,0 +1,77 @@
+---
+name: create-ab-test
+description: Create a Sellable campaign A/B test from a clean source lead list.
+visibility: public
+allowed-tools:
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__get_active_workspace
+  - mcp__sellable__get_campaign
+  - mcp__sellable__get_campaign_context
+  - mcp__sellable__get_campaign_navigation_state
+  - mcp__sellable__get_campaign_messages_preview
+  - mcp__sellable__prepare_campaign_ab_test
+  - mcp__sellable__load_csv_linkedin_leads
+  - mcp__sellable__wait_for_lead_list_ready
+  - mcp__sellable__get_table_rows
+  - mcp__sellable__get_rows_minimal
+---
+
+# Sellable Create A/B Test
+
+Use this workflow when the user asks to create an A/B campaign test, split a
+campaign into variants, duplicate a campaign for copy testing, or compare two
+campaign-message approaches from the same source list.
+
+## Opening Contract
+
+Start by identifying the source campaign, the one variable being tested, and
+the clean source lead origin. Then prepare the split and stop for review. The
+goal is two review-copy campaigns with clean split source lists, not a launched
+campaign.
+
+## Required Flow
+
+1. Confirm the source campaign ID or resolve it with `get_campaign`.
+2. Confirm the A/B variable in plain language. Keep variant B as the explicit
+   change and leave variant A as the control unless the user names an A change.
+3. Verify the campaign has a clean source lead list. A clean source list is a
+   lead-list table, not the generated campaign workflow table.
+4. Call `prepare_campaign_ab_test` with `dryRun: true` first.
+5. Review split counts, duplicate/skipped counts, campaign names, and variant
+   brief deltas with the user.
+6. Only after review, call `prepare_campaign_ab_test` without `dryRun` using the
+   same `idempotencyKey` if one was returned or supplied.
+7. Return the A and B campaign IDs, split lead-list IDs, counts, and the
+   explicit note that both campaigns are `not_started`.
+
+## Anti-Patterns
+
+- Do not call `export_table_csv` from an enriched/generated campaign workflow
+  table as the lead source for A/B splitting.
+- Do not reimport workflow output columns such as `ICP Score`, `Passes Rubric`,
+  `Generate Message`, `Message`, `Approved`, scheduling, status, result, or
+  error columns.
+- Do not use broad workflow-table selectors to split decorated campaign rows.
+- Do not call `start_campaign`, approve launch, attach senders for launch, or
+  trigger live sends in this workflow.
+
+## Clean Source Fallback
+
+If the source campaign has no clean source lead list, or the source list is
+polluted with workflow/output columns, ask for the original CSV or clean source
+list. Use `load_csv_linkedin_leads`; it strips Sellable workflow columns if a
+contaminated CSV is supplied, then creates a clean lead list. After the clean
+source is confirmed, retry `prepare_campaign_ab_test`.
+
+## Output Contract
+
+Report:
+
+- source campaign ID
+- source lead-list ID
+- split strategy and counts
+- duplicate/skipped lead counts
+- A review campaign ID and split lead-list ID
+- B review campaign ID and split lead-list ID
+- variant difference
+- `launchState: not_started` for both campaigns

package/skill-templates/create-campaign.md

@@ -109,6 +109,22 @@ page before importing, call `list_dnc_entries`. Confirm the active workspace
 name and ID in the response before any write. This is Sellable's workspace DNC
 list used by DNC Check.
 
+## A/B Campaign Requests
+
+If the user explicitly asks to create an A/B test, split an existing campaign
+into variants, duplicate a campaign for copy testing, or compare two campaign
+message approaches from the same source list, route them to
+`create-ab-test` instead of improvising inside this create-campaign workflow.
+
+Workflow/campaign table exports are decorated outputs for operator review and
+debugging. They are not source lead lists for A/B splitting or campaign
+duplication. Do not use `export_table_csv` from an enriched/generated campaign
+table and then reimport it as leads. If the user only has a contaminated CSV,
+`load_csv_linkedin_leads` strips Sellable workflow columns such as `ICP Score`,
+`Passes Rubric`, `Generate Message`, `Message`, and `Approved`, but the
+preferred A/B path is the dedicated `create-ab-test` workflow using
+`prepare_campaign_ab_test`.
+
 ## Opening Turn Contract
 
 On the first visible response after this skill is invoked, do not narrate