@skilljit/core 0.1.0

package/dist/catalog.d.ts

@@ -0,0 +1,18 @@
+import type { SkillRecord, SkillSearchHit, ToolRecord, ToolSearchHit } from "./types.js";
+export declare class Catalog {
+    private db;
+    constructor(dbPath: string);
+    close(): void;
+    upsertSkills(skills: SkillRecord[]): void;
+    getSkill(id: string): SkillRecord | undefined;
+    searchSkills(query: string, limit?: number): SkillSearchHit[];
+    count(): number;
+    /** Name + description for every cataloged skill — used to compute the
+     * "what this would have cost every turn" baseline without paying to
+     * load every skill's full body. */
+    listSkillMeta(): Pick<SkillRecord, "name" | "description">[];
+    upsertTools(tools: ToolRecord[]): void;
+    searchTools(query: string, limit?: number): ToolSearchHit[];
+    removeToolsForServer(server: string): void;
+    toolCount(): number;
+}

package/dist/catalog.js

@@ -0,0 +1,234 @@
+import Database from "better-sqlite3";
+import fs from "node:fs";
+import path from "node:path";
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS skills (
+  id           TEXT PRIMARY KEY,
+  name         TEXT NOT NULL,
+  source       TEXT NOT NULL,
+  description  TEXT NOT NULL,
+  body         TEXT NOT NULL,
+  install_count INTEGER,
+  audit_status  TEXT,
+  updated_at    TEXT NOT NULL
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS skills_fts USING fts5(
+  id UNINDEXED,
+  name,
+  description,
+  tokenize = 'porter unicode61'
+);
+
+CREATE TABLE IF NOT EXISTS tools (
+  id            TEXT PRIMARY KEY,
+  server        TEXT NOT NULL,
+  name          TEXT NOT NULL,
+  description   TEXT NOT NULL,
+  input_schema  TEXT NOT NULL,
+  updated_at    TEXT NOT NULL
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS tools_fts USING fts5(
+  id UNINDEXED,
+  name,
+  description,
+  tokenize = 'porter unicode61'
+);
+`;
+/**
+ * Turn a free-text query into a permissive FTS5 MATCH expression:
+ * each alphanumeric token, quoted (so hyphens/punctuation in the raw
+ * query can't break MATCH syntax) and OR'd together. OR-recall is
+ * intentional: skill_find/tool_find return cheap candidates, and the
+ * caller (Claude) can re-query in different words if the first list
+ * doesn't have what it needs — that beats forcing one-shot precision
+ * out of a token search.
+ */
+function toFtsQuery(query) {
+    const tokens = query
+        .toLowerCase()
+        .match(/[a-z0-9]+/g)
+        ?.filter((t) => t.length > 0);
+    if (!tokens || tokens.length === 0)
+        return null;
+    return tokens.map((t) => `"${t}"`).join(" OR ");
+}
+export class Catalog {
+    db;
+    constructor(dbPath) {
+        if (dbPath !== ":memory:") {
+            fs.mkdirSync(path.dirname(dbPath), { recursive: true });
+        }
+        this.db = new Database(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.db.exec(SCHEMA);
+    }
+    close() {
+        this.db.close();
+    }
+    // ---- Skills ----------------------------------------------------------
+    upsertSkills(skills) {
+        const upsert = this.db.prepare(`
+      INSERT INTO skills (id, name, source, description, body, install_count, audit_status, updated_at)
+      VALUES (@id, @name, @source, @description, @body, @installCount, @auditStatus, @updatedAt)
+      ON CONFLICT(id) DO UPDATE SET
+        name = excluded.name,
+        source = excluded.source,
+        description = excluded.description,
+        body = excluded.body,
+        install_count = excluded.install_count,
+        audit_status = excluded.audit_status,
+        updated_at = excluded.updated_at
+    `);
+        const deleteFts = this.db.prepare(`DELETE FROM skills_fts WHERE id = ?`);
+        const insertFts = this.db.prepare(`INSERT INTO skills_fts (id, name, description) VALUES (?, ?, ?)`);
+        const tx = this.db.transaction((rows) => {
+            for (const s of rows) {
+                upsert.run({
+                    id: s.id,
+                    name: s.name,
+                    source: s.source,
+                    description: s.description,
+                    body: s.body,
+                    installCount: s.installCount ?? null,
+                    auditStatus: s.auditStatus ?? "unaudited",
+                    updatedAt: s.updatedAt,
+                });
+                deleteFts.run(s.id);
+                insertFts.run(s.id, s.name, s.description);
+            }
+        });
+        tx(skills);
+    }
+    getSkill(id) {
+        const row = this.db.prepare(`SELECT * FROM skills WHERE id = ?`).get(id);
+        if (!row)
+            return undefined;
+        return rowToSkill(row);
+    }
+    searchSkills(query, limit = 8) {
+        const ftsQuery = toFtsQuery(query);
+        if (!ftsQuery)
+            return [];
+        const rows = this.db
+            .prepare(`
+        SELECT s.id, s.name, s.source, s.description, s.install_count, s.audit_status, s.updated_at,
+               bm25(skills_fts) AS rank
+        FROM skills_fts
+        JOIN skills s ON s.id = skills_fts.id
+        WHERE skills_fts MATCH ?
+        ORDER BY rank
+        LIMIT ?
+      `)
+            .all(ftsQuery, limit);
+        return rows.map((row) => ({
+            skill: {
+                id: row.id,
+                name: row.name,
+                source: row.source,
+                description: row.description,
+                installCount: row.install_count ?? undefined,
+                auditStatus: row.audit_status ?? "unaudited",
+                updatedAt: row.updated_at,
+            },
+            rank: row.rank,
+        }));
+    }
+    count() {
+        const row = this.db.prepare(`SELECT COUNT(*) AS c FROM skills`).get();
+        return row.c;
+    }
+    /** Name + description for every cataloged skill — used to compute the
+     * "what this would have cost every turn" baseline without paying to
+     * load every skill's full body. */
+    listSkillMeta() {
+        return this.db.prepare(`SELECT name, description FROM skills`).all();
+    }
+    // ---- Tools -------------------------------------------------------------
+    upsertTools(tools) {
+        const upsert = this.db.prepare(`
+      INSERT INTO tools (id, server, name, description, input_schema, updated_at)
+      VALUES (@id, @server, @name, @description, @inputSchema, @updatedAt)
+      ON CONFLICT(id) DO UPDATE SET
+        server = excluded.server,
+        name = excluded.name,
+        description = excluded.description,
+        input_schema = excluded.input_schema,
+        updated_at = excluded.updated_at
+    `);
+        const deleteFts = this.db.prepare(`DELETE FROM tools_fts WHERE id = ?`);
+        const insertFts = this.db.prepare(`INSERT INTO tools_fts (id, name, description) VALUES (?, ?, ?)`);
+        const tx = this.db.transaction((rows) => {
+            for (const t of rows) {
+                upsert.run({
+                    id: t.id,
+                    server: t.server,
+                    name: t.name,
+                    description: t.description,
+                    inputSchema: JSON.stringify(t.inputSchema),
+                    updatedAt: t.updatedAt,
+                });
+                deleteFts.run(t.id);
+                insertFts.run(t.id, t.name, t.description);
+            }
+        });
+        tx(tools);
+    }
+    searchTools(query, limit = 8) {
+        const ftsQuery = toFtsQuery(query);
+        if (!ftsQuery)
+            return [];
+        const rows = this.db
+            .prepare(`
+        SELECT t.id, t.server, t.name, t.description, t.input_schema, t.updated_at,
+               bm25(tools_fts) AS rank
+        FROM tools_fts
+        JOIN tools t ON t.id = tools_fts.id
+        WHERE tools_fts MATCH ?
+        ORDER BY rank
+        LIMIT ?
+      `)
+            .all(ftsQuery, limit);
+        return rows.map((row) => ({
+            tool: {
+                id: row.id,
+                server: row.server,
+                name: row.name,
+                description: row.description,
+                inputSchema: JSON.parse(row.input_schema),
+                updatedAt: row.updated_at,
+            },
+            rank: row.rank,
+        }));
+    }
+    removeToolsForServer(server) {
+        const ids = this.db.prepare(`SELECT id FROM tools WHERE server = ?`).all(server);
+        const deleteTool = this.db.prepare(`DELETE FROM tools WHERE id = ?`);
+        const deleteFts = this.db.prepare(`DELETE FROM tools_fts WHERE id = ?`);
+        const tx = this.db.transaction(() => {
+            for (const { id } of ids) {
+                deleteTool.run(id);
+                deleteFts.run(id);
+            }
+        });
+        tx();
+    }
+    toolCount() {
+        const row = this.db.prepare(`SELECT COUNT(*) AS c FROM tools`).get();
+        return row.c;
+    }
+}
+function rowToSkill(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        source: row.source,
+        description: row.description,
+        body: row.body,
+        installCount: row.install_count ?? undefined,
+        auditStatus: row.audit_status ?? "unaudited",
+        updatedAt: row.updated_at,
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { Catalog } from "./catalog.js";
+export { countTokens, estimateSkillMetadataTokens, TokenLedger } from "./tokens.js";
+export type { TokenStats } from "./tokens.js";
+export type { SkillRecord, SkillSearchHit, ToolRecord, ToolSearchHit } from "./types.js";
+export { defaultCatalogPath } from "./paths.js";
+export { parseSkillMd } from "./ingest/parse.js";
+export { ingestGithubRepo } from "./ingest/github.js";
+export type { GithubIngestOptions } from "./ingest/github.js";
+export { DEFAULT_GITHUB_SOURCES } from "./ingest/sources.js";

package/dist/index.js

@@ -0,0 +1,7 @@
+export { Catalog } from "./catalog.js";
+export { countTokens, estimateSkillMetadataTokens, TokenLedger } from "./tokens.js";
+export { defaultCatalogPath } from "./paths.js";
+export { parseSkillMd } from "./ingest/parse.js";
+export { ingestGithubRepo } from "./ingest/github.js";
+export { DEFAULT_GITHUB_SOURCES } from "./ingest/sources.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/ingest/github.d.ts

@@ -0,0 +1,16 @@
+import type { SkillRecord } from "../types.js";
+export interface GithubIngestOptions {
+    /** Injectable for testing; defaults to the global fetch. */
+    fetchImpl?: typeof fetch;
+    /** Personal access token (or SKILLJIT_GITHUB_TOKEN env var) for the 5000/hr rate limit. */
+    token?: string;
+    /** Override branch/ref instead of the repo's default branch. */
+    ref?: string;
+}
+/**
+ * Ingest every SKILL.md found in a GitHub repo, via the git trees API
+ * (one recursive call, no per-directory listing) and raw.githubusercontent.com
+ * for content — both public, unauthenticated-friendly endpoints, so this
+ * scales to skilljit's default repo list without needing a GitHub App.
+ */
+export declare function ingestGithubRepo(owner: string, repo: string, opts?: GithubIngestOptions): Promise<SkillRecord[]>;

package/dist/ingest/github.js

@@ -0,0 +1,56 @@
+import { parseSkillMd } from "./parse.js";
+async function githubApiFetch(url, opts) {
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const token = opts.token ?? process.env.SKILLJIT_GITHUB_TOKEN;
+    const res = await fetchImpl(url, {
+        headers: {
+            Accept: "application/vnd.github+json",
+            ...(token ? { Authorization: `Bearer ${token}` } : {}),
+        },
+    });
+    if (res.status === 403 || res.status === 429) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`GitHub API rate limit hit while ingesting (status ${res.status}). ` +
+            `Set SKILLJIT_GITHUB_TOKEN to raise the limit from 60/hr to 5000/hr. ${body}`);
+    }
+    if (!res.ok) {
+        throw new Error(`GitHub API request failed: ${res.status} ${url}`);
+    }
+    return res;
+}
+/**
+ * Ingest every SKILL.md found in a GitHub repo, via the git trees API
+ * (one recursive call, no per-directory listing) and raw.githubusercontent.com
+ * for content — both public, unauthenticated-friendly endpoints, so this
+ * scales to skilljit's default repo list without needing a GitHub App.
+ */
+export async function ingestGithubRepo(owner, repo, opts = {}) {
+    const source = `github:${owner}/${repo}`;
+    let ref = opts.ref;
+    if (!ref) {
+        const repoRes = await githubApiFetch(`https://api.github.com/repos/${owner}/${repo}`, opts);
+        const repoJson = (await repoRes.json());
+        ref = repoJson.default_branch;
+    }
+    const treeRes = await githubApiFetch(`https://api.github.com/repos/${owner}/${repo}/git/trees/${ref}?recursive=1`, opts);
+    const treeJson = (await treeRes.json());
+    if (treeJson.truncated) {
+        // eslint-disable-next-line no-console
+        console.warn(`skilljit: ${owner}/${repo}'s file tree was truncated by GitHub's API — some SKILL.md files may be missed.`);
+    }
+    const skillPaths = treeJson.tree.filter((e) => e.type === "blob" && /(^|\/)SKILL\.md$/.test(e.path));
+    const results = [];
+    for (const entry of skillPaths) {
+        const rawUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${ref}/${entry.path}`;
+        const fetchImpl = opts.fetchImpl ?? fetch;
+        const res = await fetchImpl(rawUrl);
+        if (!res.ok)
+            continue;
+        const content = await res.text();
+        const parsed = parseSkillMd(content, { source, path: entry.path });
+        if (parsed)
+            results.push(parsed);
+    }
+    return results;
+}
+//# sourceMappingURL=github.js.map

package/dist/ingest/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/ingest/github.ts"],"names":[],"mappings":"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"}

package/dist/ingest/parse.d.ts

@@ -0,0 +1,17 @@
+import type { SkillRecord } from "../types.js";
+export interface ParseContext {
+    /** e.g. "github:anthropics/skills" */
+    source: string;
+    /** repo-relative path to the SKILL.md file, used to build a stable id */
+    path: string;
+    now?: () => string;
+}
+/**
+ * Parse a SKILL.md file's content into a SkillRecord, enforcing the same
+ * frontmatter constraints Anthropic's Agent Skills spec requires (max
+ * lengths, allowed name charset, no reserved words, no XML tags). A file
+ * that doesn't satisfy the spec is skipped (returns null) rather than
+ * ingested malformed — a bad upstream skill should disappear quietly, not
+ * corrupt the local catalog.
+ */
+export declare function parseSkillMd(content: string, ctx: ParseContext): SkillRecord | null;

package/dist/ingest/parse.js

@@ -0,0 +1,49 @@
+import YAML from "yaml";
+const NAME_RE = /^[a-z0-9-]{1,64}$/;
+const RESERVED_WORDS = ["anthropic", "claude"];
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
+/**
+ * Parse a SKILL.md file's content into a SkillRecord, enforcing the same
+ * frontmatter constraints Anthropic's Agent Skills spec requires (max
+ * lengths, allowed name charset, no reserved words, no XML tags). A file
+ * that doesn't satisfy the spec is skipped (returns null) rather than
+ * ingested malformed — a bad upstream skill should disappear quietly, not
+ * corrupt the local catalog.
+ */
+export function parseSkillMd(content, ctx) {
+    const match = FRONTMATTER_RE.exec(content);
+    if (!match)
+        return null;
+    let frontmatter;
+    try {
+        frontmatter = YAML.parse(match[1]);
+    }
+    catch {
+        return null;
+    }
+    if (!frontmatter || typeof frontmatter !== "object")
+        return null;
+    const { name, description } = frontmatter;
+    if (typeof name !== "string" || typeof description !== "string")
+        return null;
+    if (!NAME_RE.test(name))
+        return null;
+    if (RESERVED_WORDS.some((w) => name.includes(w)))
+        return null;
+    if (description.length === 0 || description.length > 1024)
+        return null;
+    if (/<[^>]+>/.test(name) || /<[^>]+>/.test(description))
+        return null;
+    const body = match[2] ?? "";
+    const dir = ctx.path.replace(/\/SKILL\.md$/i, "").replace(/^\.\//, "");
+    const id = dir && dir !== ctx.path ? `${ctx.source}/${dir}` : `${ctx.source}/${name}`;
+    return {
+        id,
+        name,
+        source: ctx.source,
+        description,
+        body,
+        updatedAt: (ctx.now ?? (() => new Date().toISOString()))(),
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/ingest/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/ingest/parse.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,OAAO,GAAG,mBAAmB,CAAC;AACpC,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAC/C,MAAM,cAAc,GAAG,6CAA6C,CAAC;AAUrE;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,GAAiB;IAC7D,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,WAAoB,CAAC;IACzB,IAAI,CAAC;QACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEjE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,WAAsC,CAAC;IACrE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,IAAI;QAAE,OAAO,IAAI,CAAC;IACvE,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAErE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,EAAE,GAAG,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;IAEtF,OAAO;QACL,EAAE;QACF,IAAI;QACJ,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW;QACX,IAAI;QACJ,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE;KAC3D,CAAC;AACJ,CAAC"}

package/dist/ingest/sources.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Default first-party / high-quality repos to scan for SKILL.md files.
+ * This is the "direct repos" leg of catalog sourcing described in the
+ * design doc — deliberately small and curated rather than an attempt to
+ * mirror all 2,800+ repos skills.sh indexes. `skilljit sync --repo owner/name`
+ * lets a user add their own.
+ */
+export declare const DEFAULT_GITHUB_SOURCES: {
+    owner: string;
+    repo: string;
+}[];

package/dist/ingest/sources.js

@@ -0,0 +1,14 @@
+/**
+ * Default first-party / high-quality repos to scan for SKILL.md files.
+ * This is the "direct repos" leg of catalog sourcing described in the
+ * design doc — deliberately small and curated rather than an attempt to
+ * mirror all 2,800+ repos skills.sh indexes. `skilljit sync --repo owner/name`
+ * lets a user add their own.
+ */
+export const DEFAULT_GITHUB_SOURCES = [
+    { owner: "anthropics", repo: "skills" },
+    { owner: "vercel-labs", repo: "agent-skills" },
+    { owner: "obra", repo: "superpowers" },
+    { owner: "wshobson", repo: "agents" },
+];
+//# sourceMappingURL=sources.js.map

package/dist/ingest/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/ingest/sources.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsC;IACvE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;IACvC,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE;IAC9C,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE;IACtC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;CACtC,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,2 @@
+/** Where the local skilljit catalog db lives: ~/.skilljit/catalog.db. */
+export declare function defaultCatalogPath(): string;

package/dist/paths.js

@@ -0,0 +1,8 @@
+import os from "node:os";
+import path from "node:path";
+/** Where the local skilljit catalog db lives: ~/.skilljit/catalog.db. */
+export function defaultCatalogPath() {
+    const home = process.env.SKILLJIT_HOME ?? os.homedir();
+    return path.join(home, ".skilljit", "catalog.db");
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,yEAAyE;AACzE,MAAM,UAAU,kBAAkB;IAChC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC"}

package/dist/tokens.d.ts

@@ -0,0 +1,55 @@
+import type { SkillRecord } from "./types.js";
+/**
+ * Token count for a string, via a real BPE tokenizer (gpt-tokenizer's
+ * cl100k encoding). This is an approximation of Claude's own tokenizer —
+ * Anthropic doesn't publish one — but it is a real, auditable count of a
+ * real BPE encoding, not a heuristic like "chars / 4". We say so in every
+ * place this number is surfaced (see TokenLedger.stats()).
+ */
+export declare function countTokens(text: string): number;
+/**
+ * Approximate the per-turn cost of one skill's always-loaded metadata:
+ * its `name` + `description`, formatted the way Claude Code renders it
+ * in the system prompt (see Anthropic's Agent Skills docs example:
+ * "pdf-processing - Extract text... Use when...").
+ */
+export declare function estimateSkillMetadataTokens(skill: Pick<SkillRecord, "name" | "description">): number;
+export interface TokenStats {
+    /** What every turn would have cost with all catalogued skills/tools loaded as static metadata. */
+    baselineTokens: number;
+    /** What skilljit's fixed tool surface + returned candidates actually cost. */
+    actualTokens: number;
+    /** baselineTokens - actualTokens, floored at 0. */
+    savedTokens: number;
+    /** How many baseline skill/tool metadata entries were counted. */
+    baselineEntries: number;
+    /** Human-readable caveat about the tokenizer used. */
+    method: string;
+}
+/**
+ * Tracks two running totals for one skilljit session:
+ *  - baseline: the metadata cost every catalogued skill/tool WOULD have
+ *    added to every turn, had it been installed the traditional way.
+ *  - actual: the real size of what skilljit actually returned over MCP
+ *    (tool schemas + tool call results), nothing hypothetical.
+ *
+ * `stats()` reports the delta. We only count things that were genuinely
+ * computed here — no invented multipliers — because this is the number
+ * users will screenshot, and the whole pitch is that it's honest.
+ */
+export declare class TokenLedger {
+    private baseline;
+    private actual;
+    private entries;
+    recordBaselineSkill(skill: Pick<SkillRecord, "name" | "description">): void;
+    recordBaselineTool(tool: {
+        name: string;
+        description: string;
+        inputSchema: unknown;
+    }): void;
+    recordActual(label: string, payload: string): void;
+    baselineTokens(): number;
+    actualTokens(): number;
+    stats(): TokenStats;
+    reset(): void;
+}

package/dist/tokens.js

@@ -0,0 +1,73 @@
+import { countTokens as gptCountTokens } from "gpt-tokenizer";
+/**
+ * Token count for a string, via a real BPE tokenizer (gpt-tokenizer's
+ * cl100k encoding). This is an approximation of Claude's own tokenizer —
+ * Anthropic doesn't publish one — but it is a real, auditable count of a
+ * real BPE encoding, not a heuristic like "chars / 4". We say so in every
+ * place this number is surfaced (see TokenLedger.stats()).
+ */
+export function countTokens(text) {
+    if (!text)
+        return 0;
+    return gptCountTokens(text);
+}
+/**
+ * Approximate the per-turn cost of one skill's always-loaded metadata:
+ * its `name` + `description`, formatted the way Claude Code renders it
+ * in the system prompt (see Anthropic's Agent Skills docs example:
+ * "pdf-processing - Extract text... Use when...").
+ */
+export function estimateSkillMetadataTokens(skill) {
+    return countTokens(`${skill.name} - ${skill.description}`);
+}
+/**
+ * Tracks two running totals for one skilljit session:
+ *  - baseline: the metadata cost every catalogued skill/tool WOULD have
+ *    added to every turn, had it been installed the traditional way.
+ *  - actual: the real size of what skilljit actually returned over MCP
+ *    (tool schemas + tool call results), nothing hypothetical.
+ *
+ * `stats()` reports the delta. We only count things that were genuinely
+ * computed here — no invented multipliers — because this is the number
+ * users will screenshot, and the whole pitch is that it's honest.
+ */
+export class TokenLedger {
+    baseline = 0;
+    actual = 0;
+    entries = 0;
+    recordBaselineSkill(skill) {
+        this.baseline += estimateSkillMetadataTokens(skill);
+        this.entries += 1;
+    }
+    recordBaselineTool(tool) {
+        this.baseline += countTokens(`${tool.name} ${tool.description} ${JSON.stringify(tool.inputSchema)}`);
+        this.entries += 1;
+    }
+    recordActual(label, payload) {
+        this.actual += countTokens(payload);
+    }
+    baselineTokens() {
+        return this.baseline;
+    }
+    actualTokens() {
+        return this.actual;
+    }
+    stats() {
+        const saved = Math.max(0, this.baseline - this.actual);
+        return {
+            baselineTokens: this.baseline,
+            actualTokens: this.actual,
+            savedTokens: saved,
+            baselineEntries: this.entries,
+            method: "Counted with gpt-tokenizer (cl100k BPE) as an approximation of Claude's tokenizer; " +
+                "baseline = metadata for every catalogued skill/tool touched this session, actual = " +
+                "what skilljit's fixed tool surface really returned over MCP.",
+        };
+    }
+    reset() {
+        this.baseline = 0;
+        this.actual = 0;
+        this.entries = 0;
+    }
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAG9D;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAgD;IAC1F,OAAO,WAAW,CAAC,GAAG,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7D,CAAC;AAeD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IACd,QAAQ,GAAG,CAAC,CAAC;IACb,MAAM,GAAG,CAAC,CAAC;IACX,OAAO,GAAG,CAAC,CAAC;IAEpB,mBAAmB,CAAC,KAAgD;QAClE,IAAI,CAAC,QAAQ,IAAI,2BAA2B,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,kBAAkB,CAAC,IAAiE;QAClF,IAAI,CAAC,QAAQ,IAAI,WAAW,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrG,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,YAAY,CAAC,KAAa,EAAE,OAAe;QACzC,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,QAAQ;YAC7B,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,WAAW,EAAE,KAAK;YAClB,eAAe,EAAE,IAAI,CAAC,OAAO;YAC7B,MAAM,EACJ,qFAAqF;gBACrF,qFAAqF;gBACrF,8DAA8D;SACjE,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACnB,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+/** A single skill record as stored in the local catalog. */
+export interface SkillRecord {
+    /** Stable unique id, e.g. "vercel-labs/agent-skills/pdf-processing". */
+    id: string;
+    /** Short name from SKILL.md frontmatter, e.g. "pdf-processing". */
+    name: string;
+    /** Where this skill came from, e.g. "github:vercel-labs/agent-skills". */
+    source: string;
+    /** The `description` field from SKILL.md frontmatter. */
+    description: string;
+    /** Full SKILL.md body (Level 2 content), loaded lazily by consumers. */
+    body: string;
+    /** Optional install-count / popularity signal from the upstream registry. */
+    installCount?: number;
+    /** Audit status surfaced by the upstream registry, if any. */
+    auditStatus?: "pass" | "warn" | "fail" | "unaudited";
+    /** ISO timestamp of when this record was last refreshed. */
+    updatedAt: string;
+}
+/** A search hit: a skill plus its relevance rank (lower = more relevant). */
+export interface SkillSearchHit {
+    skill: Omit<SkillRecord, "body">;
+    rank: number;
+}
+/** An MCP upstream tool schema as cataloged for tool_find/tool_call routing. */
+export interface ToolRecord {
+    id: string;
+    server: string;
+    name: string;
+    description: string;
+    inputSchema: unknown;
+    updatedAt: string;
+}
+export interface ToolSearchHit {
+    tool: ToolRecord;
+    rank: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@skilljit/core",
+  "version": "0.1.0",
+  "description": "Local catalog, full-text search, and token accounting for skilljit",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "better-sqlite3": "^13.0.3",
+    "gpt-tokenizer": "^4.0.0",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.11"
+  }
+}