@feastalytics/cli 0.1.14 → 0.1.16

package/README.md

@@ -88,6 +88,17 @@ npx skills add feastalytics/cli -g -a '*' -y
 
 To refresh from a local checkout instead of GitHub, run `npx skills add ./feast -g -a '*' -y` from the repo root.
 
+### Playbook skills from Feastalytics
+
+Feastalytics also publishes playbook skills that build on this one. They are served by the API to logged-in users and installed by the CLI itself, so no GitHub access is needed:
+
+```bash
+feast skill list                       # what is published, with versions
+feast skill install feast-playbooks    # writes ~/.claude/skills/feast-playbooks/
+```
+
+`--dir <path>` installs somewhere else (zip that directory to upload it to claude.ai under Settings > Capabilities > Skills). A re-install replaces the previous copy; `--force` is required to replace a directory the CLI did not create. Skills belong to the organization you act on, so pass `--org` when you belong to several.
+
 ## Environment
 
 - `FEAST_API_URL` — override the API base URL (e.g. a local dev server)

package/dist/cli.js

@@ -3221,8 +3221,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path3) {
-      let input = path3;
+    function removeDotSegments(path5) {
+      let input = path5;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3474,8 +3474,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path3, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path3 && path3 !== "/" ? path3 : void 0;
+        const [path5, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path5 && path5 !== "/" ? path5 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -6836,22 +6836,22 @@ var TRPC_ERROR_CODES_BY_NUMBER = invert(TRPC_ERROR_CODES_BY_KEY);
 var TRPC_ERROR_CODES_BY_NUMBER2 = invert(TRPC_ERROR_CODES_BY_KEY);
 var noop = () => {
 };
-function createInnerProxy(callback, path3) {
+function createInnerProxy(callback, path5) {
   const proxy = new Proxy(noop, {
     get(_obj, key) {
       if (typeof key !== "string" || key === "then") {
         return void 0;
       }
       return createInnerProxy(callback, [
-        ...path3,
+        ...path5,
         key
       ]);
     },
     apply(_1, _2, args) {
-      const isApply = path3[path3.length - 1] === "apply";
+      const isApply = path5[path5.length - 1] === "apply";
       return callback({
         args: isApply ? args.length >= 2 ? args[1] : [] : args,
-        path: isApply ? path3.slice(0, -1) : path3
+        path: isApply ? path5.slice(0, -1) : path5
       });
     }
   });
@@ -7263,13 +7263,13 @@ function createHTTPBatchLink(requester) {
           if (maxURLLength === Infinity) {
             return true;
           }
-          const path3 = batchOps.map((op) => op.path).join(",");
+          const path5 = batchOps.map((op) => op.path).join(",");
           const inputs = batchOps.map((op) => op.input);
           const url = getUrl({
             ...resolvedOpts,
             runtime,
             type,
-            path: path3,
+            path: path5,
             inputs
           });
           return url.length <= maxURLLength;
@@ -7327,11 +7327,11 @@ function createHTTPBatchLink(requester) {
 }
 var batchRequester = (requesterOpts) => {
   return (batchOps) => {
-    const path3 = batchOps.map((op) => op.path).join(",");
+    const path5 = batchOps.map((op) => op.path).join(",");
     const inputs = batchOps.map((op) => op.input);
     const { promise, cancel } = jsonHttpRequester({
       ...requesterOpts,
-      path: path3,
+      path: path5,
       inputs,
       headers() {
         if (!requesterOpts.opts.headers) {
@@ -7365,12 +7365,12 @@ function httpLinkFactory(factoryOpts) {
   return (opts) => {
     const resolvedOpts = resolveHTTPLinkOptions(opts);
     return (runtime) => ({ op }) => observable((observer) => {
-      const { path: path3, input, type } = op;
+      const { path: path5, input, type } = op;
       const { promise, cancel } = factoryOpts.requester({
         ...resolvedOpts,
         runtime,
         type,
-        path: path3,
+        path: path5,
         input,
         headers() {
           if (!opts.headers) {
@@ -7416,13 +7416,13 @@ var httpLink = httpLinkFactory({
 
 // node_modules/@trpc/client/dist/index.mjs
 var TRPCUntypedClient = class {
-  $request({ type, input, path: path3, context = {} }) {
+  $request({ type, input, path: path5, context = {} }) {
     const chain$ = createChain({
       links: this.links,
       op: {
         id: ++this.requestId,
         type,
-        path: path3,
+        path: path5,
         input,
         context
       }
@@ -7442,28 +7442,28 @@ var TRPCUntypedClient = class {
     });
     return abortablePromise;
   }
-  query(path3, input, opts) {
+  query(path5, input, opts) {
     return this.requestAsPromise({
       type: "query",
-      path: path3,
+      path: path5,
       input,
       context: opts?.context,
       signal: opts?.signal
     });
   }
-  mutation(path3, input, opts) {
+  mutation(path5, input, opts) {
     return this.requestAsPromise({
       type: "mutation",
-      path: path3,
+      path: path5,
       input,
       context: opts?.context,
       signal: opts?.signal
     });
   }
-  subscription(path3, input, opts) {
+  subscription(path5, input, opts) {
     const observable$ = this.$request({
       type: "subscription",
-      path: path3,
+      path: path5,
       input,
       context: opts?.context
     });
@@ -7535,10 +7535,10 @@ function createTRPCClientProxy(client) {
     if (key === "__untypedClient") {
       return client;
     }
-    return createRecursiveProxy(({ path: path3, args }) => {
+    return createRecursiveProxy(({ path: path5, args }) => {
       const pathCopy = [
         key,
-        ...path3
+        ...path5
       ];
       const procedureType = clientCallTypeToProcedureType(pathCopy.pop());
       const fullPath = pathCopy.join(".");
@@ -7647,12 +7647,12 @@ var streamingJsonHttpRequester = (opts, onSingle) => {
 var streamRequester = (requesterOpts) => {
   const textDecoder = getTextDecoder(requesterOpts.opts.textDecoder);
   return (batchOps, unitResolver) => {
-    const path3 = batchOps.map((op) => op.path).join(",");
+    const path5 = batchOps.map((op) => op.path).join(",");
     const inputs = batchOps.map((op) => op.input);
     const { cancel, promise } = streamingJsonHttpRequester({
       ...requesterOpts,
       textDecoder,
-      path: path3,
+      path: path5,
       inputs,
       headers() {
         if (!requesterOpts.opts.headers) {
@@ -7866,7 +7866,7 @@ var isURL = (payload) => payload instanceof URL;
 
 // node_modules/superjson/dist/pathstringifier.js
 var escapeKey = (key) => key.replace(/\\/g, "\\\\").replace(/\./g, "\\.");
-var stringifyPath = (path3) => path3.map(String).map(escapeKey).join(".");
+var stringifyPath = (path5) => path5.map(String).map(escapeKey).join(".");
 var parsePath = (string, legacyPaths) => {
   const result = [];
   let segment = "";
@@ -8113,26 +8113,26 @@ var getNthKey = (value, n) => {
   }
   return keys.next().value;
 };
-function validatePath(path3) {
-  if (includes(path3, "__proto__")) {
+function validatePath(path5) {
+  if (includes(path5, "__proto__")) {
     throw new Error("__proto__ is not allowed as a property");
   }
-  if (includes(path3, "prototype")) {
+  if (includes(path5, "prototype")) {
     throw new Error("prototype is not allowed as a property");
   }
-  if (includes(path3, "constructor")) {
+  if (includes(path5, "constructor")) {
     throw new Error("constructor is not allowed as a property");
   }
 }
-var getDeep = (object, path3) => {
-  validatePath(path3);
-  for (let i = 0; i < path3.length; i++) {
-    const key = path3[i];
+var getDeep = (object, path5) => {
+  validatePath(path5);
+  for (let i = 0; i < path5.length; i++) {
+    const key = path5[i];
     if (isSet(object)) {
       object = getNthKey(object, +key);
     } else if (isMap(object)) {
       const row = +key;
-      const type = +path3[++i] === 0 ? "key" : "value";
+      const type = +path5[++i] === 0 ? "key" : "value";
       const keyOfRow = getNthKey(object, row);
       switch (type) {
         case "key":
@@ -8148,14 +8148,14 @@ var getDeep = (object, path3) => {
   }
   return object;
 };
-var setDeep = (object, path3, mapper) => {
-  validatePath(path3);
-  if (path3.length === 0) {
+var setDeep = (object, path5, mapper) => {
+  validatePath(path5);
+  if (path5.length === 0) {
     return mapper(object);
   }
   let parent = object;
-  for (let i = 0; i < path3.length - 1; i++) {
-    const key = path3[i];
+  for (let i = 0; i < path5.length - 1; i++) {
+    const key = path5[i];
     if (isArray(parent)) {
       const index = +key;
       parent = parent[index];
@@ -8165,12 +8165,12 @@ var setDeep = (object, path3, mapper) => {
       const row = +key;
       parent = getNthKey(parent, row);
     } else if (isMap(parent)) {
-      const isEnd = i === path3.length - 2;
+      const isEnd = i === path5.length - 2;
       if (isEnd) {
         break;
       }
       const row = +key;
-      const type = +path3[++i] === 0 ? "key" : "value";
+      const type = +path5[++i] === 0 ? "key" : "value";
       const keyOfRow = getNthKey(parent, row);
       switch (type) {
         case "key":
@@ -8182,7 +8182,7 @@ var setDeep = (object, path3, mapper) => {
       }
     }
   }
-  const lastKey = path3[path3.length - 1];
+  const lastKey = path5[path5.length - 1];
   if (isArray(parent)) {
     parent[+lastKey] = mapper(parent[+lastKey]);
   } else if (isPlainObject(parent)) {
@@ -8197,7 +8197,7 @@ var setDeep = (object, path3, mapper) => {
     }
   }
   if (isMap(parent)) {
-    const row = +path3[path3.length - 2];
+    const row = +path5[path5.length - 2];
     const keyToRow = getNthKey(parent, row);
     const type = +lastKey === 0 ? "key" : "value";
     switch (type) {
@@ -8244,16 +8244,16 @@ function traverse(tree, walker2, version, origin = []) {
   walker2(nodeValue, origin);
 }
 function applyValueAnnotations(plain, annotations, version, superJson) {
-  traverse(annotations, (type, path3) => {
-    plain = setDeep(plain, path3, (v) => untransformValue(v, type, superJson));
+  traverse(annotations, (type, path5) => {
+    plain = setDeep(plain, path5, (v) => untransformValue(v, type, superJson));
   }, version);
   return plain;
 }
 function applyReferentialEqualityAnnotations(plain, annotations, version) {
   const legacyPaths = enableLegacyPaths(version);
-  function apply(identicalPaths, path3) {
-    const object = getDeep(plain, parsePath(path3, legacyPaths));
-    identicalPaths.map((path4) => parsePath(path4, legacyPaths)).forEach((identicalObjectPath) => {
+  function apply(identicalPaths, path5) {
+    const object = getDeep(plain, parsePath(path5, legacyPaths));
+    identicalPaths.map((path6) => parsePath(path6, legacyPaths)).forEach((identicalObjectPath) => {
       plain = setDeep(plain, identicalObjectPath, () => object);
     });
   }
@@ -8271,12 +8271,12 @@ function applyReferentialEqualityAnnotations(plain, annotations, version) {
   return plain;
 }
 var isDeep = (object, superJson) => isPlainObject(object) || isArray(object) || isMap(object) || isSet(object) || isError(object) || isInstanceOfRegisteredClass(object, superJson);
-function addIdentity(object, path3, identities) {
+function addIdentity(object, path5, identities) {
   const existingSet = identities.get(object);
   if (existingSet) {
-    existingSet.push(path3);
+    existingSet.push(path5);
   } else {
-    identities.set(object, [path3]);
+    identities.set(object, [path5]);
   }
 }
 function generateReferentialEqualityAnnotations(identitites, dedupe) {
@@ -8287,7 +8287,7 @@ function generateReferentialEqualityAnnotations(identitites, dedupe) {
       return;
     }
     if (!dedupe) {
-      paths = paths.map((path3) => path3.map(String)).sort((a, b) => a.length - b.length);
+      paths = paths.map((path5) => path5.map(String)).sort((a, b) => a.length - b.length);
     }
     const [representativePath, ...identicalPaths] = paths;
     if (representativePath.length === 0) {
@@ -8306,10 +8306,10 @@ function generateReferentialEqualityAnnotations(identitites, dedupe) {
     return isEmptyObject(result) ? void 0 : result;
   }
 }
-var walker = (object, identities, superJson, dedupe, path3 = [], objectsInThisPath = [], seenObjects = /* @__PURE__ */ new Map()) => {
+var walker = (object, identities, superJson, dedupe, path5 = [], objectsInThisPath = [], seenObjects = /* @__PURE__ */ new Map()) => {
   const primitive = isPrimitive(object);
   if (!primitive) {
-    addIdentity(object, path3, identities);
+    addIdentity(object, path5, identities);
     const seen = seenObjects.get(object);
     if (seen) {
       return dedupe ? {
@@ -8343,7 +8343,7 @@ var walker = (object, identities, superJson, dedupe, path3 = [], objectsInThisPa
     if (index === "__proto__" || index === "constructor" || index === "prototype") {
       throw new Error(`Detected property ${index}. This is a prototype pollution risk, please remove it from your object.`);
     }
-    const recursiveResult = walker(value, identities, superJson, dedupe, [...path3, index], [...objectsInThisPath, object], seenObjects);
+    const recursiveResult = walker(value, identities, superJson, dedupe, [...path5, index], [...objectsInThisPath, object], seenObjects);
     transformedValue[index] = recursiveResult.transformedValue;
     if (isArray(recursiveResult.annotations)) {
       innerAnnotations[escapeKey(index)] = recursiveResult.annotations;
@@ -8654,7 +8654,8 @@ function errorMessage(error) {
 }
 
 // src/main.ts
-import fs2 from "fs";
+import fs3 from "fs";
+import path3 from "path";
 
 // src/generated/manifest.ts
 var CLI_MANIFEST = {
@@ -13903,12 +13904,25 @@ var CLI_MANIFEST = {
         "$schema": "http://json-schema.org/draft-07/schema#"
       }
     },
+    {
+      "id": "getCampaignBenchmarks",
+      "domain": "campaigns",
+      "description": "The definition and target band of every campaign metric id that getCampaignKpis and getCampaignBreakdown return. One entry per id: { id, label, unit, description, formula, benchmark }, where unit is count, percent (0-100), usd (dollars), days or multiple (ROAS, 2 = 2x), and benchmark is { min, good, great } in that unit or null when the metric has no target band. Grade a value as green at or above good, yellow at or above min, red below min; great is a stretch level (null for ROAS). The bands are fleet percentiles (P25/P50/P75 of campaigns with over 500 visitors) rounded to clean numbers, not per-organization; ROAS is anchored at 1x break-even. Call once and reuse; the table does not change per campaign.",
+      "type": "query",
+      "path": [
+        "api",
+        "campaigns",
+        "app",
+        "benchmarks"
+      ],
+      "inputJsonSchema": null
+    },
     {
       "id": "getCampaignBreakdown",
       "domain": "campaigns",
       "description": `A campaign's metrics broken down by channel, Facebook campaign, ad set, ad, referrer and creator, as a tree of nodes, loaded a batch at a time. Pass node refs, get back each node's metrics plus the refs of its children (identifiers only, no metrics). Load children by passing those refs back in.
 
-Start from { type: "campaign", campaign: { campaignId } }, where campaignId is the Feast campaign id from listCampaigns. It returns the campaign totals and its channel refs. The tree is: campaign \u2192 channel (facebook, influencer, tiktok, google, misc, referral, unknown) \u2192 per channel: facebook \u2192 fbCampaign \u2192 fbAdset \u2192 fbAd; google \u2192 googleCampaign; tiktok \u2192 tiktokCampaign; misc \u2192 miscSource; referral \u2192 referrer; influencer \u2192 creator. A null id inside a ref is the "Unknown" bucket for sessions that could not be matched. Refs from different campaigns can be mixed in one call (max 100).
+Start from { type: "campaign", campaign: { campaignId } }, where campaignId is the Feast campaign id from listCampaigns. It returns the campaign totals and its channel refs. The tree is: campaign \u2192 channel (facebook, influencer, tiktok, google, misc, referral, unknown) \u2192 per channel: facebook \u2192 fbCampaign \u2192 fbAdset \u2192 fbAd; google \u2192 googleCampaign; tiktok \u2192 tiktokCampaign; misc \u2192 miscSource; referral \u2192 referrer; influencer \u2192 creator. Variants split the campaign by pass instead of by session: the campaign node lists them in details.campaign.variants (empty when the campaign has no variants), and { type: "variant", variant: { campaignId, variantId } } with variantId null is the default variant; variant nodes carry only signups, pass registration and show rate, time to show, revenue and revenue per signup. A null id inside a ref is the "Unknown" bucket for sessions that could not be matched. Refs from different campaigns can be mixed in one call (max 100).
 
 Metrics use start/end as the session window. Units: sessions, visitors, signups, impressions, reach are counts; *Rate, thumbStopRatio, holdRate and uniqueClickthrough are percentages (0-100); spend, cpm, revenue, costPerSignup, revenuePerSignup are USD; averageTimeToShow is days from signup to first scan. A missing metric key means the metric does not apply to that node (for example spend on a Google row); null means it applies but could not be computed (no denominator, or Facebook was unreachable, see details.facebook.error). Facebook delivery metrics are read live from Meta.`,
       "type": "query",
@@ -14251,6 +14265,36 @@ Metrics use start/end as the session window. Units: sessions, visitors, signups,
                     "creator"
                   ],
                   "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "const": "variant"
+                    },
+                    "variant": {
+                      "type": "object",
+                      "properties": {
+                        "campaignId": {
+                          "$ref": "#/properties/refs/items/anyOf/0/properties/campaign/properties/campaignId"
+                        },
+                        "variantId": {
+                          "$ref": "#/properties/refs/items/anyOf/2/properties/fbCampaign/properties/fbCampaignId"
+                        }
+                      },
+                      "required": [
+                        "campaignId",
+                        "variantId"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "required": [
+                    "type",
+                    "variant"
+                  ],
+                  "additionalProperties": false
                 }
               ]
             },
@@ -14287,7 +14331,7 @@ Metrics use start/end as the session window. Units: sessions, visitors, signups,
     {
       "id": "getCampaignKpis",
       "domain": "campaigns",
-      "description": "Performance metrics for an acquisition campaign. campaignId is the Feast campaign's `id` from listCampaigns (a UUID), NOT the nested Meta campaignId. Returns { id, type, value, unit } per metric, where unit is COUNT, PERCENTAGE (0-1) or CURRENCY (cents). Covers ad performance (spend, impressions, hook rate (thumb stop), hold rate, CTR \u2014 sourced from synced Facebook data, so ROAS is revenue divided by spend), the funnel, automations, and results. Metrics whose value would be zero are omitted rather than returned as 0 \u2014 notably spend, so an absent spend metric means no spend OR no sync yet, never a confirmed zero.",
+      "description": "Performance metrics for an acquisition campaign. campaignId is the Feast campaign's `id` from listCampaigns (a UUID), NOT the nested Meta campaignId. Returns { id, type, value, unit } per metric. Metric ids are the same camelCase ids getCampaignBreakdown uses (signupRate, thumbStopRatio, uniqueClickthrough, revenue, ...), and units match it too: count, percent (0-100), usd (dollars). Rate metrics with a target band carry benchmark: { min, good, great } in the same unit (see getCampaignBenchmarks for the full table and grading rule). Covers ad performance (spend, impressions, hook rate (thumb stop), hold rate, CTR \u2014 sourced from synced Facebook data, so ROAS is revenue divided by spend), the funnel, automations, and results. Metrics whose value would be zero are omitted rather than returned as 0 \u2014 notably spend, so an absent spend metric means no spend OR no sync yet, never a confirmed zero.",
       "type": "query",
       "path": [
         "api",
@@ -26451,6 +26495,90 @@ function validateToolInput(tool, input) {
   );
 }
 
+// src/skills.ts
+import fs2 from "fs";
+import os2 from "os";
+import path2 from "path";
+var MARKER_FILE = ".feast-skill.json";
+var SKILL_NAME_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+function defaultSkillsDir() {
+  return path2.join(os2.homedir(), ".claude", "skills");
+}
+async function createClient(orgFlag, roleFlag) {
+  const acting = await resolveActingContext(orgFlag, roleFlag);
+  return createHttpCaller({
+    accessToken: acting.accessToken,
+    preferredRole: acting.preferredRole
+  });
+}
+async function listSkills(orgFlag, roleFlag) {
+  const client = await createClient(orgFlag, roleFlag);
+  const entries = await callProcedure(client, ["api", "skills", "list"], "query", void 0);
+  return Array.isArray(entries) ? entries : [];
+}
+async function fetchSkill(name, orgFlag, roleFlag) {
+  if (!SKILL_NAME_PATTERN.test(name)) {
+    throw new Error(`Invalid skill name "${name}". Run: feast skill list`);
+  }
+  const client = await createClient(orgFlag, roleFlag);
+  return callProcedure(client, ["api", "skills", "get"], "query", { name });
+}
+function assertInsideDir(root, relative) {
+  const target = path2.resolve(root, relative);
+  if (target !== root && !target.startsWith(`${root}${path2.sep}`)) {
+    throw new Error(`Refusing to write outside the skill directory: ${relative}`);
+  }
+  return target;
+}
+function readMarker(dir) {
+  const markerPath = path2.join(dir, MARKER_FILE);
+  if (!fs2.existsSync(markerPath)) {
+    return void 0;
+  }
+  try {
+    return JSON.parse(fs2.readFileSync(markerPath, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function writeSkill(bundle, targetDir, force) {
+  const dir = path2.resolve(targetDir);
+  const exists = fs2.existsSync(dir);
+  const marker = exists ? readMarker(dir) : void 0;
+  if (exists && marker == null && !force) {
+    throw new Error(
+      `${dir} exists and was not installed by feast. Pass --force to replace it.`
+    );
+  }
+  if (exists) {
+    fs2.rmSync(dir, { recursive: true, force: true });
+  }
+  fs2.mkdirSync(dir, { recursive: true });
+  for (const file of bundle.files) {
+    const target = assertInsideDir(dir, file.path);
+    fs2.mkdirSync(path2.dirname(target), { recursive: true });
+    fs2.writeFileSync(target, file.content);
+  }
+  fs2.writeFileSync(
+    path2.join(dir, MARKER_FILE),
+    `${JSON.stringify(
+      {
+        name: bundle.name,
+        version: bundle.version,
+        publishedAt: bundle.publishedAt,
+        installedAt: (/* @__PURE__ */ new Date()).toISOString()
+      },
+      null,
+      2
+    )}
+`
+  );
+  return { dir, written: bundle.files.length, replaced: exists };
+}
+function shortVersion(version) {
+  return version.slice(0, 7);
+}
+
 // src/main.ts
 var USAGE = `Usage: feast <command> [options]
 
@@ -26462,6 +26590,12 @@ Commands:
   tools [--domain <domain>] [--json]    List available tools
   describe <tool>                       Show a tool's description and input JSON schema
   call <tool> [options]                 Invoke a tool
+  skill list                            List the skills you can install
+  skill install <name> [options]        Install a skill into ~/.claude/skills/<name>
+
+Skill install options:
+  --dir <path>              Install into this directory instead of ~/.claude/skills/<name>
+  --force                   Replace a directory that feast did not install
 
 Call options:
   --org <organizationId>    Organization to act on (required unless you belong to exactly one)
@@ -26483,7 +26617,14 @@ Non-interactive credentials (for sandboxed agents):
 function parseArgs(argv) {
   const positional = [];
   const flags = {};
-  const valueFlags = /* @__PURE__ */ new Set(["org", "role", "input", "input-file", "domain"]);
+  const valueFlags = /* @__PURE__ */ new Set([
+    "org",
+    "role",
+    "input",
+    "input-file",
+    "domain",
+    "dir"
+  ]);
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
     if (!arg.startsWith("--")) {
@@ -26631,7 +26772,7 @@ function readCallInput(args) {
   }
   let raw = inputJson;
   if (inputFile != null) {
-    raw = fs2.readFileSync(inputFile, "utf-8");
+    raw = fs3.readFileSync(inputFile, "utf-8");
   }
   if (raw == null) {
     return {};
@@ -26699,6 +26840,41 @@ Run: feast describe ${tool.id}`
   const result = await callProcedure(client, tool.path, tool.type, input);
   console.info(JSON.stringify(result ?? null, null, 2));
 }
+async function commandSkill(args) {
+  const [subcommand, name] = args.positional;
+  const orgFlag = args.flags["org"];
+  const roleFlag = args.flags["role"];
+  if (subcommand === "list") {
+    const entries = await listSkills(orgFlag, roleFlag);
+    if (entries.length === 0) {
+      console.info("No skills are published for your organization yet.");
+      return;
+    }
+    for (const entry of entries) {
+      console.info(
+        `${entry.name}  ${entry.displayTitle}  (version ${shortVersion(entry.version)})`
+      );
+      console.info(`    ${entry.description.split("\n")[0]}`);
+    }
+    return;
+  }
+  if (subcommand === "install") {
+    if (name == null) {
+      throw new Error("Usage: feast skill install <name> [--dir <path>] [--force]");
+    }
+    const bundle = await fetchSkill(name, orgFlag, roleFlag);
+    const targetDir = args.flags["dir"] ?? path3.join(defaultSkillsDir(), bundle.name);
+    const result = writeSkill(bundle, targetDir, args.flags["force"] === true);
+    console.info(
+      `${result.replaced ? "Updated" : "Installed"} ${bundle.name} (version ${shortVersion(bundle.version)}, ${result.written} files) in ${result.dir}`
+    );
+    console.info(
+      "Claude Code picks it up on the next session. For claude.ai, zip that directory and upload it under Settings > Capabilities > Skills."
+    );
+    return;
+  }
+  throw new Error("Usage: feast skill <list|install <name>>");
+}
 async function runCli(argv) {
   const [command, ...rest] = argv;
   const args = parseArgs(rest);
@@ -26722,6 +26898,9 @@ async function runCli(argv) {
     case "call":
       await commandCall(args);
       break;
+    case "skill":
+      await commandSkill(args);
+      break;
     default:
       console.info(USAGE);
       if (command != null && command !== "help") {
@@ -26731,16 +26910,16 @@ async function runCli(argv) {
 }
 
 // src/updateNotifier.ts
-import fs3 from "fs";
+import fs4 from "fs";
 import { createRequire as createRequire2 } from "module";
-import os2 from "os";
-import path2 from "path";
+import os3 from "os";
+import path4 from "path";
 var PACKAGE_NAME = "@feastalytics/cli";
 var REGISTRY_URL = "https://registry.npmjs.org";
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 var FETCH_TIMEOUT_MS = 1500;
-var CACHE_DIR = path2.join(os2.homedir(), ".config", "feast-cli");
-var CACHE_PATH = path2.join(CACHE_DIR, "update-check.json");
+var CACHE_DIR = path4.join(os3.homedir(), ".config", "feast-cli");
+var CACHE_PATH = path4.join(CACHE_DIR, "update-check.json");
 function readPackageVersion2() {
   try {
     const require2 = createRequire2(import.meta.url);
@@ -26777,7 +26956,7 @@ function isDisabled() {
 function readCache() {
   try {
     const parsed = JSON.parse(
-      fs3.readFileSync(CACHE_PATH, "utf-8")
+      fs4.readFileSync(CACHE_PATH, "utf-8")
     );
     return typeof parsed.latest === "string" && typeof parsed.checkedAt === "number" ? parsed : void 0;
   } catch {
@@ -26786,8 +26965,8 @@ function readCache() {
 }
 function writeCache(cache) {
   try {
-    fs3.mkdirSync(CACHE_DIR, { recursive: true, mode: 448 });
-    fs3.writeFileSync(CACHE_PATH, JSON.stringify(cache));
+    fs4.mkdirSync(CACHE_DIR, { recursive: true, mode: 448 });
+    fs4.writeFileSync(CACHE_PATH, JSON.stringify(cache));
   } catch {
     return;
   }

package/feast/references/setup.md

@@ -44,6 +44,17 @@ If you've been invoking the CLI through `npx` rather than a global install, skip
 
 Update the skill whenever you update the CLI: the two ship from the same repo but on different triggers, so a new CLI version usually means this skill's guidance has moved too.
 
+## Playbook skills
+
+Feastalytics publishes further skills that build on this one (campaign diagnosis and other playbooks). They come from the API, not from GitHub:
+
+```bash
+feast skill list                       # what is published for your organization
+feast skill install feast-playbooks    # install or refresh one into ~/.claude/skills/
+```
+
+Install what `feast skill list` offers when the user asks for a playbook this skill does not cover, and re-run the install when the CLI prints an update notice.
+
 ## Which organization
 
 Most tools act on one organization. A user often belongs to several, so which one you target matters and must be explicit.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feastalytics/cli",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Command-line client for the Feastalytics platform — list, create, and update campaigns, automations, offers, and members-program rewards from the terminal.",
   "type": "module",
   "bin": {