feat: minify skill scripts and strip console output at build time

Inspired by https://justin.poehnelt.com/posts/rewrite-your-cli-for-ai-agents/
— skill scripts are now generated agent-first: no human-readable console
output, no comments, minimal token footprint.

- generate-skills.js now calls terser instead of copyFileSync
  - drop_console: true removes all console.* calls
  - mangle + no comments produces a single minified line per script
  - fallback to raw copy if minification fails (never breaks the build)
- Each generated script gets a one-line header:
    // snippets/<Category>/<file>.js | sha256:<16-char> | <github-url>
  SHA-256 is computed from the original source, allowing verification
  that the minified script corresponds to a specific snippet version
- terser added as devDependency

Author: nucliweb

package.json

@@ -33,6 +33,7 @@
   },
   "devDependencies": {
     "eslint": "^10.0.2",
+    "terser": "^5.36.0",
     "vercel": "^32.4.1"
   },
   "overrides": {

scripts/generate-skills.js

@@ -8,6 +8,10 @@
 
 const fs = require('fs')
 const path = require('path')
+const { createHash } = require('crypto')
+const { minify } = require('terser')
+
+const GITHUB_BASE = 'https://github.com/nucliweb/webperf-snippets/blob/main'
 
 const ROOT = path.join(__dirname, '..')
 const SNIPPETS_DIR = path.join(ROOT, 'snippets')
@@ -48,6 +52,28 @@ const CATEGORIES = {
   },
 }
 
+async function buildScript(src, dst, relPath) {
+  const source = fs.readFileSync(src, 'utf-8')
+  const hash = createHash('sha256').update(source).digest('hex').slice(0, 16)
+  const githubUrl = `${GITHUB_BASE}/${relPath}`
+  const header = `// ${relPath} | sha256:${hash} | ${githubUrl}\n`
+
+  let code
+  try {
+    const result = await minify(source, {
+      compress: { drop_console: true },
+      mangle: true,
+      format: { comments: false },
+    })
+    code = result.code
+  } catch (err) {
+    console.warn(`  ⚠ minify failed for ${path.basename(src)}: ${err.message} — copying as-is`)
+    code = source
+  }
+
+  fs.writeFileSync(dst, header + code)
+}
+
 function getSnippetFiles(category) {
   const dir = path.join(SNIPPETS_DIR, category)
   if (!fs.existsSync(dir)) return []
@@ -185,7 +211,7 @@ function buildSnippetMeta(category, snippetFile) {
   }
 }
 
-function generateCategorySkill(category, catConfig) {
+async function generateCategorySkill(category, catConfig) {
   const snippetFiles = getSnippetFiles(category)
   if (snippetFiles.length === 0) return
 
@@ -200,9 +226,9 @@ function generateCategorySkill(category, catConfig) {
   for (const snippetFile of snippetFiles) {
     const src = path.join(SNIPPETS_DIR, category, snippetFile)
     const dst = path.join(scriptsDir, snippetFile)
-    fs.copyFileSync(src, dst)
+    await buildScript(src, dst, `snippets/${category}/${snippetFile}`)
   }
-  console.log(`  copied ${snippetFiles.length} scripts to scripts/`)
+  console.log(`  built ${snippetFiles.length} scripts to scripts/`)
 
   const lines = []
 
@@ -357,7 +383,7 @@ function validateSkill(name, description) {
   return errors
 }
 
-function main() {
+async function main() {
   console.log('Generating WebPerf skills...\n')
   fs.mkdirSync(SKILLS_DIR, { recursive: true })
 
@@ -378,7 +404,7 @@ function main() {
   }
 
   for (const [category, config] of Object.entries(CATEGORIES)) {
-    generateCategorySkill(category, config)
+    await generateCategorySkill(category, config)
   }
 
   generateMetaSkill()
@@ -410,4 +436,4 @@ function main() {
   console.log('\nDone! Skills generated in /skills/ and .claude/skills/')
 }
 
-main()
+main().catch(console.error)