skillset 0.0.1

package/dist/types/cache/index.d.ts

@@ -0,0 +1,9 @@
+import type { CacheSchema, Skill } from "../types";
+export declare const CACHE_PATHS: {
+    project: string;
+    user: string;
+};
+export declare function loadCaches(): CacheSchema;
+export declare function writeCacheSync(path: string, cache: CacheSchema): void;
+export declare function updateCacheSync(target: "project" | "user", updater: (cache: CacheSchema) => CacheSchema): void;
+export declare function isStructureFresh(skill: Skill, ttlSeconds: number): boolean;

package/dist/types/cli.d.ts

@@ -0,0 +1 @@
+export declare function buildCli(): void;

package/dist/types/config/index.d.ts

@@ -0,0 +1,29 @@
+import type { ConfigSchema, Mode } from "../types";
+export declare const CONFIG_PATHS: {
+    project: string;
+    projectLocal: string;
+    user: string;
+};
+export declare function loadConfig(): ConfigSchema;
+export declare function ensureConfigFiles(): void;
+export declare function modeLabel(mode: Mode): "warn" | "strict";
+/**
+ * Write config to a specific file
+ */
+export declare function writeConfig(scope: "project" | "local" | "user", config: Partial<ConfigSchema>): void;
+/**
+ * Read config from a specific scope
+ */
+export declare function readConfigByScope(scope: "project" | "local" | "user"): Partial<ConfigSchema>;
+/**
+ * Get path for a specific config scope
+ */
+export declare function getConfigPath(scope: "project" | "local" | "user"): string;
+/**
+ * Get a config value using dot notation
+ */
+export declare function getConfigValue(config: ConfigSchema, key: string): unknown | undefined;
+/**
+ * Set a config value using dot notation
+ */
+export declare function setConfigValue(config: Partial<ConfigSchema>, key: string, value: unknown): Partial<ConfigSchema>;

package/dist/types/doctor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Run full diagnostic check
+ */
+export declare function runFullDiagnostic(): void;
+/**
+ * Run config-specific diagnostic
+ */
+export declare function runConfigDiagnostic(): void;
+/**
+ * Run skill-specific diagnostic
+ */
+export declare function runSkillDiagnostic(skillAlias: string): Promise<void>;

package/dist/types/format/index.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigSchema, InjectOutcome, ResolveResult } from "../types";
+export declare function stripFrontmatter(text: string): string;
+export declare function formatOutcome(results: ResolveResult[], config: ConfigSchema): InjectOutcome;

package/dist/types/hook.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/hooks/hook-runner.d.ts

@@ -0,0 +1 @@
+export declare function runUserPromptSubmitHook(stdin: string): Promise<string>;

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/types/indexer/index.d.ts

@@ -0,0 +1,6 @@
+import type { CacheSchema } from "../types";
+interface ScanOptions {
+    projectRoot?: string;
+}
+export declare function indexSkills(options?: ScanOptions): CacheSchema;
+export {};

package/dist/types/logger/index.d.ts

@@ -0,0 +1,2 @@
+import type { ResolveResult } from "../types";
+export declare function logResults(results: ResolveResult[]): void;

package/dist/types/resolver/index.d.ts

@@ -0,0 +1,3 @@
+import type { CacheSchema, ConfigSchema, InvocationToken, ResolveResult } from "../types";
+export declare function resolveToken(token: InvocationToken, config?: ConfigSchema, cache?: CacheSchema): ResolveResult;
+export declare function resolveTokens(tokens: InvocationToken[], config?: ConfigSchema, cache?: CacheSchema): ResolveResult[];

package/dist/types/tokenizer/index.d.ts

@@ -0,0 +1,2 @@
+import type { InvocationToken } from "../types";
+export declare function tokenizePrompt(prompt: string): InvocationToken[];

package/dist/types/tree/index.d.ts

@@ -0,0 +1,24 @@
+import type { CacheSchema, Skill } from "../types";
+export { parseMarkdownHeadings, headingsToTreeObject } from "./markdown";
+interface TreeOptions {
+    /** Include markdown heading structure for SKILL.md files */
+    includeMarkdown?: boolean;
+    /** Maximum depth to recurse */
+    maxDepth?: number;
+}
+/**
+ * Build a tree for a single skill, showing its directory + SKILL.md headings.
+ */
+export declare function buildSkillTree(skill: Skill, options?: TreeOptions): Promise<string>;
+/**
+ * Build a tree for a namespace, showing all skills in that namespace.
+ */
+export declare function buildNamespaceTree(namespace: string, cache: CacheSchema, options?: TreeOptions): Promise<string>;
+/**
+ * Build a tree from a direct path (directory or SKILL.md file).
+ */
+export declare function buildPathTree(path: string, options?: TreeOptions): Promise<string>;
+/**
+ * Determine if input is a namespace reference.
+ */
+export declare function isNamespaceRef(input: string): boolean;

package/dist/types/tree/markdown.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Parse markdown content and extract heading structure.
+ * Only used for SKILL.md files.
+ */
+export interface HeadingNode {
+    level: number;
+    text: string;
+    children: HeadingNode[];
+}
+/**
+ * Parse markdown content into a heading tree structure.
+ * Only captures ## and ### headings (ignores # as that's usually the title).
+ */
+export declare function parseMarkdownHeadings(content: string): HeadingNode[];
+/**
+ * Convert heading tree to object-treeify compatible format.
+ */
+export declare function headingsToTreeObject(headings: HeadingNode[]): Record<string, unknown>;

package/dist/types/types.d.ts

@@ -0,0 +1,43 @@
+export type Mode = "warn" | "strict";
+export interface Skill {
+    skillRef: string;
+    path: string;
+    name: string;
+    description: string | undefined;
+    structure: string | undefined;
+    lineCount: number | undefined;
+    cachedAt: string | undefined;
+}
+export interface CacheSchema {
+    version: number;
+    structureTTL: number;
+    skills: Record<string, Skill>;
+}
+export interface MappingEntry {
+    skillRef: string;
+    pinned?: boolean;
+}
+export interface ConfigSchema {
+    version: number;
+    mode: Mode;
+    showStructure: boolean;
+    maxLines: number;
+    mappings: Record<string, MappingEntry>;
+    namespaceAliases: Record<string, string>;
+}
+export interface ResolveResult {
+    invocation: InvocationToken;
+    skill?: Skill;
+    reason?: string;
+    candidates?: Skill[];
+}
+export interface InvocationToken {
+    raw: string;
+    alias: string;
+    namespace: string | undefined;
+}
+export interface InjectOutcome {
+    resolved: ResolveResult[];
+    warnings: string[];
+    context: string;
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+	"name": "skillset",
+	"version": "0.0.1",
+	"description": "Deterministic skill invocation for AI coding agents via $skill syntax.",
+	"type": "module",
+	"bin": {
+		"skillset": "./dist/index.js"
+	},
+	"types": "./dist/types/index.d.ts",
+	"scripts": {
+		"dev": "bun run src/index.ts --",
+		"clean": "rm -rf dist",
+		"types": "bunx tsc -p tsconfig.build.json --emitDeclarationOnly",
+		"build": "bun run clean && bun build ./src/index.ts ./src/hook.ts --outdir dist --target bun --minify && bun run types",
+		"lint": "bunx biome check .",
+		"format": "bunx ultracite fix .",
+		"prepublishOnly": "bunx biome check . && bun test && bun run build",
+		"test": "bun test"
+	},
+	"files": ["dist"],
+	"author": "Matt Galligan",
+	"license": "MIT",
+	"engines": {
+		"bun": ">=1.0.0"
+	},
+	"dependencies": {
+		"chalk": "^5.3.0",
+		"commander": "^11.1.0",
+		"inquirer": "^9.2.12",
+		"object-treeify": "^5.0.1",
+		"ora": "^8.0.1"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^1.8.0",
+		"@types/inquirer": "9",
+		"bun-types": "^1.3.2",
+		"typescript": "^5.6.3",
+		"ultracite": "^6.4.2"
+	},
+	"exports": {
+		".": "./dist/index.js",
+		"./hook": "./dist/hook.js"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/outfitter-dev/skillset.git"
+	},
+	"bugs": {
+		"url": "https://github.com/outfitter-dev/skillset/issues"
+	},
+	"homepage": "https://github.com/outfitter-dev/skillset#readme",
+	"keywords": ["claude", "ai", "agents", "skills", "codex", "cli"]
+}