skillio 0.1.7 → 0.1.8

package/README.md

@@ -66,14 +66,16 @@ audits both Claude Code and Codex over all time).
 ## Usage
 
 ```sh
-# bare command — quick summary across global + local sources, with verdict
+# bare command — per-skill ambient token cost, sorted desc, with verdict
 skl
 skillio                                # equivalent
 
 # subcommands
 skl ls                                 # list skills per source with diffs
 skl cost                               # ambient ballast cost (frontmatter tokens) per skill
+skl cst                                # alias for cost
 skl usage                              # consumption: usage count × frontmatter tokens
+skl usg                                # alias for usage
 skl rm brainstorming                   # remove from lock + delete on-disk dir (with Y/n prompt)
 skl rm brainstorming writing-plans     # remove multiple
 skl rm --yes brainstorming             # skip confirmation
@@ -97,11 +99,9 @@ skl usage -a claude -a codex           # equivalent: repeated --agent flag
 | anywhere with `-g` / `--global` | global override |
 | with `--root <dir>` | that exact dir, treated as global |
 
-> Bare `skl` (no subcommand) ignores `-g` — it always shows both Global and Local sections plus a grand Total.
-
 ## What it does
 
-- **Summary** (`skl`) — counts and tokens across `.claude/skills`, `.agents/skills`, and `skills-lock.json` for both global and local scopes, with a cleanup verdict.
+- **Cost** (`skl`) — per-skill ambient token cost sorted descending, with a cleanup verdict. Bare `skl` = `skl cost` in local scope; `skl -g` = global scope.
 - **Audit skill usage** (`skl usage`) — parse agent session logs and count which skills were invoked, when, and how often.
 - **Manage a skills lock** (`skl ls`, `skl rm`) — inspect and remove skills from a local or global lock file.
 

package/dist/cli.js

@@ -596,6 +596,9 @@ function yellow(s) {
 function red(s) {
   return enabled ? `\x1B[31m${s}\x1B[0m` : s;
 }
+function cyan2(s) {
+  return enabled ? `\x1B[36m${s}\x1B[0m` : s;
+}
 
 // src/utils/discover-skills.ts
 import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync3, statSync } from "node:fs";
@@ -717,7 +720,8 @@ var costCommand = defineCommand({
         cell = "missing";
       else
         cell = "(no frontmatter)";
-      console.log(`${r.name.padEnd(nameWidth)}  ${cell}`);
+      const pad = " ".repeat(nameWidth - r.name.length);
+      console.log(`${cyan2(r.name)}${pad}  ${cell}`);
     }
     console.log("");
     console.log(`Total: ~${total} tok across ${rows.length} skills    ${paint(message)}`);
@@ -788,19 +792,19 @@ var listCommand = defineCommand({
       if (!row)
         continue;
       const countCell = countCells[i] ?? "";
-      const namesText = row.names.length ? row.names.join(" ") : "";
+      const namesText = row.names.length ? row.names.map(cyan2).join(" ") : "";
       const line = `${row.label.padEnd(labelWidth)} : ${countCell.padEnd(countWidth)}${namesText ? ` : ${namesText}` : ""}`;
       console.log(line.trimEnd());
     }
     const diffs = [];
     if (lockOnly.length) {
-      diffs.push(`skills-lock.json has ${lockOnly.length} skill${lockOnly.length === 1 ? "" : "s"} missing on disk: ${lockOnly.join(", ")}`);
+      diffs.push(`skills-lock.json has ${lockOnly.length} skill${lockOnly.length === 1 ? "" : "s"} missing on disk: ${lockOnly.map(cyan2).join(", ")}`);
     }
     if (claudeNotInLock.length) {
-      diffs.push(`.claude/skills has ${claudeNotInLock.length} skill${claudeNotInLock.length === 1 ? "" : "s"} not in lock: ${claudeNotInLock.join(", ")}`);
+      diffs.push(`.claude/skills has ${claudeNotInLock.length} skill${claudeNotInLock.length === 1 ? "" : "s"} not in lock: ${claudeNotInLock.map(cyan2).join(", ")}`);
     }
     if (agentsNotInLock.length) {
-      diffs.push(`.agents/skills has ${agentsNotInLock.length} skill${agentsNotInLock.length === 1 ? "" : "s"} not in lock: ${agentsNotInLock.join(", ")}`);
+      diffs.push(`.agents/skills has ${agentsNotInLock.length} skill${agentsNotInLock.length === 1 ? "" : "s"} not in lock: ${agentsNotInLock.map(cyan2).join(", ")}`);
     }
     if (diffs.length) {
       console.log("");
@@ -976,89 +980,6 @@ var removeCommand = defineCommand({
   }
 });
 
-// src/commands/summary.ts
-function classify2(total) {
-  if (total < 1000)
-    return { verdict: "ok", message: "OK — keep it lean", paint: green };
-  if (total <= 1500)
-    return { verdict: "plan", message: "time to plan some cleanup", paint: yellow };
-  return { verdict: "cleanup", message: "ballast — clean it up", paint: red };
-}
-function bucketTokens(records, source) {
-  return records.filter((r) => r.sources.includes(source)).reduce((acc, r) => acc + (r.frontmatterTokens ?? 0), 0);
-}
-function bucketCount(records, source) {
-  return records.filter((r) => r.sources.includes(source)).length;
-}
-function buildSection(opts) {
-  const lockPath = getLockPath(opts.isGlobal);
-  const records = [
-    ...discoverSkills({ isGlobal: opts.isGlobal, cwd: opts.cwd, lockPath }).values()
-  ];
-  const rows = [
-    {
-      label: `${opts.prefix}.claude/skills`,
-      count: bucketCount(records, ".claude"),
-      tokens: bucketTokens(records, ".claude")
-    },
-    {
-      label: `${opts.prefix}.agents/skills`,
-      count: bucketCount(records, ".agents"),
-      tokens: bucketTokens(records, ".agents")
-    },
-    {
-      label: `${opts.prefix}skills-lock.json`,
-      count: bucketCount(records, "lock"),
-      tokens: bucketTokens(records, "lock")
-    }
-  ];
-  const totalTokens = records.reduce((acc, r) => acc + (r.frontmatterTokens ?? 0), 0);
-  const totalCount = records.length;
-  return {
-    title: opts.isGlobal ? "Global" : "Local",
-    rows,
-    totalCount,
-    totalTokens
-  };
-}
-function formatRow(row, labelW, countW, tokenW) {
-  const countCell = row.count === 0 ? "(empty)" : `${row.count} skill${row.count === 1 ? "" : "s"}`;
-  const tokensCell = `~${row.tokens} tok`;
-  return `${row.label.padEnd(labelW)} : ${countCell.padEnd(countW)}  ${tokensCell.padStart(tokenW)}`;
-}
-function renderSection(section) {
-  const labelW = Math.max(...section.rows.map((r) => r.label.length));
-  const countCells = section.rows.map((r) => r.count === 0 ? "(empty)" : `${r.count} skill${r.count === 1 ? "" : "s"}`);
-  const countW = Math.max(...countCells.map((c) => c.length));
-  const tokenW = Math.max(...section.rows.map((r) => `~${r.tokens} tok`.length));
-  return [section.title, ...section.rows.map((r) => formatRow(r, labelW, countW, tokenW))];
-}
-function runSummary(args) {
-  const cwd = process.cwd();
-  const global = buildSection({ isGlobal: true, cwd, prefix: "~/" });
-  const local = buildSection({ isGlobal: false, cwd, prefix: "" });
-  const lines = [];
-  lines.push(...renderSection(global));
-  lines.push("");
-  lines.push(...renderSection(local));
-  lines.push("");
-  const grandTokens = global.totalTokens + local.totalTokens;
-  const grandCount = global.totalCount + local.totalCount;
-  const { message, paint } = classify2(grandTokens);
-  lines.push(`Total: ${grandCount} skills  ~${grandTokens} tok    ${paint(message)}`);
-  console.log(lines.join(`
-`));
-}
-var summaryCommand = defineCommand({
-  meta: { description: "Show skill counts and tokens across global + local sources" },
-  args: {
-    global: { type: "boolean", alias: "g", default: false, description: "Use global scope" }
-  },
-  run({ args }) {
-    runSummary({ global: args.global });
-  }
-});
-
 // src/commands/usage.ts
 import { existsSync as existsSync9 } from "node:fs";
 import { join as join10 } from "node:path";
@@ -1397,7 +1318,7 @@ function pad(n, width) {
   return String(n).padStart(width);
 }
 function formatUsageRow(row) {
-  return `${pad(row.count, row.countWidth)} ${row.name}`;
+  return `${pad(row.count, row.countWidth)} ${cyan2(row.name)}`;
 }
 function parseAgents(agent) {
   if (!agent)
@@ -1670,7 +1591,18 @@ function mergeAgentArgs(argv) {
     out.splice(slotIdx, 0, "--agent", values.join("\x1F"));
   return out;
 }
-var SUBCOMMAND_NAMES = new Set(["list", "ls", "remove", "rm", "cost", "co", "usage", "us"]);
+var SUBCOMMAND_NAMES = new Set([
+  "list",
+  "ls",
+  "remove",
+  "rm",
+  "cost",
+  "co",
+  "cst",
+  "usage",
+  "us",
+  "usg"
+]);
 function reorderRootFlagsToSubcommand(argv) {
   const tail = argv.slice(2);
   const subIdx = tail.findIndex((t) => !!t && SUBCOMMAND_NAMES.has(t));
@@ -1702,8 +1634,8 @@ function printRootHelp() {
     "",
     "  list, ls         List skills per source with totals and lock-vs-disk diff",
     "  remove, rm       Remove skills from lock and delete their on-disk dirs",
-    "  cost, co         Show ambient ballast cost (per-skill frontmatter tokens) sorted desc",
-    "  usage, us        Show skill usage × cost (consumption) with missed rows"
+    "  cost, co, cst    Show ambient ballast cost (per-skill frontmatter tokens) sorted desc",
+    "  usage, us, usg   Show skill usage × cost (consumption) with missed rows"
   ];
   console.log(lines.join(`
 `));
@@ -1754,13 +1686,13 @@ var main = defineCommand({
     version,
     description: "Audit and manage AI agent skills"
   },
-  args: summaryCommand.args,
+  args: costCommand.args,
   async run({ args }) {
     if (hasSubcommand(process.argv))
       return;
-    await summaryCommand.run?.({
+    await costCommand.run?.({
       args,
-      cmd: summaryCommand,
+      cmd: costCommand,
       rawArgs: process.argv.slice(2)
     });
   },
@@ -1771,8 +1703,10 @@ var main = defineCommand({
     rm: removeCommand,
     cost: costCommand,
     co: costCommand,
+    cst: costCommand,
     usage: usageCommand,
-    us: usageCommand
+    us: usageCommand,
+    usg: usageCommand
   }
 });
 (async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillio",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Audit and manage AI agent skills for Claude Code and Codex",
   "license": "MIT",
   "author": "ihororlovskyi",