fix(llms.txt): link skills by generated path, drop host-skipped skills

gen-llms-txt built every skill link as <name>/SKILL.md, so the router
pointed at a nonexistent gstack/SKILL.md (it is the root SKILL.md) and
/claude-code pointed at a SKILL.md the Claude host never generates.
Links now use the template's generated output path, and skills the
Claude host skips are left out of the index. Adopts #2279.

Co-authored-by: Nader Helmy <creator.nader@gmail.com>
Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
This commit is contained in:
committed 2026-10-08 06:16:55 +00:00
1 parent dfeae47a17
commit 6a46e8c22a
3 files changed
+19 -6

No files matched your search

+11 -4
View File
@@ -11,6 +11,10 @@
*
* Output: gstack/llms.txt at repo root.
*
* Skill links point at the Claude host's generated SKILL.md (the files this
* checkout ships). Skills the Claude host skips (claude-code) have no such
* file, so they are left out of the index rather than linked to a template.
*
* Refresh: invoked from scripts/gen-skill-docs.ts after SKILL.md generation
* so it regenerates automatically on every skill change.
*
@@ -20,7 +24,8 @@
import * as fs from 'fs';
import * as path from 'path';
import { mkdirpSync } from '../lib/fs-utils';
import { discoverTemplates } from './discover-skills';
import { discoverTemplates, includesSkill } from './discover-skills';
import claudeHost from '../hosts/claude';
import { COMMAND_DESCRIPTIONS as BROWSE_COMMANDS } from '../browse/src/commands';
const ROOT = path.resolve(import.meta.dir, '..');
@@ -29,6 +34,7 @@ const OUTPUT = path.join(ROOT, 'gstack', 'llms.txt');
interface SkillEntry {
name: string;
description: string;
output: string;
}
/**
@@ -36,7 +42,7 @@ interface SkillEntry {
* `name` and `description`. description: | followed by indented lines is
* the gstack convention; we collapse those into a single paragraph.
*/
function parseSkillFrontmatter(filePath: string): SkillEntry | null {
function parseSkillFrontmatter(filePath: string): Omit<SkillEntry, 'output'> | null {
const content = fs.readFileSync(filePath, 'utf-8');
if (!content.startsWith('---')) return null;
const end = content.indexOf('\n---', 3);
@@ -136,6 +142,7 @@ export async function generateLlmsTxt(opts: GenerateOptions = {}): Promise<Gener
const templates = discoverTemplates(root);
const skills: SkillEntry[] = [];
for (const t of templates) {
if (!includesSkill(claudeHost, path.dirname(t.tmpl))) continue;
const filePath = path.join(root, t.tmpl);
const entry = parseSkillFrontmatter(filePath);
if (!entry) {
@@ -145,7 +152,7 @@ export async function generateLlmsTxt(opts: GenerateOptions = {}): Promise<Gener
}
continue;
}
skills.push(entry);
skills.push({ ...entry, output: t.output });
}
skills.sort((a, b) => a.name.localeCompare(b.name));
@@ -168,7 +175,7 @@ export async function generateLlmsTxt(opts: GenerateOptions = {}): Promise<Gener
lines.push('');
for (const skill of skills) {
const summary = oneLine(skill.description);
lines.push(`- [/${skill.name}](${skill.name}/SKILL.md): ${summary}`);
lines.push(`- [/${skill.name}](${skill.output}): ${summary}`);
}
lines.push('');