skill-analyzer 0.1.0 → 0.1.2

package/dist/budget.d.ts

@@ -1 +1,3 @@
+export declare const OVERHEAD_PER_SKILL = 109;
+export declare const FALLBACK_BUDGET = 16000;
 export declare function budgetCommand(args: string[]): void;

package/dist/budget.js

@@ -1,45 +1,52 @@
 import chalk from "chalk";
 import { getSkillsDir, loadSkillRegistry } from "./registry.js";
 import { sectionHeader, keyValue, budgetBar, makeTable } from "./formatter.js";
-const OVERHEAD_PER_SKILL = 109;
-const DEFAULT_BUDGET = 16_000;
+export const OVERHEAD_PER_SKILL = 109;
+export const FALLBACK_BUDGET = 16_000;
 export function budgetCommand(args) {
     const skillsDir = getSkillsDir(args);
     const skills = loadSkillRegistry(skillsDir);
-    const budget = parseInt(process.env["SLASH_COMMAND_TOOL_CHAR_BUDGET"] ?? String(DEFAULT_BUDGET), 10);
+    const envBudget = process.env["SLASH_COMMAND_TOOL_CHAR_BUDGET"];
+    const budget = parseInt(envBudget ?? String(FALLBACK_BUDGET), 10);
+    const isFallback = !envBudget;
     const isJson = args.includes("--json");
     const entries = skills
         .map((s) => ({
         name: s.name,
         descriptionLength: s.descriptionLength,
-        cost: s.descriptionLength + OVERHEAD_PER_SKILL,
+        totalChars: s.descriptionLength + OVERHEAD_PER_SKILL,
     }))
-        .sort((a, b) => b.cost - a.cost);
-    const totalCost = entries.reduce((sum, e) => sum + e.cost, 0);
+        .sort((a, b) => b.totalChars - a.totalChars);
+    const totalUsed = entries.reduce((sum, e) => sum + e.totalChars, 0);
     if (isJson) {
-        console.log(JSON.stringify({ budget, totalCost, entries }, null, 2));
+        console.log(JSON.stringify({ budget, isFallback, totalUsed, entries }, null, 2));
         return;
     }
-    const overBudget = totalCost > budget;
+    const overBudget = totalUsed > budget;
     sectionHeader("Description Budget", overBudget ? "OVER BUDGET" : undefined);
     keyValue([
-        ["Budget:", budgetBar(totalCost, budget)],
+        ["Budget:", budgetBar(totalUsed, budget)],
         [
             "Used:",
-            `${totalCost.toLocaleString()} / ${budget.toLocaleString()} chars`,
+            `${totalUsed.toLocaleString()} / ${budget.toLocaleString()} chars`,
         ],
         [
             "Remaining:",
             overBudget
-                ? chalk.red(`-${(totalCost - budget).toLocaleString()} chars`)
-                : chalk.green(`${(budget - totalCost).toLocaleString()} chars`),
+                ? chalk.red(`-${(totalUsed - budget).toLocaleString()} chars`)
+                : chalk.green(`${(budget - totalUsed).toLocaleString()} chars`),
         ],
         ["Skills:", `${entries.length} (${OVERHEAD_PER_SKILL} chars overhead each)`],
     ]);
     makeTable({
         head: ["#", "Skill", "Description Chars", "Total Chars"],
         colAligns: ["right", "left", "right", "right"],
-        rows: entries.map((e, i) => [i + 1, e.name, e.descriptionLength, e.cost]),
+        rows: entries.map((e, i) => [i + 1, e.name, e.descriptionLength, e.totalChars]),
     });
+    if (isFallback) {
+        console.log();
+        console.log(chalk.dim(`  ${budget.toLocaleString()} is a static fallback. The actual budget is determined dynamically by Claude Code.`));
+        console.log(chalk.dim("  See: https://code.claude.com/docs/en/skills#claude-doesnt-see-all-my-skills"));
+    }
     console.log();
 }

package/dist/dead.js

@@ -2,6 +2,7 @@ import chalk from "chalk";
 import { getSkillsDir, loadSkillRegistry } from "./registry.js";
 import { getLogsDir, scanSessions, aggregateUsage } from "./scanner.js";
 import { sectionHeader, keyValue, makeTable } from "./formatter.js";
+import { OVERHEAD_PER_SKILL } from "./budget.js";
 export function deadCommand(args) {
     const skillsDir = getSkillsDir(args);
     const logsDir = getLogsDir(args);
@@ -19,7 +20,7 @@ export function deadCommand(args) {
     }
     const period = days ? `last ${days} days` : "all time";
     sectionHeader(`Dead Skills (${period})`);
-    const totalWaste = deadSkills.reduce((sum, s) => sum + s.descriptionLength + 109, 0);
+    const totalWaste = deadSkills.reduce((sum, s) => sum + s.descriptionLength + OVERHEAD_PER_SKILL, 0);
     keyValue([
         ["Dead:", `${deadSkills.length} of ${registry.length} local skills`],
         [
@@ -40,7 +41,7 @@ export function deadCommand(args) {
             i + 1,
             chalk.red(s.name),
             s.descriptionLength,
-            s.descriptionLength + 109,
+            s.descriptionLength + OVERHEAD_PER_SKILL,
         ]),
     });
     console.log();

package/dist/report.js

@@ -1,6 +1,6 @@
 import { getSkillsDir, loadSkillRegistry } from "./registry.js";
 import { getLogsDir, scanSessions, aggregateUsage } from "./scanner.js";
-import { budgetCommand } from "./budget.js";
+import { budgetCommand, OVERHEAD_PER_SKILL, FALLBACK_BUDGET } from "./budget.js";
 import { usageCommand } from "./usage.js";
 import { deadCommand } from "./dead.js";
 export function reportCommand(args) {
@@ -24,18 +24,20 @@ function reportJson(args) {
     const usage = aggregateUsage(invocations);
     const usedSkills = new Set(usage.map((u) => u.skill));
     const deadSkills = registry.filter((s) => !usedSkills.has(s.name)).map((s) => s.name);
-    const budget = parseInt(process.env["SLASH_COMMAND_TOOL_CHAR_BUDGET"] ?? "16000", 10);
+    const envBudget = process.env["SLASH_COMMAND_TOOL_CHAR_BUDGET"];
+    const budget = parseInt(envBudget ?? String(FALLBACK_BUDGET), 10);
+    const isFallback = !envBudget;
     const budgetEntries = registry
         .map((s) => ({
         name: s.name,
         descriptionLength: s.descriptionLength,
-        cost: s.descriptionLength + 109,
+        totalChars: s.descriptionLength + OVERHEAD_PER_SKILL,
     }))
-        .sort((a, b) => b.cost - a.cost);
-    const totalCost = budgetEntries.reduce((sum, e) => sum + e.cost, 0);
+        .sort((a, b) => b.totalChars - a.totalChars);
+    const totalUsed = budgetEntries.reduce((sum, e) => sum + e.totalChars, 0);
     console.log(JSON.stringify({
         usage: { totalInvocations: invocations.length, skills: usage },
         dead: { count: deadSkills.length, skills: deadSkills },
-        budget: { limit: budget, totalCost, entries: budgetEntries },
+        budget: { limit: budget, isFallback, totalUsed, entries: budgetEntries },
     }, null, 2));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-analyzer",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Analyze Claude Code skill library: usage frequency, dead skills, description budget consumption",
   "type": "module",
   "bin": {