@aijadugar/skyboy-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skyboy project contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/agent-context.d.ts

@@ -0,0 +1,9 @@
+export interface AgentContext {
+    agent: string;
+    targetDir: string;
+    guideSlug: string;
+}
+export declare function detectAgentContext(cwd: string): AgentContext | null;
+export declare const DEFAULT_TARGET_DIR = ".claude/skills";
+export declare function safeSkillFolderName(slug: string): string;
+//# sourceMappingURL=agent-context.d.ts.map

package/dist/agent-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AA2CD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAQnE;AAKD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAInD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/dist/agent-context.js

@@ -0,0 +1,66 @@
+// Detect the calling agent context so the CLI can pick a sensible target folder
+// without a prompt. Scans the working directory for the well-known agent folders
+// the ecosystem has converged on. Returns null when nothing is detected (caller
+// prompts or falls back to a default).
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+// The 8 agent targets the CLI autodetects. Note this is the CLI's own table
+// (the site's SUPPORTED_AGENTS is a superset for display); keep the targetDir
+// paths aligned with the install guides.
+const CONTEXTS = [
+    {
+        agent: "Claude Code",
+        guideSlug: "claude-code",
+        probe: (cwd) => (existsSync(join(cwd, ".claude", "skills")) ? ".claude/skills" : existsSync(join(cwd, ".claude")) ? ".claude" : null),
+    },
+    {
+        agent: "Cursor",
+        guideSlug: "cursor",
+        probe: (cwd) => (existsSync(join(cwd, ".cursor", "rules")) ? ".cursor/rules" : existsSync(join(cwd, ".cursor")) ? ".cursor" : null),
+    },
+    {
+        agent: "Windsurf",
+        guideSlug: "windsurf",
+        probe: (cwd) => (existsSync(join(cwd, ".windsurf", "skills")) ? ".windsurf/skills" : null),
+    },
+    {
+        agent: "Claude Desktop",
+        guideSlug: "claude-desktop",
+        probe: (cwd) => (existsSync(join(cwd, ".claude", "skills")) ? ".claude/skills" : null),
+    },
+    {
+        agent: "Codex CLI",
+        guideSlug: "codex-cli",
+        probe: (cwd) => (existsSync(join(cwd, ".codex")) ? ".codex" : null),
+    },
+    {
+        agent: "Gemini CLI",
+        guideSlug: "gemini-cli",
+        probe: (cwd) => (existsSync(join(cwd, ".gemini", "skills")) ? ".gemini/skills" : null),
+    },
+    {
+        agent: "MCP",
+        guideSlug: "mcp",
+        probe: (cwd) => (existsSync(join(cwd, ".mcp")) ? ".mcp" : null),
+    },
+];
+export function detectAgentContext(cwd) {
+    for (const ctx of CONTEXTS) {
+        const targetDir = ctx.probe(cwd);
+        if (targetDir) {
+            return { agent: ctx.agent, targetDir, guideSlug: ctx.guideSlug };
+        }
+    }
+    return null;
+}
+// The default target folder when no agent context is detected and the caller
+// chooses not to prompt. `.claude/skills` is the safest default because that is
+// where the most install-guide traffic points.
+export const DEFAULT_TARGET_DIR = ".claude/skills";
+// Derive the skill's local destination folder name. Most agents want the slug
+// usable as a bare folder under the target; a guard against `../` injection.
+export function safeSkillFolderName(slug) {
+    const name = slug.replace(/[^a-zA-Z0-9._-]/g, "-");
+    return name === "" ? "skill" : name;
+}
+//# sourceMappingURL=agent-context.js.map

package/dist/agent-context.js.map

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

package/dist/catalog.d.ts

@@ -0,0 +1,31 @@
+import type { CatalogManifest, SkillRecord, PluginRecord, Agent, SkillMetaShard } from "./types.js";
+export interface LoadOptions {
+    manifestUrl?: string;
+    cwd?: string;
+}
+export declare class Catalog {
+    private manifest;
+    private byId;
+    constructor(manifest: CatalogManifest);
+    static create(manifest: CatalogManifest): Catalog;
+    get skills(): SkillRecord[];
+    get plugins(): PluginRecord[];
+    get categories(): string[];
+    get agents(): Agent[];
+    get generatedAt(): string;
+    get version(): number;
+    getSkill(id: string): SkillRecord | undefined;
+    getPlugin(slug: string): PluginRecord | undefined;
+    getAllTags(): string[];
+    getFeaturedSkills(): SkillRecord[];
+    resolve(id: string): SkillRecord | undefined;
+    search(query: string, opts?: {
+        category?: string;
+        agent?: string;
+        limit?: number;
+    }): SkillRecord[];
+    badge(skill: SkillRecord): import("./types.js").Badge;
+    name(skill: SkillRecord): string;
+    fetchMeta(skill: SkillRecord): Promise<SkillMetaShard>;
+}
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKpG,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,IAAI,CAA2B;gBAE3B,QAAQ,EAAE,eAAe;IAKrC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO;IAIjD,IAAI,MAAM,IAAI,WAAW,EAAE,CAE1B;IAED,IAAI,OAAO,IAAI,YAAY,EAAE,CAE5B;IAED,IAAI,UAAU,IAAI,MAAM,EAAE,CAEzB;IAED,IAAI,MAAM,IAAI,KAAK,EAAE,CAEpB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIjD,UAAU,IAAI,MAAM,EAAE;IAMtB,iBAAiB,IAAI,WAAW,EAAE;IAiBlC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW,EAAE;IAKlG,KAAK,CAAC,KAAK,EAAE,WAAW;IAKxB,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAO1B,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;CAO7D"}

package/dist/catalog.js

@@ -0,0 +1,91 @@
+// The Catalog class. Holds one in-memory copy of the manifest and exposes the
+// same read surface the site exposes via lib/catalog.ts, plus the lookups the
+// CLI and MCP tools need. Pure data, no Next imports, no filesystem coupling
+// beyond what the caller passes in.
+import { skillSlug, badgeFor, skillMetaUrl } from "./types.js";
+import { resolveSlug } from "./resolve.js";
+import { searchSkills } from "./search.js";
+export class Catalog {
+    manifest;
+    byId;
+    constructor(manifest) {
+        this.manifest = manifest;
+        this.byId = new Map(manifest.skills.map((s) => [s.id, s]));
+    }
+    static create(manifest) {
+        return new Catalog(manifest);
+    }
+    get skills() {
+        return this.manifest.skills;
+    }
+    get plugins() {
+        return this.manifest.plugins;
+    }
+    get categories() {
+        return this.manifest.categories;
+    }
+    get agents() {
+        return this.manifest.agents;
+    }
+    get generatedAt() {
+        return this.manifest.generatedAt;
+    }
+    get version() {
+        return this.manifest.version;
+    }
+    getSkill(id) {
+        return this.byId.get(id);
+    }
+    getPlugin(slug) {
+        return this.manifest.plugins.find((p) => p.slug === slug);
+    }
+    getAllTags() {
+        const set = new Set();
+        for (const s of this.manifest.skills)
+            for (const t of s.t)
+                set.add(t);
+        return [...set].sort();
+    }
+    getFeaturedSkills() {
+        const order = [
+            "nextjs-app-router-conventions",
+            "anti-slop-landing",
+            "context-window-management",
+            "copy-self-audit",
+        ];
+        const found = [];
+        for (const slug of order) {
+            const hit = this.byId.get(slug);
+            if (hit)
+                found.push(hit);
+        }
+        return found;
+    }
+    // Resolve a slug or scoped id: exact first, then fuzzy. Returns the closest
+    // match or undefined.
+    resolve(id) {
+        return resolveSlug(this.manifest.skills, id);
+    }
+    search(query, opts) {
+        return searchSkills(this.manifest.skills, query, opts);
+    }
+    // Derived badge from origin + verified (spec §4). Never stored in the record.
+    badge(skill) {
+        return badgeFor(skill);
+    }
+    // The human-facing name of a record is its slug: one name, ever (spec §1).
+    name(skill) {
+        return skillSlug(skill);
+    }
+    // Fetch the per-skill meta.json shard for full detail (license, author,
+    // permissions, upstream repo). Network-only: the index deliberately omits
+    // these fields, so consumers get them on demand (spec §6).
+    async fetchMeta(skill) {
+        const res = await fetch(skillMetaUrl(skill));
+        if (!res.ok) {
+            throw new Error(`skyboy: failed to fetch meta for ${skill.id} (HTTP ${res.status})`);
+        }
+        return (await res.json());
+    }
+}
+//# 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,14 @@
+export type { Origin, Badge, Permissions, SkillRecord, SkillMetaShard, PluginSkillRef, PluginRecord, Agent, CatalogManifest, } from "./types.js";
+export { RAW_BASE, REPO, API_BASE, GITHUB_BLAME, skillMarkdownUrl, skillMetaUrl, skillSlotUrl, skillSlug, skillOwner, badgeFor, } from "./types.js";
+export { resolveManifestUrl, findUpCatalog, fetchCatalog, DEFAULT_MANIFEST_URL, } from "./manifest.js";
+export { Catalog } from "./catalog.js";
+export type { LoadOptions } from "./catalog.js";
+export { resolve, resolveSlug, } from "./resolve.js";
+export type { ResolveResult } from "./resolve.js";
+export { searchSkills, score as scoreSkill } from "./search.js";
+export type { SearchOptions } from "./search.js";
+export { detectAgentContext, DEFAULT_TARGET_DIR, safeSkillFolderName, } from "./agent-context.js";
+export type { AgentContext } from "./agent-context.js";
+export { installSkill, skillFolder, targetExists, isSafeSlug, installDirName, } from "./install.js";
+export type { InstallResult } from "./install.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,MAAM,EACN,KAAK,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,YAAY,EACZ,KAAK,EACL,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EACV,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EACL,OAAO,EACP,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// @skyboy/core - shared catalog + install logic for the skyboy CLI and MCP server.
+// The site reads skills/ directly at build time; these standalone packages must
+// not, so they consume the committed catalog.json via the manifest loader.
+export { RAW_BASE, REPO, API_BASE, GITHUB_BLAME, skillMarkdownUrl, skillMetaUrl, skillSlotUrl, skillSlug, skillOwner, badgeFor, } from "./types.js";
+export { resolveManifestUrl, findUpCatalog, fetchCatalog, DEFAULT_MANIFEST_URL, } from "./manifest.js";
+export { Catalog } from "./catalog.js";
+export { resolve, resolveSlug, } from "./resolve.js";
+export { searchSkills, score as scoreSkill } from "./search.js";
+export { detectAgentContext, DEFAULT_TARGET_DIR, safeSkillFolderName, } from "./agent-context.js";
+export { installSkill, skillFolder, targetExists, isSafeSlug, installDirName, } from "./install.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,mFAAmF;AACnF,gFAAgF;AAChF,2EAA2E;AAc3E,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EACV,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAIvC,OAAO,EACL,OAAO,EACP,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,cAAc,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,16 @@
+import type { SkillRecord } from "./types.js";
+export declare function skillFolder(skill: SkillRecord): string;
+export interface InstallResult {
+    slug: string;
+    destDir: string;
+    filesWritten: number;
+    sourceUrl: string;
+    node: "file" | "dir";
+}
+export declare function installSkill(skill: SkillRecord, targetRoot: string, opts?: {
+    cwd?: string;
+}): Promise<InstallResult>;
+export declare function targetExists(cwd: string, targetDir: string): boolean;
+export declare function isSafeSlug(slug: string): boolean;
+export declare function installDirName(id: string): string;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkC9C,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAItD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;CACtB;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACtB,OAAO,CAAC,aAAa,CAAC,CAyCxB;AAGD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEpE;AAKD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhD;AAGD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/install.js

@@ -0,0 +1,94 @@
+// Install a skill into a target folder. Fetches just that skill's folder via the
+// GitHub contents API (enumerate files recursively) then pulls each file from the
+// raw URL, mirroring the degit snippet in the brief sans the git history. This is
+// the "download just that skill folder" step shared by the CLI and the stdio MCP
+// `install_skill` tool.
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { API_BASE, RAW_BASE, GITHUB_BLAME } from "./types.js";
+import { skillSlug } from "./types.js";
+import { safeSkillFolderName } from "./agent-context.js";
+async function listDir(apiPath) {
+    const res = await fetch(`${API_BASE}/${apiPath}`, {
+        headers: { Accept: "application/vnd.github+json", "User-Agent": "skyboy" },
+    });
+    if (!res.ok) {
+        throw new Error(`skyboy: failed to list skill files (HTTP ${res.status}) at ${apiPath}`);
+    }
+    const data = (await res.json());
+    if (Array.isArray(data))
+        return data;
+    throw new Error(`skyboy: listing ${apiPath} failed: ${data.message}`);
+}
+async function fetchFile(url) {
+    const res = await fetch(url, { headers: { "User-Agent": "skyboy" } });
+    if (!res.ok) {
+        throw new Error(`skyboy: failed to fetch ${url} (HTTP ${res.status})`);
+    }
+    return Buffer.from(await res.arrayBuffer());
+}
+// Resolve the repo-relative folder for a skill. Uses the manifest `p` field
+// (`skills/<category>/[<owner>/]<slug>`); falls back to the API search if a
+// consumer only has an id and a category string.
+export function skillFolder(skill) {
+    if (skill.p)
+        return skill.p;
+    // No path in the record: derive from the raw API tree by slug match.
+    return `skills/${skill.c.split("/")[0]}/${skillSlug(skill)}`;
+}
+export async function installSkill(skill, targetRoot, opts) {
+    const base = opts?.cwd ?? process.cwd();
+    const destDir = join(base, targetRoot, safeSkillFolderName(skillSlug(skill)));
+    const folder = skillFolder(skill);
+    // Enumerate the folder recursively.
+    const entries = [];
+    const queue = [folder];
+    while (queue.length > 0) {
+        const dir = queue.shift();
+        const children = await listDir(dir);
+        for (const child of children) {
+            if (child.type === "dir")
+                queue.push(child.path);
+            else
+                entries.push(child);
+        }
+    }
+    if (entries.length === 0) {
+        throw new Error(`skyboy: no files found for skill ${skill.id} in ${folder}`);
+    }
+    mkdirSync(destDir, { recursive: true });
+    // Download and write each file under the skill folder. The generated
+    // meta.json shard ships in the repo, so it lands in the install too; that is
+    // fine, it is small and documents the skill's own metadata.
+    let filesWritten = 0;
+    for (const entry of entries) {
+        const local = join(destDir, entry.path.slice(folder.length + 1));
+        mkdirSync(dirname(local), { recursive: true });
+        const buf = await fetchFile(`${RAW_BASE}/${entry.path}`);
+        writeFileSync(local, buf);
+        filesWritten += 1;
+    }
+    return {
+        slug: skillSlug(skill),
+        destDir,
+        filesWritten,
+        sourceUrl: `${GITHUB_BLAME}/${folder}/SKILL.md`,
+        node: "dir",
+    };
+}
+// Check whether a target root exists (used by the CLI to decide prompt vs write).
+export function targetExists(cwd, targetDir) {
+    return existsSync(join(cwd, targetDir));
+}
+// Lightweight guard so an id can never produce a path that escapes the target.
+// Accepts scoped ids (@owner/slug): the owner segment never reaches the
+// filesystem path anyway, only the slug part becomes the folder name.
+export function isSafeSlug(slug) {
+    const bare = slug.startsWith("@") ? slug.slice(slug.indexOf("/") + 1) : slug;
+    return !bare.includes("/") && !bare.includes("\\") && bare !== ".." && bare !== ".";
+}
+// Derive a plain install directory name without fetching anything.
+export function installDirName(id) {
+    return safeSkillFolderName(skillSlug({ id }));
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,6 @@
+import type { CatalogManifest } from "./types.js";
+export declare const DEFAULT_MANIFEST_URL = "https://raw.githubusercontent.com/aijadugar/skyboy/main/catalog.json";
+export declare function resolveManifestUrl(cwd: string, explicitUrl?: string): string;
+export declare function findUpCatalog(start: string): string | null;
+export declare function fetchCatalog(src: string): Promise<CatalogManifest>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,oBAAoB,yEAA6B,CAAC;AAO/D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5E;AAMD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS1D;AAMD,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAaxE"}

package/dist/manifest.js

@@ -0,0 +1,53 @@
+// Fetch the shared catalog manifest. The CLI and MCP run in arbitrary user
+// projects with no local checkout of the repo, so they pull catalog.json from
+// the GitHub raw URL. A local file path or a local catalog.json is honoured for
+// dev/offline (e.g. a checkout of this repo).
+import { existsSync, readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { RAW_BASE } from "./types.js";
+export const DEFAULT_MANIFEST_URL = `${RAW_BASE}/catalog.json`;
+// Resolution order for the manifest source:
+//   1. explicit URL passed by the caller
+//   2. a local catalog.json, found by walking up from cwd (a checkout of this
+//      repo, or a vendored copy)
+//   3. the default raw.githubusercontent URL
+export function resolveManifestUrl(cwd, explicitUrl) {
+    if (explicitUrl)
+        return explicitUrl;
+    const local = findUpCatalog(cwd);
+    if (local)
+        return local;
+    return DEFAULT_MANIFEST_URL;
+}
+// Walk up from cwd looking for a committed catalog.json. This lets the hosted
+// route, CLI, and MCP all resolve the repo-root manifest during local dev even
+// when they run from a nested dir (e.g. apps/web), while still falling back to
+// the network for a clean, non-repo install.
+export function findUpCatalog(start) {
+    let dir = start;
+    for (;;) {
+        const candidate = join(dir, "catalog.json");
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+function isLocalPath(src) {
+    return src.startsWith(".") || src.startsWith("/") || /^[a-zA-Z]:[\\/]/.test(src) || src.startsWith("file:");
+}
+export async function fetchCatalog(src) {
+    if (isLocalPath(src)) {
+        const p = src.startsWith("file:") ? src.replace(/^file:/, "") : src;
+        return JSON.parse(readFileSync(p, "utf8"));
+    }
+    const res = await fetch(src, { headers: { "Cache-Control": "no-cache" } });
+    if (!res.ok) {
+        throw new Error(`skyboy: failed to fetch catalog from ${src} (HTTP ${res.status}). ` +
+            `Check your network, or run with a local catalog.json present.`);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,8EAA8E;AAC9E,gFAAgF;AAChF,8CAA8C;AAE9C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,QAAQ,eAAe,CAAC;AAE/D,4CAA4C;AAC5C,yCAAyC;AACzC,8EAA8E;AAC9E,iCAAiC;AACjC,6CAA6C;AAC7C,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,WAAoB;IAClE,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,6CAA6C;AAC7C,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC5C,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAC9G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW;IAC5C,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACpE,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAoB,CAAC;IAChE,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,wCAAwC,GAAG,UAAU,GAAG,CAAC,MAAM,KAAK;YAClE,+DAA+D,CAClE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoB,CAAC;AAC/C,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,9 @@
+import type { SkillRecord } from "./types.js";
+export interface ResolveResult {
+    slug: string;
+    score: number;
+    exact: boolean;
+}
+export declare function resolve(target: string, skills: SkillRecord[]): ResolveResult | null;
+export declare function resolveSlug(skills: SkillRecord[], target: string): SkillRecord | undefined;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA+C9C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,aAAa,GAAG,IAAI,CA2BnF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAG1F"}

package/dist/resolve.js

@@ -0,0 +1,75 @@
+// Slug resolution over compact v2 records: exact match first, then a simple,
+// dependency-free fuzzy match. We compare against the id and the slug (and
+// fall back to the path). No Levenshtein dependency; a containment +
+// prefix/token heuristic is enough and keeps the core dependency-free.
+import { skillSlug } from "./types.js";
+function norm(s) {
+    return s.toLowerCase().replace(/[^a-z0-9@/]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function similarity(a, b) {
+    if (a === b)
+        return 1;
+    if (b.length === 0 || a.length === 0)
+        return 0;
+    let best = 0;
+    // A query that is a whole leading segment of the other string is a strong hit:
+    // "nextjs" should match "nextjs-app-router-conventions". This is the common
+    // case users type, so weight it above a generic overlap.
+    if (a.length > 0 && (b.startsWith(a + "-") || b.startsWith(a + ".") || b.startsWith(a + "/"))) {
+        best = Math.max(best, 0.72);
+    }
+    if (b.length > 0 && (a.startsWith(b + "-") || a.startsWith(b + ".") || a.startsWith(b + "/"))) {
+        best = Math.max(best, 0.72);
+    }
+    // containment: is one a prefix/substring of the other?
+    if (a.includes(b) || b.includes(a)) {
+        best = Math.max(best, Math.min(a.length, b.length) / Math.max(a.length, b.length));
+    }
+    // token overlap across -_./ boundaries (always scored, since a partial segment
+    // substring match like "app-router" in "nextjs-app-router-conventions" is a
+    // strong signal that the containment score underweights). A full-token hit in
+    // a short query scores high because the query is a meaningful fragment.
+    const ta = a.split(/[-_./]+/).filter(Boolean);
+    const tb = b.split(/[-_./]+/).filter(Boolean);
+    let hits = 0;
+    for (const tok of ta)
+        if (tb.includes(tok))
+            hits++;
+    const tokenScore = hits / Math.max(ta.length, tb.length, 1);
+    best = Math.max(best, tokenScore);
+    // If every query token appears as a real token in the target, that is a strong
+    // signal even when the target is much longer (a fragment match).
+    if (hits === ta.length && ta.length > 0) {
+        best = Math.max(best, 0.68);
+    }
+    return best;
+}
+export function resolve(target, skills) {
+    const t = norm(target);
+    if (!t)
+        return null;
+    // Exact on id wins immediately; an exact bare-slug match also resolves (the
+    // bare form is the common way users type a skyboy skill).
+    for (const s of skills) {
+        if (norm(s.id) === t || norm(skillSlug(s)) === t) {
+            return { slug: s.id, score: 1, exact: true };
+        }
+    }
+    let best = null;
+    for (const s of skills) {
+        const score = Math.max(similarity(t, norm(s.id)), similarity(t, norm(skillSlug(s))), similarity(t, norm(s.c)));
+        if (score > 0 && (!best || score > best.score)) {
+            best = { slug: s.id, score, exact: false };
+        }
+    }
+    // Only return a fuzzy hit above a low sanity bar so we don't silently grab an
+    // unrelated skill on a typo.
+    if (best && best.score >= 0.4)
+        return best;
+    return null;
+}
+export function resolveSlug(skills, target) {
+    const r = resolve(target, skills);
+    return r ? skills.find((s) => s.id === r.slug) : undefined;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,9 @@
+import type { SkillRecord } from "./types.js";
+export interface SearchOptions {
+    category?: string;
+    agent?: string;
+    limit?: number;
+}
+export declare function score(query: string, skill: SkillRecord): number;
+export declare function searchSkills(skills: SkillRecord[], query: string, opts?: SearchOptions): SkillRecord[];
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAsB/D;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,aAAa,GACnB,WAAW,EAAE,CAqBf"}

package/dist/search.js

@@ -0,0 +1,61 @@
+// Fuzzy search over the compact v2 catalog records. Mirrors the ranking a
+// search bar would do, but dependency-free: token-overlap scoring over id,
+// description, and tags, optionally filtered by category and compatible agent.
+import { skillSlug } from "./types.js";
+function norm(s) {
+    return s.toLowerCase();
+}
+function tokenOverlap(qTokens, hayTokens) {
+    if (qTokens.length === 0)
+        return 0;
+    let hits = 0;
+    for (const q of qTokens) {
+        if (hayTokens.some((h) => h.includes(q)))
+            hits += 1;
+    }
+    return hits / qTokens.length;
+}
+export function score(query, skill) {
+    const q = norm(query);
+    if (!q)
+        return 0;
+    const qTokens = q.split(/[^a-z0-9]+/).filter(Boolean);
+    const id = norm(skill.id);
+    const slug = norm(skillSlug(skill));
+    // Exact id / slug prefix is the strongest signal. The scoped id scores
+    // slightly above the bare slug so "@vercel/nextjs" beats a slug-only match.
+    if (id === q)
+        return 1.0;
+    if (slug === q)
+        return 0.97;
+    if (id.startsWith(q))
+        return 0.92;
+    if (slug.startsWith(q))
+        return 0.88;
+    let best = 0;
+    best = Math.max(best, tokenOverlap(qTokens, id.split(/[^a-z0-9]+/).filter(Boolean)));
+    best = Math.max(best, tokenOverlap(qTokens, skill.d.split(/[^a-z0-9]+/).filter(Boolean)));
+    for (const t of skill.t) {
+        best = Math.max(best, tokenOverlap(qTokens, t.split(/[^a-z0-9]+/).filter(Boolean)));
+    }
+    return best;
+}
+export function searchSkills(skills, query, opts) {
+    const q = (query ?? "").trim();
+    let pool = skills;
+    if (opts?.category)
+        pool = pool.filter((s) => s.c === opts.category);
+    if (opts?.agent) {
+        pool = pool.filter((s) => s.a.some((a) => norm(a) === norm(opts.agent) || norm(a).includes(norm(opts.agent))));
+    }
+    // Empty query: return the pool as-is (a bare tool call lists the catalog).
+    if (!q)
+        return pool;
+    const scored = pool
+        .map((s) => ({ s, score: score(q, s) }))
+        .filter((r) => r.score > 0)
+        .sort((a, b) => b.score - a.score || a.s.id.localeCompare(b.s.id));
+    const limit = opts?.limit ?? 50;
+    return scored.slice(0, limit).map((r) => r.s);
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,95 @@
+export type Origin = "skyboy" | "vendor" | "community";
+export type Badge = "official" | "vendor" | "verified" | "community";
+export interface SkillRecord {
+    id: string;
+    d: string;
+    c: string;
+    t: string[];
+    a: string[];
+    v: string;
+    h: string;
+    o: Origin;
+    y: boolean;
+    p: string;
+}
+export declare function skillSlug(record: Pick<SkillRecord, "id">): string;
+export declare function skillOwner(record: Pick<SkillRecord, "id">): string | null;
+export declare function badgeFor(record: Pick<SkillRecord, "o" | "y">): Badge;
+export interface Permissions {
+    network: boolean;
+    filesystem_write_outside_target: boolean;
+    shell_exec: boolean;
+    env_read: string[];
+}
+export interface SkillMetaShard {
+    id: string;
+    slug: string;
+    description: string;
+    category: string;
+    tags: string[];
+    compatible_agents: string[];
+    version: string;
+    license: string;
+    author: string;
+    origin: Origin;
+    verified: boolean;
+    upstream_repo: string | null;
+    canonical_of: string | null;
+    permissions: Permissions | null;
+    frontmatter: {
+        name: string | null;
+        license: string | null;
+    };
+    hash: string;
+    path: string;
+    skill_md_url: string;
+}
+export interface PluginSkillRef {
+    name: string;
+    description: string;
+    path: string;
+    url: string;
+}
+export interface PluginRecord {
+    slug: string;
+    name: string;
+    vendor: string;
+    vendorUrl?: string;
+    sourceType: "vendor";
+    origin: Origin;
+    category: string;
+    tags: string[];
+    license: string;
+    upstreamRepo: string;
+    install: string;
+    description: string;
+    compatibleAgents: string[];
+    skills: PluginSkillRef[];
+    commands: string[];
+    agents: string[];
+    mcp: string | null;
+    note: string;
+    badge: Badge;
+    version?: string;
+    path: string;
+}
+export interface Agent {
+    name: string;
+    note: string;
+}
+export interface CatalogManifest {
+    generatedAt: string;
+    version: number;
+    categories: string[];
+    agents: Agent[];
+    skills: SkillRecord[];
+    plugins: PluginRecord[];
+}
+export declare const REPO = "aijadugar/skyboy";
+export declare const RAW_BASE = "https://raw.githubusercontent.com/aijadugar/skyboy/main";
+export declare const API_BASE = "https://api.github.com/repos/aijadugar/skyboy/contents";
+export declare const GITHUB_BLAME = "https://github.com/aijadugar/skyboy/blob/main";
+export declare function skillMarkdownUrl(skill: Pick<SkillRecord, "p">): string;
+export declare function skillMetaUrl(skill: Pick<SkillRecord, "p">): string;
+export declare function skillSlotUrl(skill: Pick<SkillRecord, "p">): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,36 @@
+// Shared catalog types for the standalone CLI + MCP server. These mirror the
+// compact v2 record shape emitted by scripts/export-catalog.ts into catalog.json
+// (docs/skill-spec.md §6). They are kept dependency-free (no Node types beyond
+// the runtime globals) so the core is consumable from both the npm packages
+// and, via the thin wrapper, PyPI.
+// Derived views so consumers never re-derive these by hand.
+export function skillSlug(record) {
+    return record.id.includes("/") ? record.id.slice(record.id.indexOf("/") + 1) : record.id;
+}
+export function skillOwner(record) {
+    return record.id.startsWith("@") ? record.id.slice(1, record.id.indexOf("/")) : null;
+}
+export function badgeFor(record) {
+    if (record.o === "skyboy")
+        return "official";
+    if (record.o === "vendor")
+        return "vendor";
+    return record.y ? "verified" : "community";
+}
+// The GitHub raw base for the skill catalog. The repo is the source of truth;
+// the manifest's `p` fields turn into raw URLs under this base.
+export const REPO = "aijadugar/skyboy";
+export const RAW_BASE = `https://raw.githubusercontent.com/${REPO}/main`;
+export const API_BASE = `https://api.github.com/repos/${REPO}/contents`;
+export const GITHUB_BLAME = `https://github.com/${REPO}/blob/main`;
+// A skill's SKILL.md raw URL (used for preview / one-off fetch).
+export function skillMarkdownUrl(skill) {
+    return `${RAW_BASE}/${skill.p}/SKILL.md`;
+}
+export function skillMetaUrl(skill) {
+    return `${RAW_BASE}/${skill.p}/meta.json`;
+}
+export function skillSlotUrl(skill) {
+    return `${RAW_BASE}/${skill.p}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,iFAAiF;AACjF,+EAA+E;AAC/E,4EAA4E;AAC5E,mCAAmC;AAwBnC,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CAAC,MAA+B;IACvD,OAAO,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA+B;IACxD,OAAO,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAoC;IAC3D,IAAI,MAAM,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC;IAC7C,IAAI,MAAM,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC3C,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;AAC7C,CAAC;AA6ED,8EAA8E;AAC9E,gEAAgE;AAChE,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,CAAC;AACvC,MAAM,CAAC,MAAM,QAAQ,GAAG,qCAAqC,IAAI,OAAO,CAAC;AACzE,MAAM,CAAC,MAAM,QAAQ,GAAG,gCAAgC,IAAI,WAAW,CAAC;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG,sBAAsB,IAAI,YAAY,CAAC;AAEnE,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,KAA6B;IAC5D,OAAO,GAAG,QAAQ,IAAI,KAAK,CAAC,CAAC,WAAW,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA6B;IACxD,OAAO,GAAG,QAAQ,IAAI,KAAK,CAAC,CAAC,YAAY,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA6B;IACxD,OAAO,GAAG,QAAQ,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@aijadugar/skyboy-core",
+  "version": "0.1.0",
+  "description": "Shared catalog + install logic for the skyboy CLI and MCP server.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "LICENSE"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@types/node": "^22.10.0"
+  }
+}