SKILL.md- the skill, written out in plain English

criteria:
  - name: calls_all_required_functions
    kind: deterministic
    check: "The execution log includes calls to checkSlackJoins(), checkEmail(), and classifyInbound()."
  - name: inputs_are_strings
    kind: deterministic
    check: "Inputs checkSlackJoins_input, checkEmail_input, and classifyInbound_input are all provided as strings."
  - name: creates_log_row
    kind: deterministic
    check: "A new row is appended to state/log/pending-eval.ndjson after skill execution."
  - name: inbound_classification_valid
    kind: judge
    check: "The output of classifyInbound() aligns with expected inbound classification based on provided inputs."

AGENTS.md- what the AI loads when this skill comes up

api.ts- the code it can call

#!/usr/bin/env npx tsx
/**
 * snappy-inbound/api.ts -- Inbound detection and classification.
 *
 * Usage:
 *   npx tsx api.ts slack-joins            # check #all-snappy for join events
 *   npx tsx api.ts classify "I want to learn about AI agents for my business"
 *
 * Or import as module:
 *   import { checkSlackJoins, classifyInbound } from "./inbound.ts";
 */

import { readMessages } from "./slack.ts";
import { env } from "./env.ts";
import { realpathSync } from "fs";

const ALL_SNAPPY_CHANNEL = "C09DD2D0S07";

/** Check #all-snappy for recent join events. Returns messages with join subtype. */
export async function checkSlackJoins(limit = 50) {
  const data = await readMessages(ALL_SNAPPY_CHANNEL, limit);
  if (!data.messages) return [];
  return data.messages.filter(
    (m: any) => m.subtype === "channel_join" || m.subtype === "group_join"
  );
}

/**
 * Check email for new subscribers.
 * Placeholder -- ActiveCampaign is NOT in use. Email goes through Xano/Gmail.
 * When implementing, use Xano contacts API or Loops.so for subscriber list polling.
 */
export async function checkEmail(): Promise<{ status: string; info: string }> {
  return {
    status: "not_implemented",
    info: "Subscriber polling not yet implemented. Use Xano contacts API (GET api:PB9UH7b9/contacts) or Loops.so. ActiveCampaign is NOT in use.",
  };
}

type InboundType = "lead" | "support" | "spam" | "partnership" | "unknown";

/** Classify inbound text into a type. Simple keyword-based -- upgrade to LLM call if needed. */
export function classifyInbound(text: string): { type: InboundType; confidence: number } {
  const lower = text.toLowerCase();

  const spamSignals = ["unsubscribe", "casino", "crypto airdrop", "free money", "click here now"];
  if (spamSignals.some((s) => lower.includes(s))) {
    return { type: "spam", confidence: 0.9 };
  }

  const partnerSignals = ["partnership", "collaborate", "joint venture", "co-market", "affiliate"];
  if (partnerSignals.some((s) => lower.includes(s))) {
    return { type: "partnership", confidence: 0.7 };
  }

  const supportSignals = ["help", "issue", "broken", "not working", "bug", "error", "can't access"];
  if (supportSignals.some((s) => lower.includes(s))) {
    return { type: "support", confidence: 0.7 };
  }

  const leadSignals = [
    "interested", "pricing", "how much", "learn more", "demo",
    "business", "agency", "consulting", "ai agent", "automation",
  ];
  if (leadSignals.some((s) => lower.includes(s))) {
    return { type: "lead", confidence: 0.7 };
  }

  return { type: "unknown", confidence: 0.3 };
}

// --- CLI ---

if ((() => { try { return import.meta.url === `file://${realpathSync(process.argv[1])}`; } catch { return false; } })()) {
  (async () => {
    const [, , cmd, ...args] = process.argv;

    switch (cmd) {
      case "slack-joins": {
        const joins = await checkSlackJoins();
        if (joins.length === 0) {
          console.log("No recent join events.");
        } else {
          for (const j of joins) {
            const ts = new Date(Number(j.ts) * 1000).toISOString().slice(0, 16);
            console.log(`${ts}\t${j.user}\tjoined`);
          }
        }
        break;
      }
      case "classify": {
        const text = args.join(" ");
        if (!text) { console.error("Usage: api.ts classify <text>"); process.exit(1); }
        const result = classifyInbound(text);
        console.log(JSON.stringify(result, null, 2));
        break;
      }
      default:
        console.log("Usage: npx tsx api.ts [slack-joins|classify] ...");
    }
  })();
}

scripts- helper scripts it can run

prose-only skill - 1 inline code block live in SKILL.md above (no state/bin/ sidecar yet).

how we check it- the checks, plus the last 10 runs

no recent runs logged - the eval contract is declared but nothing has been graded yet