@crafter/skillkit 0.0.1 → 0.1.1

package/package.json

@@ -1,10 +1,15 @@
 {
 	"name": "@crafter/skillkit",
-	"version": "0.0.1",
+	"version": "0.1.1",
+	"description": "Local-first analytics for AI agent skills. Track usage, measure context budget, and prune what you don't use.",
 	"type": "module",
 	"bin": {
-		"skill-kit": "./src/bin.ts"
+		"skillkit": "./src/bin.ts"
 	},
+	"files": [
+		"src",
+		"README.md"
+	],
 	"exports": {
 		".": {
 			"bun": "./src/index.ts",
@@ -13,10 +18,34 @@
 	},
 	"scripts": {
 		"dev": "bun run src/bin.ts",
-		"build": "bun build src/bin.ts --compile --outfile dist/skill-kit",
+		"build": "bun build src/bin.ts --compile --outfile dist/skillkit",
 		"test": "bun test src/",
 		"type-check": "tsc --noEmit"
 	},
+	"keywords": [
+		"skillkit",
+		"skills",
+		"analytics",
+		"claude-code",
+		"cursor",
+		"ai-agent",
+		"context-window",
+		"cli"
+	],
+	"author": "Crafter Station <the.crafter.station@gmail.com>",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/crafter-station/skill-kit.git",
+		"directory": "packages/cli"
+	},
+	"homepage": "https://github.com/crafter-station/skill-kit#readme",
+	"bugs": {
+		"url": "https://github.com/crafter-station/skill-kit/issues"
+	},
+	"engines": {
+		"bun": ">=1.0.0"
+	},
 	"devDependencies": {
 		"@types/bun": "^1.2.14",
 		"typescript": "^5.9.3"

package/src/bin.ts

@@ -1,22 +1,25 @@
 #!/usr/bin/env bun
 import { bold, cyan, dim, yellow } from "./tui/colors";
 
-const VERSION = "0.0.1";
+const VERSION = "0.1.1";
 
 function printHelp(): void {
 	console.log(`
-  ${bold("skill-kit")} ${dim(`v${VERSION}`)} - Claude skill analytics & management
+  ${bold("skillkit")} ${dim(`v${VERSION}`)} - Analytics for AI agent skills
 
   ${bold("USAGE")}
-    skill-kit <command>
+    skillkit <command> [args]
 
   ${bold("COMMANDS")}
-    ${cyan("list")}      List all installed skills
-    ${cyan("stats")}     Show usage analytics (last 30 days)
-    ${cyan("health")}    Run a health check on your skill setup
-    ${cyan("analyze")}   Scan sessions and populate analytics DB
-    ${cyan("version")}   Print version
-    ${cyan("help")}      Show this help message
+    ${cyan("scan")}        Discover installed skills and index session data
+    ${cyan("list")}        List installed skills with size & context budget
+    ${cyan("stats")}       Usage analytics with sparklines (last 30 days)
+    ${cyan("health")}      Health check: unused skills, context budget, DB
+    ${cyan("prune")}       Remove unused skills to reclaim context budget
+    ${cyan("version")}     Print version
+    ${cyan("help")}        Show this help message
+
+  ${dim("Install skills via skills.sh: npx skills add <owner/repo>")}
 `);
 }
 
@@ -24,7 +27,13 @@ async function main(): Promise<void> {
 	const cmd = process.argv[2];
 
 	switch (cmd) {
-		case "list": {
+		case "scan": {
+			const { runScan } = await import("./commands/scan");
+			await runScan();
+			break;
+		}
+		case "list":
+		case "ls": {
 			const { runList } = await import("./commands/list");
 			runList();
 			break;
@@ -39,15 +48,9 @@ async function main(): Promise<void> {
 			await runHealth();
 			break;
 		}
-		case "analyze": {
-			const { getDb } = await import("./db/schema");
-			const { scanAllSessions } = await import("./scanner/index");
-			const db = getDb();
-			console.log("\n  Scanning ~/.claude/projects/ for skill invocations...");
-			const count = await scanAllSessions(db);
-			console.log(
-				`  ${count > 0 ? `Found ${count} new invocations.` : "No new invocations found."}\n`,
-			);
+		case "prune": {
+			const { runPrune } = await import("./commands/prune");
+			await runPrune();
 			break;
 		}
 		case "version":

package/src/commands/health.ts

@@ -29,7 +29,7 @@ function _formatSize(bytes: number): string {
 export async function runHealth(): Promise<void> {
 	const skills = scanInstalledSkills();
 	const _skillsDir = join(homedir(), ".claude", "skills");
-	const dbPath = join(homedir(), ".skill-kit", "analytics.db");
+	const dbPath = join(homedir(), ".skillkit", "analytics.db");
 	const dbExists = existsSync(dbPath);
 
 	let totalContextChars = 0;
@@ -83,10 +83,10 @@ export async function runHealth(): Promise<void> {
 		);
 	} else if (dbExists) {
 		console.log(warn("Analytics DB exists but has no data"));
-		console.log(dim("    Run: skill-kit stats"));
+		console.log(dim("    Run: skillkit scan"));
 	} else {
 		console.log(warn("Analytics DB not found"));
-		console.log(dim("    Run: skill-kit stats"));
+		console.log(dim("    Run: skillkit scan"));
 	}
 
 	if (neverUsed.length > 0) {
@@ -95,7 +95,7 @@ export async function runHealth(): Promise<void> {
 		const preview = neverUsed.slice(0, 5).join(", ");
 		const more = neverUsed.length > 5 ? ` +${neverUsed.length - 5} more` : "";
 		console.log(`    ${dim(preview + more)}`);
-		console.log(`    ${dim("Run: skill-kit uninstall <name>")}`);
+		console.log(`    ${dim("Run: skillkit prune")}`);
 	}
 
 	const unusedContextChars = neverUsed.reduce((acc, name) => {

package/src/commands/prune.ts

@@ -0,0 +1,85 @@
+import { existsSync, readFileSync, rmSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { getTopSkills } from "../db/queries";
+import { getDb } from "../db/schema";
+import { scanInstalledSkills } from "../scanner/skills";
+import { bold, cyan, dim, red, yellow } from "../tui/colors";
+
+export async function runPrune(): Promise<void> {
+	const dbPath = join(homedir(), ".skillkit", "analytics.db");
+	if (!existsSync(dbPath)) {
+		console.log(`\n  ${yellow("No analytics data yet.")}`);
+		console.log(`  ${dim("Run: skillkit scan")}\n`);
+		return;
+	}
+
+	const db = getDb();
+	const skills = scanInstalledSkills();
+
+	if (skills.length === 0) {
+		console.log(`\n  ${dim("No skills installed.")}\n`);
+		return;
+	}
+
+	const topSkills = getTopSkills(db, 30);
+	const usedNames = new Set(topSkills.map((s) => s.skill_name));
+	const unused = skills.filter((s) => !usedNames.has(s.name));
+
+	if (unused.length === 0) {
+		console.log(
+			`\n  ${dim("All")} ${bold(String(skills.length))} ${dim("skills were used in the last 30 days. Nothing to prune.")}\n`,
+		);
+		return;
+	}
+
+	let totalWaste = 0;
+	const candidates: Array<{ name: string; path: string; chars: number }> = [];
+
+	for (const skill of unused) {
+		const skillMdPath = join(skill.path, "SKILL.md");
+		let chars = 0;
+		if (existsSync(skillMdPath)) {
+			try {
+				chars = readFileSync(skillMdPath, "utf-8").length;
+			} catch {}
+		}
+		totalWaste += chars;
+		candidates.push({ name: skill.name, path: skill.path, chars });
+	}
+
+	console.log(
+		`\n  ${bold("PRUNE")} ${dim("— unused skills in the last 30 days")}\n`,
+	);
+
+	for (const c of candidates) {
+		const size = c.chars > 0 ? dim(` (${(c.chars / 1000).toFixed(1)}K)`) : "";
+		console.log(`  ${red("×")} ${c.name}${size}`);
+	}
+
+	console.log(
+		`\n  ${bold(String(candidates.length))} skills ${dim("·")} ${bold(`${(totalWaste / 1000).toFixed(1)}K`)} ${dim("context reclaimable")}`,
+	);
+
+	const args = process.argv.slice(3);
+	if (!args.includes("--yes") && !args.includes("-y")) {
+		console.log(
+			`\n  ${dim("Run with")} ${cyan("--yes")} ${dim("to confirm deletion.")}\n`,
+		);
+		return;
+	}
+
+	let removed = 0;
+	for (const c of candidates) {
+		try {
+			rmSync(c.path, { recursive: true, force: true });
+			removed++;
+		} catch {
+			console.log(`  ${yellow("!")} Failed to remove ${c.name}`);
+		}
+	}
+
+	console.log(
+		`\n  ${bold(`Removed ${removed} skills`)} ${dim("·")} ${bold(`${(totalWaste / 1000).toFixed(1)}K`)} ${dim("reclaimed")}\n`,
+	);
+}

package/src/commands/scan.ts

@@ -0,0 +1,117 @@
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { upsertInstalledSkill } from "../db/queries";
+import { getDb } from "../db/schema";
+import { scanAllSessions } from "../scanner/index";
+import { scanInstalledSkills } from "../scanner/skills";
+import { bold, cyan, dim } from "../tui/colors";
+
+function detectSource(skillPath: string): "skills.sh" | "manual" {
+	const metaDir = join(skillPath, ".skills");
+	if (existsSync(metaDir)) return "skills.sh";
+
+	const skillMd = join(skillPath, "SKILL.md");
+	if (existsSync(skillMd)) {
+		try {
+			const entries = readdirSync(skillPath);
+			if (entries.includes(".git") || entries.includes(".gitmodules"))
+				return "skills.sh";
+		} catch {}
+	}
+	return "manual";
+}
+
+function countSessions(): number {
+	const projectsDir = join(homedir(), ".claude", "projects");
+	if (!existsSync(projectsDir)) return 0;
+
+	let count = 0;
+	const glob = new Bun.Glob("**/*.jsonl");
+	for (const _ of glob.scanSync({ cwd: projectsDir })) {
+		count++;
+	}
+	return count;
+}
+
+export async function runScan(): Promise<void> {
+	const db = getDb();
+
+	console.log(`\n  ${dim("Scanning ~/.claude/skills/ ...")}`);
+
+	const skills = scanInstalledSkills();
+
+	let skillsShCount = 0;
+	let manualCount = 0;
+
+	for (const skill of skills) {
+		const source = detectSource(skill.path);
+		if (source === "skills.sh") skillsShCount++;
+		else manualCount++;
+
+		upsertInstalledSkill(
+			db,
+			skill.name,
+			skill.path,
+			source,
+			undefined,
+			skill.size,
+		);
+	}
+
+	if (skills.length === 0) {
+		console.log(dim("  No skills found.\n"));
+		return;
+	}
+
+	const parts: string[] = [];
+	if (skillsShCount > 0) parts.push(`${skillsShCount} via skills.sh`);
+	if (manualCount > 0) parts.push(`${manualCount} manual`);
+
+	console.log(
+		`  ${bold(`Found ${skills.length} skills`)} ${dim(`(${parts.join(", ")})`)}`,
+	);
+
+	const localSkillsDir = join(process.cwd(), ".claude", "skills");
+	if (existsSync(localSkillsDir)) {
+		try {
+			const localEntries = readdirSync(localSkillsDir).filter((e) => {
+				try {
+					return statSync(join(localSkillsDir, e)).isDirectory();
+				} catch {
+					return false;
+				}
+			});
+			if (localEntries.length > 0) {
+				console.log(
+					dim(
+						`  + ${localEntries.length} project-local skills in .claude/skills/`,
+					),
+				);
+			}
+		} catch {}
+	}
+
+	console.log(dim("  Scanning sessions..."));
+
+	const sessionCount = countSessions();
+	const newInvocations = await scanAllSessions(db);
+	const totalRow = db
+		.query<{ count: number }, []>(
+			"SELECT COUNT(*) as count FROM skill_invocations",
+		)
+		.get();
+	const totalInvocations = totalRow?.count ?? 0;
+
+	console.log(
+		`  ${dim("Indexed")} ${bold(String(sessionCount))} ${dim("sessions")} ${cyan("·")} ${bold(totalInvocations.toLocaleString())} ${dim("invocations")}`,
+	);
+
+	if (newInvocations > 0) {
+		console.log(dim(`  (${newInvocations} new)`));
+	}
+
+	console.log(
+		`\n  ${dim("Ready. Run")} ${cyan("skillkit stats")} ${dim("to see usage.")}\n`,
+	);
+}

package/src/commands/stats.ts

@@ -35,7 +35,7 @@ export async function runStats(): Promise<void> {
 
 	if (stats.total === 0) {
 		console.log(`\n  ${yellow("No analytics data yet.")}`);
-		console.log(`  ${dim("Run: skill-kit analyze")}\n`);
+		console.log(`  ${dim("Run: skillkit scan")}\n`);
 		return;
 	}
 

package/src/db/schema.ts

@@ -3,7 +3,7 @@ import { mkdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
-const DB_DIR = join(homedir(), ".skill-kit");
+const DB_DIR = join(homedir(), ".skillkit");
 const DB_PATH = join(DB_DIR, "analytics.db");
 
 export function getDb(): Database {

package/src/index.ts

@@ -1,5 +1,7 @@
 export { runHealth } from "./commands/health";
 export { runList } from "./commands/list";
+export { runPrune } from "./commands/prune";
+export { runScan } from "./commands/scan";
 export { runStats } from "./commands/stats";
 export {
 	getDailyUsage,

package/tsconfig.json

@@ -1,9 +0,0 @@
-{
-	"extends": "../../tsconfig.base.json",
-	"compilerOptions": {
-		"outDir": "./dist",
-		"rootDir": "./src",
-		"types": ["bun-types"]
-	},
-	"include": ["src"]
-}