refactor the skills to reduce tokens and improve progresive disclousure patterns

Author: Cesar-M-Diaz

.claude-plugin/plugin.json

@@ -13,19 +13,20 @@
   "skills": [
     "./skills/ns-advanced-memory-leak-hunter",
     "./skills/ns-analyze-asset",
-    "./skills/ns-analyze-cpu",
     "./skills/ns-analyze-event",
-    "./skills/ns-analyze-memory",
     "./skills/ns-analyze-tracing",
     "./skills/ns-analyze-vulnerabilities",
     "./skills/ns-audit-dependencies",
     "./skills/ns-benchmark-run",
-    "./skills/ns-benchmark-validate",
+    "./skills/ns-cpu-spike-analysis",
     "./skills/ns-generate-asset",
     "./skills/ns-generate-sbom",
+    "./skills/ns-memory-spike-analysis",
     "./skills/ns-node-upgrade",
+    "./skills/ns-optimize-function",
     "./skills/ns-replace-package",
-    "./skills/ns-upgrade-package"
+    "./skills/ns-upgrade-package",
+    "./skills/ns-validate-optimization"
   ],
   "mcpServers": "./.claude-mcp.json"
 }

bundle.json

@@ -15,24 +15,12 @@
       "description": "Load and analyze N|Solid saved assets (CPU profiles, heap snapshots)",
       "requiresMcp": ["nsolid-console"]
     },
-    {
-      "name": "ns-analyze-cpu",
-      "path": "skills/ns-analyze-cpu",
-      "description": "Profile CPU usage of running production processes to identify bottlenecks",
-      "requiresMcp": ["nsolid-console"]
-    },
     {
       "name": "ns-analyze-event",
       "path": "skills/ns-analyze-event",
       "description": "Analyze event loop delays and identify blocking operations in production",
       "requiresMcp": ["nsolid-console"]
     },
-    {
-      "name": "ns-analyze-memory",
-      "path": "skills/ns-analyze-memory",
-      "description": "Take and analyze heap snapshots of running production memory",
-      "requiresMcp": ["nsolid-console"]
-    },
     {
       "name": "ns-analyze-tracing",
       "path": "skills/ns-analyze-tracing",
@@ -58,10 +46,10 @@
       "requiresMcp": ["ns-benchmark"]
     },
     {
-      "name": "ns-benchmark-validate",
-      "path": "skills/ns-benchmark-validate",
-      "description": "Validate benchmark results against established performance baselines",
-      "requiresMcp": ["ns-benchmark"]
+      "name": "ns-cpu-spike-analysis",
+      "path": "skills/ns-cpu-spike-analysis",
+      "description": "Profile CPU usage of running production processes to identify bottlenecks",
+      "requiresMcp": ["nsolid-console"]
     },
     {
       "name": "ns-generate-asset",
@@ -75,12 +63,23 @@
       "description": "Generate Software Bill of Materials for project dependency provenance",
       "requiresMcp": ["ncm"]
     },
+    {
+      "name": "ns-memory-spike-analysis",
+      "path": "skills/ns-memory-spike-analysis",
+      "description": "Take and analyze heap snapshots of running production memory",
+      "requiresMcp": ["nsolid-console"]
+    },
     {
       "name": "ns-node-upgrade",
       "path": "skills/ns-node-upgrade",
       "description": "Plan and execute Node.js version upgrades safely",
       "requiresMcp": ["ncm"]
     },
+    {
+      "name": "ns-optimize-function",
+      "path": "skills/ns-optimize-function",
+      "description": "Optimize a selected Node.js function: assess impact, benchmark baseline, propose and validate an optimization"
+    },
     {
       "name": "ns-replace-package",
       "path": "skills/ns-replace-package",
@@ -92,6 +91,12 @@
       "path": "skills/ns-upgrade-package",
       "description": "Safely upgrade npm packages with compatibility analysis",
       "requiresMcp": ["ncm"]
+    },
+    {
+      "name": "ns-validate-optimization",
+      "path": "skills/ns-validate-optimization",
+      "description": "Validate benchmark results against established performance baselines",
+      "requiresMcp": ["ns-benchmark"]
     }
   ],
   "mcpServers": [

packages/core/bundle.json

@@ -15,24 +15,12 @@
       "description": "Load and analyze N|Solid saved assets (CPU profiles, heap snapshots)",
       "requiresMcp": ["nsolid-console"]
     },
-    {
-      "name": "ns-analyze-cpu",
-      "path": "skills/ns-analyze-cpu",
-      "description": "Profile CPU usage of running production processes to identify bottlenecks",
-      "requiresMcp": ["nsolid-console"]
-    },
     {
       "name": "ns-analyze-event",
       "path": "skills/ns-analyze-event",
       "description": "Analyze event loop delays and identify blocking operations in production",
       "requiresMcp": ["nsolid-console"]
     },
-    {
-      "name": "ns-analyze-memory",
-      "path": "skills/ns-analyze-memory",
-      "description": "Take and analyze heap snapshots of running production memory",
-      "requiresMcp": ["nsolid-console"]
-    },
     {
       "name": "ns-analyze-tracing",
       "path": "skills/ns-analyze-tracing",
@@ -58,10 +46,10 @@
       "requiresMcp": ["ns-benchmark"]
     },
     {
-      "name": "ns-benchmark-validate",
-      "path": "skills/ns-benchmark-validate",
-      "description": "Validate benchmark results against established performance baselines",
-      "requiresMcp": ["ns-benchmark"]
+      "name": "ns-cpu-spike-analysis",
+      "path": "skills/ns-cpu-spike-analysis",
+      "description": "Profile CPU usage of running production processes to identify bottlenecks",
+      "requiresMcp": ["nsolid-console"]
     },
     {
       "name": "ns-generate-asset",
@@ -75,12 +63,23 @@
       "description": "Generate Software Bill of Materials for project dependency provenance",
       "requiresMcp": ["ncm"]
     },
+    {
+      "name": "ns-memory-spike-analysis",
+      "path": "skills/ns-memory-spike-analysis",
+      "description": "Take and analyze heap snapshots of running production memory",
+      "requiresMcp": ["nsolid-console"]
+    },
     {
       "name": "ns-node-upgrade",
       "path": "skills/ns-node-upgrade",
       "description": "Plan and execute Node.js version upgrades safely",
       "requiresMcp": ["ncm"]
     },
+    {
+      "name": "ns-optimize-function",
+      "path": "skills/ns-optimize-function",
+      "description": "Optimize a selected Node.js function: assess impact, benchmark baseline, propose and validate an optimization"
+    },
     {
       "name": "ns-replace-package",
       "path": "skills/ns-replace-package",
@@ -92,6 +91,12 @@
       "path": "skills/ns-upgrade-package",
       "description": "Safely upgrade npm packages with compatibility analysis",
       "requiresMcp": ["ncm"]
+    },
+    {
+      "name": "ns-validate-optimization",
+      "path": "skills/ns-validate-optimization",
+      "description": "Validate benchmark results against established performance baselines",
+      "requiresMcp": ["ns-benchmark"]
     }
   ],
   "mcpServers": [

packages/core/scripts/skill-assets.manifest.json

@@ -2,23 +2,24 @@
   "wait.cjs": [
     "ns-advanced-memory-leak-hunter",
     "ns-analyze-asset",
-    "ns-analyze-cpu",
-    "ns-analyze-memory",
     "ns-benchmark-run",
-    "ns-benchmark-validate"
+    "ns-cpu-spike-analysis",
+    "ns-generate-asset",
+    "ns-memory-spike-analysis",
+    "ns-validate-optimization"
   ],
   "save-report.cjs": [
     "ns-advanced-memory-leak-hunter",
     "ns-analyze-asset",
-    "ns-analyze-cpu",
     "ns-analyze-event",
-    "ns-analyze-memory",
     "ns-benchmark-run",
-    "ns-benchmark-validate"
+    "ns-cpu-spike-analysis",
+    "ns-memory-spike-analysis",
+    "ns-validate-optimization"
   ],
   "fetch-asset.cjs": [
     "ns-advanced-memory-leak-hunter",
-    "ns-analyze-cpu",
-    "ns-analyze-memory"
+    "ns-cpu-spike-analysis",
+    "ns-memory-spike-analysis"
   ]
 }

packages/pi-plugin/test/manifest.test.ts

@@ -33,7 +33,7 @@ describe('Pi plugin', () => {
   it('uses canonical root skills instead of committed package skill copies', () => {
     assert.strictEqual(existsSync(path.resolve('packages/pi-plugin/skills')), false, 'source tree should not keep generated package skill copies')
     assert.strictEqual(existsSync(path.resolve('packages/core/skills')), false, 'source tree should not keep generated core package skill copies')
-    assert.ok(existsSync(path.resolve('skills/ns-analyze-cpu/SKILL.md')), 'canonical root skill must exist')
+    assert.ok(existsSync(path.resolve('skills/ns-analyze-asset/SKILL.md')), 'canonical root skill must exist')
   })
 
   it('index.js exists and has no install/setup side effects', () => {