@crafter/skillkit 0.2.1 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@crafter/skillkit",
-	"version": "0.2.1",
+	"version": "0.2.3",
 	"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,11 @@ 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("stats")} ${cyan("--all")}               Show all skills, not just top 10
+
   ${dim("Install skills via skills.sh: npx skills add <owner/repo>")}
 `);
 }

package/src/commands/scan.ts

@@ -1,4 +1,5 @@
 import { existsSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
 import { basename, join } from "node:path";
 import { upsertInstalledSkill, deduplicateInvocations } from "../db/queries";
 import { getDb } from "../db/schema";
@@ -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();
@@ -103,6 +105,35 @@ export async function runScan(): Promise<void> {
 		} 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`)}`);

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,20 +56,24 @@ export async function runStats(): Promise<void> {
 		return;
 	}
 
-	const topSkills = getTopSkills(db, 30);
+	const showAll = process.argv.includes("--all");
+	const topSkills = getTopSkills(db, days, showAll ? undefined : 10);
 	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`);
-	console.log(`  ${bold("TOP SKILLS")}\n`);
+	console.log(`  ${bold(showAll ? "ALL SKILLS" : "TOP SKILLS")}\n`);
 
 	const maxCount = topSkills.length > 0 ? (topSkills[0]?.total ?? 1) : 1;
 	const barWidth = 20;
 
-	for (const skill of topSkills.slice(0, 10)) {
-		const daily = getDailyUsage(db, skill.skill_name, 30);
+	for (const skill of topSkills) {
+		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/db/queries.ts

@@ -24,15 +24,18 @@ interface InstalledSkillRow {
 	size_bytes: number | null;
 }
 
-export function getTopSkills(db: Database, days = 30): TopSkillRow[] {
+export function getTopSkills(
+	db: Database,
+	days = 30,
+	limit?: number,
+): TopSkillRow[] {
 	const cutoff = new Date(
 		Date.now() - days * 24 * 60 * 60 * 1000,
 	).toISOString();
-	return db
-		.query<TopSkillRow, [string]>(
-			"SELECT skill_name, COUNT(*) as total FROM skill_invocations WHERE timestamp >= ? GROUP BY skill_name ORDER BY total DESC LIMIT 20",
-		)
-		.all(cutoff);
+	const sql = limit
+		? `SELECT skill_name, COUNT(*) as total FROM skill_invocations WHERE timestamp >= ? GROUP BY skill_name ORDER BY total DESC LIMIT ${limit}`
+		: "SELECT skill_name, COUNT(*) as total FROM skill_invocations WHERE timestamp >= ? GROUP BY skill_name ORDER BY total DESC";
+	return db.query<TopSkillRow, [string]>(sql).all(cutoff);
 }
 
 export function getSkillStats(db: Database, days = 30): StatsRow {