cc-skill-audit 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+# cc-skill-audit
+
+Audit your [Claude Code](https://docs.anthropic.com/en/docs/claude-code) skills: token overhead, usage frequency, and prune candidates.
+
+```
+npx cc-skill-audit
+```
+
+## What it shows
+
+```
+  cc-skill-audit  Skill token overhead analyzer
+  ────────────────────────────────────────────────────────────
+
+  Summary
+  Skills installed       109
+  Index overhead       2.3K tokens  (loaded every session)
+  Total content       348.6K tokens  (loaded on invocation)
+  Usage lookback           30 days
+
+  Top 20 skills by size  (30d usage)
+  Skill                         Tokens   Use  Bar
+  ────────────────────────────────────────────────────────────
+  writing-skills                 21.7K     0  ██████████████
+  pptx                           14.3K     0  █████████░░░░░
+  docx                           12.9K     0  ████████░░░░░░
+  ...
+
+  Prune candidates  (>5K tokens, 0 uses in 30d)
+  Removing these would save ~82.2K tokens when invoked
+  ✗  writing-skills                 21.7K tokens
+  ✗  pptx                           14.3K tokens
+  ...
+
+  Active (used in 30d):  45 / 109
+  Never used in 30d:     64 skills
+```
+
+## Usage
+
+```bash
+npx cc-skill-audit                # full report (top 20 skills)
+npx cc-skill-audit --top 30       # show top 30 skills by size
+npx cc-skill-audit --days 14      # look back 14 days for usage
+npx cc-skill-audit --json         # machine-readable JSON output
+```
+
+## Why it matters
+
+Each skill in `~/.claude/skills/` contributes to:
+
+1. **Index overhead** — The skill list (name + description) loads into every session. More skills = more tokens per session.
+2. **Invocation overhead** — When you call `/skill-name`, its full content loads into the context window.
+
+This tool helps you identify skills that are large but rarely used, so you can archive or remove them to keep your context window clean.
+
+## How it works
+
+- Reads skill files from `~/.claude/skills/`
+- Scans session transcripts in `~/.claude/projects/` for skill invocations over the lookback period
+- Ranks skills by size and usage frequency
+- Highlights prune candidates (>5K tokens, 0 uses)
+
+Zero dependencies. Works entirely offline.
+
+## Requirements
+
+- Node.js 18+
+- Claude Code installed with skills in `~/.claude/skills/`
+
+## Part of cc-toolkit
+
+`cc-skill-audit` is part of [cc-toolkit](https://yurukusa.github.io/cc-toolkit/) — a collection of CLI tools for Claude Code power users.
+
+## License
+
+MIT

package/cli.mjs

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+
+// cc-skill-audit — Analyze your Claude Code skills usage and token overhead
+// Zero dependencies. Reads ~/.claude/skills/ + ~/.claude/projects/ transcripts.
+//
+// Shows: skill sizes, usage frequency, prune candidates
+//
+// Usage:
+//   npx cc-skill-audit           # full report
+//   npx cc-skill-audit --top 20  # show top N skills by size
+//   npx cc-skill-audit --days 14 # look back N days for usage (default 30)
+//   npx cc-skill-audit --json    # machine-readable output
+
+import { readdir, stat, readFile } from 'node:fs/promises';
+import { createReadStream, existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { createInterface } from 'node:readline';
+
+const SKILLS_DIR = join(homedir(), '.claude', 'skills');
+const PROJECTS_DIR = join(homedir(), '.claude', 'projects');
+const CHARS_PER_TOKEN = 4; // rough approximation
+
+const C = {
+  reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+  red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m',
+  blue: '\x1b[34m', cyan: '\x1b[36m', magenta: '\x1b[35m', white: '\x1b[37m',
+};
+
+function pad(s, len, right = false) {
+  const t = String(s);
+  const p = ' '.repeat(Math.max(0, len - t.length));
+  return right ? p + t : t + p;
+}
+
+function fmtTokens(n) {
+  if (n >= 1000) return (n / 1000).toFixed(1) + 'K';
+  return String(n);
+}
+
+function tokenBar(tokens, maxTokens, width = 16) {
+  const pct = Math.min(1, tokens / maxTokens);
+  const fill = Math.round(pct * width);
+  const col = pct > 0.5 ? C.red : pct > 0.25 ? C.yellow : C.dim;
+  return col + '█'.repeat(fill) + C.reset + C.dim + '░'.repeat(width - fill) + C.reset;
+}
+
+// ── Skill discovery ──────────────────────────────────────────────────────────
+async function getSkillSize(skillDir) {
+  let totalChars = 0;
+  let files = [];
+  try {
+    files = await readdir(skillDir);
+  } catch {
+    return 0;
+  }
+  for (const f of files) {
+    if (!f.endsWith('.md') && !f.endsWith('.txt')) continue;
+    try {
+      const fp = join(skillDir, f);
+      const s = await stat(fp);
+      totalChars += s.size;
+    } catch {}
+  }
+  return totalChars;
+}
+
+async function discoverSkills() {
+  const skills = [];
+  let entries;
+  try {
+    entries = await readdir(SKILLS_DIR, { withFileTypes: true });
+  } catch {
+    return skills;
+  }
+
+  for (const e of entries) {
+    if (e.name.startsWith('.')) continue;
+    let skillDir;
+    if (e.isSymbolicLink()) {
+      // resolve symlink
+      try {
+        const full = join(SKILLS_DIR, e.name);
+        const s = await stat(full); // follows symlink
+        if (s.isDirectory()) {
+          skillDir = full;
+        }
+      } catch { continue; }
+    } else if (e.isDirectory()) {
+      skillDir = join(SKILLS_DIR, e.name);
+    } else {
+      continue;
+    }
+    const chars = await getSkillSize(skillDir);
+    skills.push({
+      name: e.name,
+      chars,
+      tokens: Math.round(chars / CHARS_PER_TOKEN),
+    });
+  }
+  return skills;
+}
+
+// ── Index file size (always loaded as skill list) ────────────────────────────
+async function getIndexSize() {
+  const indexPath = join(SKILLS_DIR, '.index');
+  try {
+    const s = await stat(indexPath);
+    return s.size;
+  } catch {
+    return 0;
+  }
+}
+
+// ── Usage from transcripts ───────────────────────────────────────────────────
+// Look for skill invocations in .jsonl files: patterns like "/skill-name" or
+// "Skill tool" calls with skill names in the content
+async function parseTranscriptForSkills(filePath, skillNames, cutoffMs) {
+  const counts = {};
+  const rl = createInterface({ input: createReadStream(filePath), crlfDelay: Infinity });
+  for await (const line of rl) {
+    if (!line.trim()) continue;
+    let obj;
+    try { obj = JSON.parse(line); } catch { continue; }
+
+    // Check timestamp cutoff
+    const ts = obj.timestamp || obj.created_at;
+    if (ts && new Date(ts).getTime() < cutoffMs) continue;
+
+    // Look for skill invocations in content
+    // Pattern 1: Skill tool calls - {"type":"tool_use","name":"Skill","input":{"skill":"skill-name"}}
+    // Pattern 2: user messages containing "/skill-name"
+    const lineStr = line;
+
+    for (const sk of skillNames) {
+      // Tool call pattern
+      if (lineStr.includes('"Skill"') && lineStr.includes(`"${sk}"`)) {
+        counts[sk] = (counts[sk] || 0) + 1;
+        continue;
+      }
+      // User command pattern "/${sk}"
+      if (lineStr.includes(`"/${sk}"`) || lineStr.includes(`/${sk} `)) {
+        counts[sk] = (counts[sk] || 0) + 1;
+      }
+    }
+  }
+  return counts;
+}
+
+async function collectUsage(skillNames, lookbackDays) {
+  const cutoff = Date.now() - lookbackDays * 24 * 60 * 60 * 1000;
+  const totalCounts = {};
+  for (const sk of skillNames) totalCounts[sk] = 0;
+
+  try {
+    const projects = await readdir(PROJECTS_DIR);
+    for (const proj of projects) {
+      const dir = join(PROJECTS_DIR, proj);
+      let files;
+      try { files = await readdir(dir); } catch { continue; }
+      for (const f of files) {
+        if (!f.endsWith('.jsonl')) continue;
+        const fp = join(dir, f);
+        // Quick size check — skip tiny files
+        try {
+          const s = await stat(fp);
+          if (s.size < 100) continue;
+          // Also check mtime for efficiency
+          if (s.mtimeMs < cutoff) continue;
+        } catch { continue; }
+        const counts = await parseTranscriptForSkills(fp, skillNames, cutoff);
+        for (const [sk, c] of Object.entries(counts)) {
+          totalCounts[sk] = (totalCounts[sk] || 0) + c;
+        }
+      }
+    }
+  } catch {}
+  return totalCounts;
+}
+
+// ── Render ────────────────────────────────────────────────────────────────────
+function renderReport(skills, usageCounts, indexChars, opts) {
+  const { topN, lookbackDays, jsonMode } = opts;
+  const indexTokens = Math.round(indexChars / CHARS_PER_TOKEN);
+  const totalSkillTokens = skills.reduce((s, sk) => s + sk.tokens, 0);
+
+  // Enrich with usage
+  const enriched = skills.map(sk => ({
+    ...sk,
+    usage: usageCounts[sk.name] || 0,
+  }));
+
+  if (jsonMode) {
+    const out = {
+      generated_at: new Date().toISOString(),
+      summary: {
+        skill_count: skills.length,
+        index_tokens: indexTokens,
+        total_content_tokens: totalSkillTokens,
+        lookback_days: lookbackDays,
+      },
+      skills: enriched.sort((a, b) => b.tokens - a.tokens),
+    };
+    console.log(JSON.stringify(out, null, 2));
+    return;
+  }
+
+  const W = 60;
+  const div = C.dim + '─'.repeat(W) + C.reset;
+  const lines = [];
+
+  lines.push('');
+  lines.push(`  ${C.bold}cc-skill-audit${C.reset}  ${C.dim}Skill token overhead analyzer${C.reset}`);
+  lines.push('  ' + div);
+  lines.push('');
+
+  // Summary
+  lines.push(`  ${C.dim}Summary${C.reset}`);
+  lines.push(`  Skills installed    ${pad(String(skills.length), 6, true)}`);
+  lines.push(`  Index overhead      ${pad(fmtTokens(indexTokens) + ' tokens', 12, true)}  ${C.dim}(loaded every session)${C.reset}`);
+  lines.push(`  Total content       ${pad(fmtTokens(totalSkillTokens) + ' tokens', 12, true)}  ${C.dim}(loaded on invocation)${C.reset}`);
+  lines.push(`  Usage lookback      ${pad(String(lookbackDays) + ' days', 12, true)}`);
+  lines.push('');
+
+  // Sort by size descending
+  const bySize = [...enriched].sort((a, b) => b.tokens - a.tokens);
+  const shown = bySize.slice(0, topN);
+  const maxTok = shown[0]?.tokens || 1;
+
+  lines.push(`  ${C.dim}Top ${shown.length} skills by size${C.reset}  ${C.dim}(${lookbackDays}d usage)${C.reset}`);
+  lines.push(`  ${C.dim}${'Skill'.padEnd(28)} ${'Tokens'.padStart(7)}  ${'Use'.padStart(4)}  Bar${C.reset}`);
+  lines.push('  ' + div);
+
+  for (const sk of shown) {
+    const usageStr = sk.usage === 0
+      ? C.red + pad('0', 4, true) + C.reset
+      : C.green + pad(String(sk.usage), 4, true) + C.reset;
+    const b = tokenBar(sk.tokens, maxTok, 14);
+    const nameCol = sk.tokens > 10000
+      ? C.yellow + pad(sk.name, 28) + C.reset
+      : pad(sk.name, 28);
+    lines.push(`  ${nameCol} ${pad(fmtTokens(sk.tokens), 7, true)}  ${usageStr}  ${b}`);
+  }
+  lines.push('');
+
+  // Prune candidates: tokens > 5K AND usage == 0
+  const pruneCandidates = enriched
+    .filter(sk => sk.tokens > 5000 && sk.usage === 0)
+    .sort((a, b) => b.tokens - a.tokens);
+
+  if (pruneCandidates.length > 0) {
+    const savedTokens = pruneCandidates.reduce((s, sk) => s + sk.tokens, 0);
+    lines.push(`  ${C.yellow}${C.bold}Prune candidates${C.reset}  ${C.dim}(>5K tokens, 0 uses in ${lookbackDays}d)${C.reset}`);
+    lines.push(`  ${C.dim}Removing these would save ~${fmtTokens(savedTokens)} tokens when invoked${C.reset}`);
+    for (const sk of pruneCandidates.slice(0, 10)) {
+      lines.push(`  ${C.red}✗${C.reset}  ${pad(sk.name, 30)} ${C.dim}${fmtTokens(sk.tokens)} tokens${C.reset}`);
+    }
+    lines.push('');
+  }
+
+  // Zero-usage count
+  const zeroUsage = enriched.filter(sk => sk.usage === 0);
+  const usedCount = enriched.filter(sk => sk.usage > 0).length;
+  lines.push(`  ${C.dim}Active (used in ${lookbackDays}d):${C.reset}  ${C.green}${usedCount}${C.reset} / ${skills.length}`);
+  if (zeroUsage.length > 0) {
+    lines.push(`  ${C.dim}Never used in ${lookbackDays}d:${C.reset}  ${C.yellow}${zeroUsage.length}${C.reset} skills`);
+  }
+  lines.push('');
+  lines.push(`  ${C.dim}Note: Content tokens only load when a skill is invoked.${C.reset}`);
+  lines.push(`  ${C.dim}Index tokens load every session (name + description list).${C.reset}`);
+  lines.push('');
+
+  console.log(lines.join('\n'));
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+const topIdx = args.indexOf('--top');
+const topN = topIdx >= 0 ? parseInt(args[topIdx + 1]) || 20 : 20;
+const daysIdx = args.indexOf('--days');
+const lookbackDays = daysIdx >= 0 ? parseInt(args[daysIdx + 1]) || 30 : 30;
+const jsonMode = args.includes('--json');
+
+(async () => {
+  if (!jsonMode) {
+    process.stdout.write(C.dim + '  Scanning skills...\r' + C.reset);
+  }
+  const [skills, indexChars] = await Promise.all([
+    discoverSkills(),
+    getIndexSize(),
+  ]);
+
+  if (!jsonMode) {
+    process.stdout.write(C.dim + `  Analyzing usage (last ${lookbackDays} days)...\r` + C.reset);
+  }
+  const skillNames = skills.map(s => s.name);
+  const usageCounts = await collectUsage(skillNames, lookbackDays);
+
+  if (!jsonMode) {
+    process.stdout.write(' '.repeat(50) + '\r'); // clear progress line
+  }
+
+  renderReport(skills, usageCounts, indexChars, { topN, lookbackDays, jsonMode });
+})();

package/index.html

@@ -0,0 +1,160 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>cc-skill-audit — Claude Code Skill Analyzer</title>
+<meta name="description" content="Audit your Claude Code skills: token overhead, usage frequency, prune candidates. Zero dependencies.">
+<style>
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    background: #0d1117;
+    color: #e6edf3;
+    font-family: 'SF Mono', 'Fira Code', monospace;
+    min-height: 100vh;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    padding: 40px 16px;
+  }
+  .container { max-width: 680px; width: 100%; }
+  h1 { font-size: 1.5rem; color: #58a6ff; margin-bottom: 4px; }
+  .tagline { color: #8b949e; font-size: 0.85rem; margin-bottom: 32px; }
+  .terminal {
+    background: #161b22;
+    border: 1px solid #30363d;
+    border-radius: 8px;
+    padding: 24px;
+    font-size: 0.82rem;
+    line-height: 1.7;
+  }
+  .prompt { color: #58a6ff; }
+  .dim { color: #6e7681; }
+  .green { color: #3fb950; }
+  .yellow { color: #d29922; }
+  .red { color: #f85149; }
+  .cyan { color: #39c5cf; }
+  .bold { font-weight: 700; }
+  .bar-fill { color: #3fb950; }
+  .bar-warn { color: #d29922; }
+  .bar-danger { color: #f85149; }
+  .bar-empty { color: #30363d; }
+  hr.div { border: none; border-top: 1px solid #30363d; margin: 12px 0; }
+  .install {
+    background: #161b22;
+    border: 1px solid #30363d;
+    border-radius: 8px;
+    padding: 16px 24px;
+    margin: 24px 0;
+    display: flex;
+    align-items: center;
+    gap: 12px;
+  }
+  .install code { color: #79c0ff; font-size: 1rem; flex: 1; }
+  .copy-btn {
+    background: #21262d;
+    border: 1px solid #30363d;
+    color: #c9d1d9;
+    padding: 6px 14px;
+    border-radius: 6px;
+    cursor: pointer;
+    font-size: 0.8rem;
+    font-family: inherit;
+    transition: background 0.15s;
+  }
+  .copy-btn:hover { background: #30363d; }
+  .flags { margin-top: 24px; }
+  .flag { display: flex; gap: 12px; padding: 4px 0; }
+  .flag-name { color: #79c0ff; min-width: 200px; }
+  .flag-desc { color: #8b949e; }
+  .links { margin-top: 32px; display: flex; gap: 16px; flex-wrap: wrap; }
+  .links a {
+    color: #58a6ff;
+    text-decoration: none;
+    font-size: 0.85rem;
+    padding: 6px 14px;
+    border: 1px solid #30363d;
+    border-radius: 6px;
+    transition: border-color 0.15s;
+  }
+  .links a:hover { border-color: #58a6ff; }
+  footer { margin-top: 40px; color: #6e7681; font-size: 0.75rem; text-align: center; }
+</style>
+</head>
+<body>
+<div class="container">
+  <h1>cc-skill-audit</h1>
+  <p class="tagline">Audit your Claude Code skills — token overhead, usage frequency, prune candidates</p>
+
+  <div class="install">
+    <code id="cmd">npx cc-skill-audit</code>
+    <button class="copy-btn" onclick="copyCmd()">Copy</button>
+  </div>
+
+  <div class="terminal">
+    <div><span class="prompt">❯</span> <span class="dim">npx cc-skill-audit</span></div>
+    <br>
+    <div><span class="bold cyan">cc-skill-audit</span>  <span class="dim">Skill token overhead analyzer</span></div>
+    <hr class="div">
+    <div><span class="dim">Summary</span></div>
+    <div>Skills installed        <span class="bold">109</span></div>
+    <div>Index overhead      <span class="bold">2.3K tokens</span>  <span class="dim">(loaded every session)</span></div>
+    <div>Total content     <span class="bold">348.6K tokens</span>  <span class="dim">(loaded on invocation)</span></div>
+    <div>Usage lookback         <span class="bold">30 days</span></div>
+    <br>
+    <div><span class="dim">Top 20 skills by size &nbsp;(30d usage)</span></div>
+    <div><span class="dim">Skill&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tokens &nbsp;&nbsp;Use &nbsp;Bar</span></div>
+    <hr class="div">
+    <div><span class="yellow">writing-skills&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span> &nbsp;21.7K &nbsp;<span class="red">&nbsp;&nbsp; 0</span> &nbsp;<span class="bar-danger">██████████████</span></div>
+    <div><span class="yellow">pptx&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span> &nbsp;14.3K &nbsp;<span class="red">&nbsp;&nbsp; 0</span> &nbsp;<span class="bar-danger">█████████</span><span class="bar-empty">░░░░░</span></div>
+    <div><span class="yellow">docx&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span> &nbsp;12.9K &nbsp;<span class="red">&nbsp;&nbsp; 0</span> &nbsp;<span class="bar-danger">████████</span><span class="bar-empty">░░░░░░</span></div>
+    <div>nano-banana-pro&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;9.2K &nbsp;<span class="green">&nbsp;&nbsp; 4</span> &nbsp;<span class="bar-warn">██████</span><span class="bar-empty">░░░░░░░░</span></div>
+    <div>playwright&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;7.6K &nbsp;<span class="green">&nbsp;&nbsp; 2</span> &nbsp;<span class="bar-warn">█████</span><span class="bar-empty">░░░░░░░░░</span></div>
+    <div><span class="dim">...</span></div>
+    <br>
+    <div><span class="yellow bold">Prune candidates</span>  <span class="dim">(&gt;5K tokens, 0 uses in 30d)</span></div>
+    <div><span class="dim">Removing these would save ~82.2K tokens when invoked</span></div>
+    <div><span class="red">✗</span>  writing-skills &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="dim">21.7K tokens</span></div>
+    <div><span class="red">✗</span>  pptx &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="dim">14.3K tokens</span></div>
+    <div><span class="red">✗</span>  docx &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="dim">12.9K tokens</span></div>
+    <br>
+    <div><span class="dim">Active (used in 30d):</span>  <span class="green">45</span> / 109</div>
+    <div><span class="dim">Never used in 30d:</span>  <span class="yellow">64</span> skills</div>
+  </div>
+
+  <div class="flags">
+    <p class="dim" style="margin-bottom: 12px;">Options</p>
+    <div class="flag">
+      <span class="flag-name">--top &lt;N&gt;</span>
+      <span class="flag-desc">Show top N skills by size (default: 20)</span>
+    </div>
+    <div class="flag">
+      <span class="flag-name">--days &lt;N&gt;</span>
+      <span class="flag-desc">Lookback window for usage (default: 30)</span>
+    </div>
+    <div class="flag">
+      <span class="flag-name">--json</span>
+      <span class="flag-desc">Machine-readable JSON output</span>
+    </div>
+  </div>
+
+  <div class="links">
+    <a href="https://www.npmjs.com/package/cc-skill-audit" target="_blank">npm</a>
+    <a href="https://github.com/yurukusa/cc-skill-audit" target="_blank">GitHub</a>
+    <a href="https://yurukusa.github.io/cc-toolkit/" target="_blank">cc-toolkit</a>
+  </div>
+
+  <footer>Part of <a href="https://yurukusa.github.io/cc-toolkit/" style="color:#58a6ff;text-decoration:none">cc-toolkit</a> — Claude Code utilities by <a href="https://zenn.dev/yurukusa" style="color:#58a6ff;text-decoration:none">yurukusa</a></footer>
+</div>
+
+<script>
+function copyCmd() {
+  navigator.clipboard.writeText('npx cc-skill-audit').then(() => {
+    const btn = document.querySelector('.copy-btn');
+    btn.textContent = 'Copied!';
+    setTimeout(() => btn.textContent = 'Copy', 2000);
+  });
+}
+</script>
+</body>
+</html>

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "cc-skill-audit",
+  "version": "1.0.0",
+  "description": "Audit your Claude Code skills: token overhead, usage frequency, prune candidates",
+  "type": "module",
+  "bin": {
+    "cc-skill-audit": "cli.mjs"
+  },
+  "scripts": {
+    "start": "node cli.mjs"
+  },
+  "keywords": ["claude", "claude-code", "ai", "skills", "audit", "token", "optimization"],
+  "author": "yurukusa",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yurukusa/cc-skill-audit"
+  }
+}