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

criteria:
  - name: calls_get_offer
    kind: deterministic
    check: "The skill execution successfully calls the getOffer() function from state/lib/offer.ts."
  - name: calls_get_pricing
    kind: deterministic
    check: "The skill execution successfully calls the getPricing() function from state/lib/offer.ts."
  - name: calls_get_icp
    kind: deterministic
    check: "The skill execution successfully calls the getIcp() function from state/lib/offer.ts."
  - name: writes_pending_eval_log
    kind: deterministic
    check: "A new row is appended to state/log/pending-eval.ndjson after the skill execution."

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

api.ts- the code it can call

#!/usr/bin/env npx tsx
/**
 * snappy-offer/api.ts -- Business offer, model, and pricing data.
 *
 * Reads from local SKILL.md and sibling files. Pure data skill -- no external APIs.
 *
 * Usage:
 *   npx tsx api.ts offer     # canonical offer definition
 *   npx tsx api.ts pricing   # pricing tiers
 *
 * Or import as module:
 *   import { getOffer, getPricing } from "./offer.ts";
 */

import { existsSync, readFileSync, realpathSync } from "fs";
import { join, dirname } from "path";
import { fileURLToPath } from "url";
import { env } from "./env.ts";

const SKILL_DIR = dirname(fileURLToPath(import.meta.url));

function readSkillFile(filename: string): string {
  const path = join(SKILL_DIR, filename);
  if (!existsSync(path)) {
    throw new Error(`[snappy-offer] ${filename} not found at ${path}`);
  }
  return readFileSync(path, "utf-8");
}

function extractSection(content: string, heading: string): string {
  const pattern = new RegExp(`^##\\s+${heading}[^\\n]*\\n`, "m");
  const match = content.search(pattern);
  if (match === -1) return "";
  const rest = content.slice(match);
  const nextH2 = rest.indexOf("\n## ", 1);
  return nextH2 === -1 ? rest.trim() : rest.slice(0, nextH2).trim();
}

// --- Public API ---

export function getOffer(): {
  businessModel: string;
  transformationStatement: string;
  offerStack: string;
  full: string;
} {
  const skill = readSkillFile("SKILL.md");
  return {
    businessModel: extractSection(skill, "Business Model"),
    transformationStatement: extractSection(skill, "Transformation Statement"),
    offerStack: extractSection(skill, "Offer Stack"),
    full: skill,
  };
}

export function getPricing(): string {
  if (existsSync(join(SKILL_DIR, "pricing.md"))) {
    return readSkillFile("pricing.md");
  }
  const skill = readSkillFile("SKILL.md");
  const section = extractSection(skill, "Pricing") || extractSection(skill, "Tier");
  return section || "[snappy-offer] No pricing section found. Check SKILL.md.";
}

export function getIcp(): string {
  if (existsSync(join(SKILL_DIR, "icp.md"))) {
    return readSkillFile("icp.md");
  }
  const skill = readSkillFile("SKILL.md");
  return extractSection(skill, "Ideal Client") || "[snappy-offer] No ICP section found.";
}

// --- CLI ---

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

    switch (cmd) {
      case "offer": {
        const offer = getOffer();
        console.log(offer.businessModel || offer.full.slice(0, 2000));
        break;
      }
      case "pricing": {
        console.log(getPricing());
        break;
      }
      case "icp": {
        console.log(getIcp());
        break;
      }
      default:
        console.log("Usage: npx tsx api.ts [offer|pricing|icp]");
    }
  })();
}

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