@crafter/skillkit 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@crafter/skillkit",
-	"version": "0.2.0",
+	"version": "0.2.2",
 	"description": "Local-first analytics for AI agent skills. Track usage, measure context budget, and prune what you don't use.",
 	"type": "module",
 	"bin": {

package/src/bin.ts

@@ -24,6 +24,10 @@ function printHelp(): void {
     ${cyan("version")}     Print version
     ${cyan("help")}        Show this help message
 
+  ${bold("FLAGS")}
+    ${dim("scan")}  ${cyan("--include-commands")}  Also track slash commands (not just skills)
+    ${dim("stats")} ${cyan("--days N")}             Time range in days (default: 30)
+
   ${dim("Install skills via skills.sh: npx skills add <owner/repo>")}
 `);
 }

package/src/commands/scan.ts

@@ -1,5 +1,6 @@
 import { existsSync, readdirSync, statSync } from "node:fs";
-import { join } from "node:path";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
 import { upsertInstalledSkill, deduplicateInvocations } from "../db/queries";
 import { getDb } from "../db/schema";
 import { countAllSessions, scanAllSessions } from "../scanner/index";
@@ -22,6 +23,7 @@ function detectSource(skillPath: string): "skills.sh" | "manual" {
 }
 
 export async function runScan(): Promise<void> {
+	const includeCommands = process.argv.includes("--include-commands");
 	const db = getDb();
 
 	const agents = getDetectedAgents();
@@ -86,6 +88,52 @@ export async function runScan(): Promise<void> {
 		} catch {}
 	}
 
+	const knownSkills = new Set<string>();
+	for (const skill of skills) {
+		knownSkills.add(skill.name);
+		knownSkills.add(basename(skill.path));
+	}
+	if (existsSync(localSkillsDir)) {
+		try {
+			for (const e of readdirSync(localSkillsDir)) {
+				try {
+					if (statSync(join(localSkillsDir, e)).isDirectory()) {
+						knownSkills.add(e);
+					}
+				} catch {}
+			}
+		} catch {}
+	}
+
+	if (includeCommands) {
+		const commandDirs = [
+			join(process.cwd(), ".claude", "commands"),
+			join(homedir(), ".claude", "commands"),
+		];
+		let commandCount = 0;
+		for (const dir of commandDirs) {
+			if (!existsSync(dir)) continue;
+			try {
+				for (const e of readdirSync(dir)) {
+					if (e.endsWith(".md")) {
+						knownSkills.add(e.slice(0, -3));
+						commandCount++;
+					} else {
+						try {
+							if (statSync(join(dir, e)).isDirectory()) {
+								knownSkills.add(e);
+								commandCount++;
+							}
+						} catch {}
+					}
+				}
+			} catch {}
+		}
+		if (commandCount > 0) {
+			console.log(dim(`  + ${commandCount} slash commands`));
+		}
+	}
+
 	const removed = deduplicateInvocations(db);
 	if (removed > 0) {
 		console.log(`  ${dim(`Cleaned ${removed} duplicate entries`)}`);
@@ -94,7 +142,7 @@ export async function runScan(): Promise<void> {
 	console.log(dim("  Scanning sessions..."));
 
 	const sessionCount = countAllSessions();
-	const newInvocations = await scanAllSessions(db);
+	const newInvocations = await scanAllSessions(db, knownSkills);
 	const totalRow = db
 		.query<{ count: number }, []>(
 			"SELECT COUNT(*) as count FROM skill_invocations",

package/src/commands/stats.ts

@@ -23,15 +23,32 @@ function getMostActiveDay(db: ReturnType<typeof getDb>): string {
 	return days[parseInt(row.day, 10)] ?? "N/A";
 }
 
+function parseDays(args: string[]): number {
+	for (let i = 0; i < args.length; i++) {
+		if (args[i] === "--days" && args[i + 1]) {
+			const n = parseInt(args[i + 1], 10);
+			if (!isNaN(n) && n > 0) return n;
+		}
+		const match = args[i]?.match(/^--days=(\d+)$/);
+		if (match) {
+			const n = parseInt(match[1], 10);
+			if (!isNaN(n) && n > 0) return n;
+		}
+	}
+	return 30;
+}
+
 export async function runStats(): Promise<void> {
 	const db = getDb();
+	const days = parseDays(process.argv.slice(3));
+
 	console.log("\n  Scanning sessions...");
 	const newCount = await scanAllSessions(db);
 	if (newCount > 0) {
 		console.log(`  Found ${newCount} new invocations.\n`);
 	}
 
-	const stats = getSkillStats(db, 30);
+	const stats = getSkillStats(db, days);
 
 	if (stats.total === 0) {
 		console.log(`\n  ${yellow("No analytics data yet.")}`);
@@ -39,10 +56,13 @@ export async function runStats(): Promise<void> {
 		return;
 	}
 
-	const topSkills = getTopSkills(db, 30);
+	const topSkills = getTopSkills(db, days);
 	const activeDay = getMostActiveDay(db);
 
-	console.log(`\n  ${bold("SKILL-KIT ANALYTICS")} ${dim("(last 30 days)")}\n`);
+	const label =
+		days === 30 ? "last 30 days" : days === 7 ? "last 7 days" : `last ${days} days`;
+
+	console.log(`\n  ${bold("SKILL-KIT ANALYTICS")} ${dim(`(${label})`)}\n`);
 	console.log(`  Total invocations: ${bold(String(stats.total))}`);
 	console.log(`  Unique skills:     ${bold(String(stats.unique_skills))}`);
 	console.log(`  Most active day:   ${bold(activeDay)}\n`);
@@ -52,7 +72,7 @@ export async function runStats(): Promise<void> {
 	const barWidth = 20;
 
 	for (const skill of topSkills.slice(0, 10)) {
-		const daily = getDailyUsage(db, skill.skill_name, 30);
+		const daily = getDailyUsage(db, skill.skill_name, days);
 		const filled = Math.round((skill.total / maxCount) * barWidth);
 		const bar = "█".repeat(filled);
 		const spark = sparkline(daily.map((d) => d.count));

package/src/scanner/connectors/claude.ts

@@ -19,7 +19,28 @@ function extractSkillName(block: ToolUseBlock): string | null {
 	return null;
 }
 
-export function parseSessionFile(filePath: string): Invocation[] {
+const COMMAND_NAME_RE = /<command-name>\/?([a-zA-Z][\w-]*(?::[\w-]*)*)<\/command-name>/g;
+
+function extractCommandNames(
+	text: string,
+	knownSkills: Set<string>,
+): string[] {
+	const names: string[] = [];
+	let match: RegExpExecArray | null;
+	while ((match = COMMAND_NAME_RE.exec(text)) !== null) {
+		const name = match[1];
+		if (knownSkills.has(name)) {
+			names.push(name);
+		}
+	}
+	COMMAND_NAME_RE.lastIndex = 0;
+	return names;
+}
+
+export function parseSessionFile(
+	filePath: string,
+	knownSkills: Set<string> = new Set(),
+): Invocation[] {
 	const results: Invocation[] = [];
 	const sessionId = basename(filePath, ".jsonl");
 
@@ -49,9 +70,35 @@ export function parseSessionFile(filePath: string): Invocation[] {
 				: new Date().toISOString();
 
 		const msg = obj.message as
-			| { content: Array<Record<string, unknown>> }
+			| { content: Array<Record<string, unknown>> | string }
 			| undefined;
-		const msgContent = obj.type === "assistant" && msg ? msg.content : null;
+
+		if (obj.type === "user" && msg) {
+			const text =
+				typeof msg.content === "string"
+					? msg.content
+					: Array.isArray(msg.content)
+						? msg.content
+								.filter(
+									(b): b is { type: string; text: string } =>
+										typeof b === "object" &&
+										b !== null &&
+										b.type === "text" &&
+										typeof b.text === "string",
+								)
+								.map((b) => b.text)
+								.join("\n")
+						: "";
+			for (const name of extractCommandNames(text, knownSkills)) {
+				results.push({ skillName: name, timestamp, sessionId });
+			}
+			continue;
+		}
+
+		const msgContent =
+			obj.type === "assistant" && msg && Array.isArray(msg.content)
+				? (msg.content as Array<Record<string, unknown>>)
+				: null;
 
 		if (!Array.isArray(msgContent)) continue;
 
@@ -88,6 +135,7 @@ export function countClaudeSessions(): number {
 export async function scanClaudeSessions(
 	db: Database,
 	trackedSet: Set<string>,
+	knownSkills: Set<string> = new Set(),
 ): Promise<number> {
 	const projectsDir = join(homedir(), ".claude", "projects");
 	if (!existsSync(projectsDir)) return 0;
@@ -101,7 +149,7 @@ export async function scanClaudeSessions(
 
 	let total = 0;
 	for (const file of files) {
-		const invocations = parseSessionFile(file);
+		const invocations = parseSessionFile(file, knownSkills);
 		total += recordNewInvocations(db, trackedSet, invocations);
 	}
 

package/src/scanner/index.ts

@@ -43,10 +43,13 @@ export function recordNewInvocations(
 	return count;
 }
 
-export async function scanAllSessions(db: Database): Promise<number> {
+export async function scanAllSessions(
+	db: Database,
+	knownSkills: Set<string> = new Set(),
+): Promise<number> {
 	const trackedSet = getTrackedSet(db);
 	let total = 0;
-	total += await scanClaudeSessions(db, trackedSet);
+	total += await scanClaudeSessions(db, trackedSet, knownSkills);
 	total += scanOpenCodeSessions(db, trackedSet);
 	return total;
 }