octocode-cli 1.5.1 → 1.5.3

package/skills/octocode-research/tsdown.config.ts

@@ -15,28 +15,23 @@ export default defineConfig({
   target: 'node20',
   platform: 'node',
 
-  // Bundle ALL dependencies for standalone execution
   noExternal: [/.*/],
 
-  // Keep Node.js built-ins and native modules external
   external: [
     ...builtinModules,
     ...builtinModules.map((m) => `node:${m}`),
   ],
 
-  // Code splitting disabled for standalone scripts
   splitting: false,
 
   treeshake: true,
   minify: true,
-  shims: true, // ESM shims for __dirname, etc.
-  dts: true, // Generate type declarations (crucial for TypeScript consumers)
+  shims: true,
+  dts: true,
   sourcemap: false,
 
-  // Output as server.js
   outExtensions: () => ({ js: '.js' }),
 
-  // Shebang for direct execution
   banner: '#!/usr/bin/env node',
 
   define: {

package/skills/octocode-search-skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: octocode-search-skill
-description: Use this skill when the user asks to find, evaluate, preview, install, rate, review, score, improve, refactor, or synthesize Agent Skills (the `SKILL.md` folder format) across GitHub, local skill folders, and skill marketplaces. Covers searching for a skill for a task, deep-diving a candidate, installing one or more skills into one or more agents at user or project scope, rating or reviewing an existing SKILL.md, refactoring a skill, or creating a new local skill from researched patterns. Do NOT activate for general package search (npm, PyPI, cargo), web search, or code research not involving SKILL.md files.
+description: Use this skill when the user asks to find, evaluate, preview, install, rate, review, score, improve, refactor, or synthesize Agent Skills (the `SKILL.md` folder format) across GitHub, local skill folders, and skill marketplaces. Covers searching for a skill for a task, deep-diving a candidate, installing one or more skills into one or more agents at user or project scope, rating or reviewing an existing SKILL.md, refactoring a skill, or creating a new local skill from researched patterns. Do NOT activate for general package search (npm, PyPI, cargo), general (non-skill) web search, or code research not involving SKILL.md files.
 ---
 
 # Octocode Search Skill
@@ -52,6 +52,7 @@ Use Octocode MCP for all research — locally and externally — and let user in
 - Lead GitHub when the user is shopping for a skill, comparing options, or asking about something not present locally.
 - Read code or files: `localGetFileContent` or `githubGetFileContent`.
 - Download a remote skill folder before writing it locally: `githubGetFileContent(type="directory")` or `githubCloneRepo`.
+- Web search: for every PUBLIC skill query, MUST also run the runtime's web search tool (e.g. `WebSearch`) in parallel with Octocode/GitHub and the skills.sh API. It catches skills surfaced in articles, awesome-lists, release notes, and registries outside the known set. Treat web-only mentions as LEADS, not recommendations — always resolve the real `(owner/repo, path-to-SKILL.md)` and confirm the actual `SKILL.md` via Octocode (`githubGetFileContent`) before recommending. Skip only for local-only or org/private scopes (Octocode tools only there).
 
 Fallbacks:
 
@@ -92,6 +93,12 @@ Set depth before searching:
 - Improve, rate, or create request: inspect the target skill, adjacent local examples, and `references/agent-skills-guide.md` before writing.
 - Weak results: broaden once, then report the gap and the next best action.
 
+For every public skill query, fan out across three surfaces IN PARALLEL, then merge and dedupe by `(owner/repo, skill name)`:
+
+1. Octocode/GitHub — code and path search for `SKILL.md` (see "Useful GitHub patterns").
+2. skills.sh Registry API — install-ranked candidates (see "Skills.sh Registry API").
+3. Web search — runtime web search tool (e.g. `WebSearch`) for the topic + "agent skill"/"claude skill"/"SKILL.md", to catch skills outside the known registries. Confirm each web lead's real `SKILL.md` via Octocode before recommending.
+
 Search angles:
 
 - Name: exact phrase, lowercase, hyphenated folder name, aliases.
@@ -112,7 +119,7 @@ Useful GitHub patterns:
 
 ### Skills.sh Registry API
 
-MUST run this in parallel with GitHub/Octocode search for every public skill query. MUST NOT use for org-specific or private searches — use Octocode tools only for those.
+MUST run this in parallel with GitHub/Octocode search AND web search for every public skill query (the three-surface fan-out above). MUST NOT use for org-specific or private searches — use Octocode tools only for those.
 
 ```bash
 curl 'https://www.skills.sh/api/search?q={{SEARCH_KEY}}&limit=100' \

package/skills/octocode-search-skill/references/discovery-surfaces.md

@@ -6,7 +6,8 @@ Use when the user wants to shop for skills beyond raw GitHub code search — mar
 
 | User goal | Best first surface |
 |-----------|--------------------|
-| "Search skills by keyword or topic" | skills.sh Registry API (`/api/search?q=...`) — sort by `installs` |
+| "Search skills by keyword or topic" | skills.sh Registry API (`/api/search?q=...`) — sort by `installs` — run in parallel with GitHub/Octocode + web search |
+| "Find skills mentioned in articles / awesome-lists / outside known registries" | Runtime web search tool (e.g. `WebSearch`): topic + "agent skill"/"claude skill"/"SKILL.md"; confirm each lead's real `SKILL.md` via Octocode |
 | "Is skill X published / battle-tested?" | `https://www.skills.sh/<owner>/<repo>/<skill-name>` |
 | "What are the most-installed skills right now?" | `https://www.skills.sh` leaderboard |
 | "Find a Claude Code plugin" | `claude-plugins.dev` (REST + UI) |

package/skills/octocode-slides/scripts/navbridge.js

@@ -10,7 +10,7 @@
  * Each slide includes: <script src="../js/navbridge.js"></script>
  */
 (function () {
-  if (window.parent === window) return; // standalone, not embedded
+  if (window.parent === window) return;
 
   var NAV_KEYS = {
     ArrowLeft: 1, ArrowRight: 1, ArrowUp: 1, ArrowDown: 1,
@@ -50,24 +50,11 @@
     e.preventDefault();
   }, true);
 
-  // Forward mouse activity so the parent HUD wakes back up
   document.addEventListener('mousemove', function () {
     try { window.parent.postMessage({ type: 'octocode-slides:activity' }, '*'); }
     catch (_) {}
   }, { passive: true });
 
-  // ── Step-animation back-channel ─────────────────────────────────────────
-  // The parent forwards nav keys here (instead of navigating immediately) so
-  // animation.js gets first refusal on each keystroke, even when the parent
-  // window has focus. We dispatch a synthetic keydown on the slide's document:
-  //   • animation.js (capture, registered first) intercepts — if a step is
-  //     pending it calls stopImmediatePropagation, navbridge's own listener
-  //     never fires, no postMessage goes back, parent stays on this slide.
-  //   • If animation.js has nothing left to consume the event falls through to
-  //     navbridge's keydown listener, which posts back to the parent, and the
-  //     parent's message handler calls handleKey(passthrough:true) → navigate.
-  // Slides without animation.js: the synthetic event reaches navbridge's
-  // listener directly and posts back immediately — no delay, no hang.
   window.addEventListener('message', function (event) {
     var data = event.data;
     if (!data || data.type !== 'octocode-slides:key' || !data.key) return;

package/skills/octocode-slides/scripts/presenter.js

@@ -1,32 +1,4 @@
-/**
- * Octocode Slides — Presenter View
- *
- * Press P in the generated deck shell to open the presenter popup.
- *
- * The popup shows:
- *   - Current slide live preview (scaled iframe)
- *   - Next slide live preview (scaled iframe)
- *   - Speaker notes
- *   - Running timer (persisted across page refreshes via localStorage)
- *   - Jump-to-slide control (updates the main deck window)
- *
- * Requires same-origin serving (npx serve works; file:// does not).
- * The default scripts/base.html template already loads and wires this file;
- * custom index.html files should copy that integration instead of inventing
- * a second keyboard handler.
- *
- * Expected call site in index.html:
- *
- *   initPresenter(
- *     () => stage.querySelector('.slide-frame[data-active]'),
- *     playable,
- *     () => current
- *   );
- */
 function initPresenter(getActiveFrame, playable, getCurrentIndex) {
-  // ── localStorage key — scoped to this deck (title + pathname) ───────────
-  // Survives page refreshes on localhost so the timer keeps running while
-  // you edit slides. Cleared on "Reset timer" or when the deck changes.
   var LS_KEY = 'octocode-slides:timer:' +
     (document.title || 'deck') + ':' + location.pathname;
 
@@ -35,7 +7,6 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
   var timerRef  = null;
   var startTime = null;
 
-  // ── Restore timer across page refreshes ─────────────────────────────────
   (function restoreTimer() {
     try {
       var saved = localStorage.getItem(LS_KEY);
@@ -49,12 +20,6 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
     } catch (_) {}
   })();
 
-  // ── Popup HTML ───────────────────────────────────────────────────────────
-  // Layout (4-row grid):
-  //   topbar   — slide name (left) + running timer (right)
-  //   previews — current slide iframe + next slide iframe (two columns)
-  //   notes    — scrollable speaker notes (fills remaining height)
-  //   bottom   — jump-to-slide input · Reset timer · Close
   var POPUP_HTML =
     '<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8">' +
     '<title>Presenter View</title><style>' +
@@ -133,7 +98,6 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
     '</div>' +
 
     '<script>' +
-    // Scale preview iframes to fill their boxes (slides are 1280×720)
     'function updateScale(){' +
     '  ["curr","next"].forEach(function(id){' +
     '    var box=document.getElementById(id+"-box");' +
@@ -146,26 +110,21 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
     '}' +
     'window.addEventListener("resize",updateScale);' +
 
-    // Receive state updates from the deck window
     'window.addEventListener("message",function(e){' +
     '  var d=e.data;if(!d||d.type!=="octocode-slides:presenter-update")return;' +
 
-    // Notes
     '  var nEl=document.getElementById("notes");' +
     '  if(d.notes){nEl.textContent=d.notes;nEl.className=""}' +
     '  else{nEl.textContent="(no speaker notes)";nEl.className="empty"}' +
 
-    // Slide name
     '  document.getElementById("slide-name").textContent=d.name||"\u2014";' +
 
-    // Jump control
     '  if(typeof d.totalSlides==="number"){' +
     '    document.getElementById("jump-total").textContent="/ "+d.totalSlides;' +
     '    document.getElementById("jump-input").max=d.totalSlides;' +
     '    document.getElementById("jump-input").value=(d.currentIndex||0)+1;' +
     '  }' +
 
-    // Current slide preview
     '  var cBox=document.getElementById("curr-box");' +
     '  if(d.currUrl){' +
     '    var cf=cBox.querySelector("iframe");' +
@@ -175,7 +134,6 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
     '    }' +
     '  }' +
 
-    // Next slide preview
     '  var nBox=document.getElementById("next-box");' +
     '  if(d.nextUrl){' +
     '    var nf=nBox.querySelector("iframe");' +
@@ -188,7 +146,6 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
     '  }' +
     '});' +
 
-    // Jump-to-slide: send index to opener so deck navigates
     'document.getElementById("jump-input").addEventListener("change",function(){' +
     '  var n=parseInt(this.value,10);if(!isFinite(n))return;' +
     '  window.opener&&window.opener.postMessage(' +
@@ -201,10 +158,8 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
     'document.getElementById("btn-close").onclick=function(){window.close()};' +
     '<\/script></body></html>';
 
-  // ── Timer ───────────────────────────────────────────────────────────────
   function startTimer() {
     if (!startTime) startTime = Date.now() - elapsed * 1000;
-    // Persist start time so a page refresh doesn't reset the clock
     try { localStorage.setItem(LS_KEY, JSON.stringify({ startTime: startTime })); }
     catch (_) {}
 
@@ -222,7 +177,6 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
     }, 1000);
   }
 
-  // ── Read speaker notes from active iframe ───────────────────────────────
   function readNotes(frame) {
     try {
       var el = frame && frame.contentDocument &&
@@ -243,17 +197,12 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
     }
   }
 
-  // ── Push update to popup ────────────────────────────────────────────────
-  // Sends: slide names, speaker notes, slide URLs (for live previews),
-  //        total count and current index (for jump control).
   function push() {
     if (!win || win.closed) return;
     var idx      = getCurrentIndex();
     var curr     = playable[idx];
     var next     = playable[idx + 1];
     var frame    = getActiveFrame();
-    // Compute absolute base URL so iframe srcs work in the popup window
-    // (popup is opened with '', so relative URLs would not resolve).
     var deckBase = location.href.replace(/[^\/]*$/, '');
 
     function doSend() {
@@ -276,7 +225,6 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
     }
   }
 
-  // ── Open popup ──────────────────────────────────────────────────────────
   function open() {
     if (win && !win.closed) { win.focus(); return; }
     win = window.open('', 'octocode-presenter',
@@ -285,32 +233,25 @@ function initPresenter(getActiveFrame, playable, getCurrentIndex) {
     win.document.open();
     win.document.write(POPUP_HTML);
     win.document.close();
-    // startTimer picks up startTime from localStorage restore if already running
     startTimer();
-    setTimeout(push, 200); // let popup render first
+    setTimeout(push, 200);
   }
 
-  // ── Listen for messages from popup ──────────────────────────────────────
   window.addEventListener('message', function (e) {
     if (!e.data) return;
     if (e.data.type === 'octocode-slides:presenter-reset') {
       elapsed = 0;
       startTime = Date.now();
-      // Clear persisted timer so a refresh after reset starts from 00:00
       try { localStorage.removeItem(LS_KEY); } catch (_) {}
-      // Re-persist the fresh start time
       try { localStorage.setItem(LS_KEY, JSON.stringify({ startTime: startTime })); }
       catch (_) {}
     }
   });
 
-  // ── Slide change hook ───────────────────────────────────────────────────
-  // Call push() whenever the slide changes.
-  // index.html should call presenter.onSlideChange() after go().
   return {
     open: open,
     push: push,
-    /** Call this after go() in index.html to update the popup. */
+    
     onSlideChange: push
   };
 }

package/skills/octocode-stats/scripts/build_dashboard.mjs

@@ -1,18 +1,5 @@
 #!/usr/bin/env node
-/**
- * build_dashboard.mjs
- *
- * Read Octocode MCP `stats.json`, pre-compute every dashboard metric, embed the
- * resulting JSON into the HTML template, write the result to disk, and
- * optionally open it in the default browser.
- *
- * Schema source of truth:
- *   packages/octocode-shared/src/session/schemas.ts
- *
- * Usage:
- *   node build_dashboard.mjs [--stats <path>] [--output <path>]
- *                            [--template <path>] [--no-open] [--allow-empty]
- */
+
 
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
 import { resolve, dirname, join, isAbsolute } from 'node:path';
@@ -23,9 +10,6 @@ import { spawn } from 'node:child_process';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-// Universal heuristic used by OpenAI / Anthropic tokenizers (~4 chars per token
-// for English text and code). Actual token usage varies by model and content —
-// surfaced as an explicit disclaimer on the dashboard.
 const TOKEN_CHAR_RATIO = 4;
 const TOKEN_ESTIMATE_NOTE =
   `Token counts are estimated at ~${TOKEN_CHAR_RATIO} chars per token. ` +
@@ -136,7 +120,6 @@ function readStats(statsPath, allowEmpty) {
 }
 
 function readSessionMeta(statsPath) {
-  // session.json lives next to stats.json in OCTOCODE_HOME
   const sessionPath = join(dirname(statsPath), 'session.json');
   if (!existsSync(sessionPath)) return null;
   try {
@@ -324,7 +307,6 @@ function injectData(template, data) {
         `Confirm the template file is the one shipped with this skill.`
     );
   }
-  // JSON.stringify never produces </script>, but we still defend against it.
   const json = JSON.stringify(data).replace(/</g, '\\u003c');
   return template.replace(SENTINEL, json);
 }