Function gatherSkillText

src/skills/installer.ts:289–325

* Concatenate the skill's scannable text — SKILL.md plus any support files whose * content the agent might read or execute (.md/.txt/.sh/.bash/.zsh/.py/.js/.ts/.rb/ * .pl/.ps1/.yaml/.yml/.json). Binary and large files are skipped; total is capped * so a giant repo can't blow up memory. Best-effor

(root: string)

 * so a giant repo can't blow up memory. Best-effort: unreadable files are ignored.
 */
async function gatherSkillText(root: string): Promise<string> {
  const SCAN_EXT = new Set([
    '.md', '.markdown', '.txt', '.sh', '.bash', '.zsh', '.fish', '.py', '.js', '.mjs',
    '.cjs', '.ts', '.rb', '.pl', '.ps1', '.yaml', '.yml', '.json', '.toml', '.env',
  ]);
  const MAX_FILE = 256 * 1024;     // 256KB per file
  const MAX_TOTAL = 2 * 1024 * 1024; // 2MB overall
  const SKIP_DIR = new Set(['.git', 'node_modules', '.github', 'dist', 'build', '__pycache__', '.venv']);
  let total = 0;
  const chunks: string[] = [];

  async function walk(dir: string): Promise<void> {
    let entries: import('fs').Dirent[];
    try { entries = await fs.readdir(dir, { withFileTypes: true }); } catch { return; }
    for (const e of entries) {
      if (total >= MAX_TOTAL) return;
      const full = path.join(dir, e.name);
      if (e.isDirectory()) {
        if (!SKIP_DIR.has(e.name)) await walk(full);
        continue;
      }
      const ext = path.extname(e.name).toLowerCase();
      // SKILL.md has no "code" ext but is always scanned; otherwise gate by ext.
      if (e.name !== 'SKILL.md' && !SCAN_EXT.has(ext)) continue;
      try {
        const stat = await fs.stat(full);
        if (stat.size > MAX_FILE) continue;
        const text = await fs.readFile(full, 'utf-8');
        chunks.push(`\n# ── ${path.relative(root, full)} ──\n${text}`);
        total += text.length;
      } catch { /* skip unreadable */ }
    }
  }

  await walk(root);
  return chunks.join('\n');
}