Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors
TypeScript a2aai-agentsai-gatewayanthropicclaudeclaude-codeclinecodexcopilotcursordeepseekfree-aigeminikimillm-gatewaymcpopenaiopenai-proxyqwentoken-saver
import { test } from "node:test";
import assert from "node:assert/strict";
import { readdir, readFile, access } from "node:fs/promises";
import { join } from "node:path";
// Lint dos manifests de skills da CLI (skills/<dir>/SKILL.md).
//
// Religado pela auditoria 6A.1 (2026-06-09): este arquivo era órfão (nenhum runner
// coletava tests/unit/docs/) e apodreceu — filtrava dirs `omniroute*`, mas os skills
// foram renomeados para `cli-*`; com 0 dirs o segundo teste passava VACUOSAMENTE.
// Atualizado para o estado real: todo dir de skills/ com SKILL.md é validado, e o
// invariante de uso é "referencia as env vars ($OMNIROUTE_URL/OMNIROUTE_KEY) OU
// comandos da CLI (`omniroute …`)" — 3 skills (health/keys/batches) usam só a CLI.
const SKILLS_DIR = join(process.cwd(), "skills");
const REQUIRED_FRONTMATTER = ["name:", "description:"];
async function listSkillDirs(): Promise<string[]> {
const entries = await readdir(SKILLS_DIR, { withFileTypes: true });
const dirs: string[] = [];
for (const e of entries) {
if (!e.isDirectory()) continue;
try {
await access(join(SKILLS_DIR, e.name, "SKILL.md"));
dirs.push(e.name);
} catch {
// dir sem SKILL.md é coberto pelo teste de completude abaixo
}
}
return dirs;
}
test("each skill dir has SKILL.md with frontmatter", async () => {
const dirs = await listSkillDirs();
assert.ok(dirs.length >= 40, `Expected ≥40 skill dirs, got ${dirs.length}`);
for (const dir of dirs) {
const path = join(SKILLS_DIR, dir, "SKILL.md");
const content = await readFile(path, "utf-8");
assert.ok(content.startsWith("---\n"), `${dir}: missing opening frontmatter`);
for (const key of REQUIRED_FRONTMATTER) {
assert.ok(content.includes(key), `${dir}: missing frontmatter key ${key}`);
}
// Skills `omni-*` são GERADOS por src/lib/agentSkills/generator.ts (alguns em
// estado "no endpoints mapped yet", sem refs de uso) — o invariante de uso vale
// só para os manifests manuscritos (cli-* e config-*). `ponytail` é a entrada
// `external` do catálogo (#9058, conteúdo MIT de terceiro) — não descreve uso
// do OmniRoute, então também fica fora do invariante.
if (!dir.startsWith("omni-") && dir !== "ponytail") {
assert.ok(
content.includes("OMNIROUTE_") || content.includes("omniroute "),
`${dir}: missing usage references (OMNIROUTE_* env vars or omniroute CLI commands)`
);
}
}
});
test("every directory under skills/ ships a SKILL.md", async () => {
const entries = await readdir(SKILLS_DIR, { withFileTypes: true });
const missing: string[] = [];
for (const e of entries) {
if (!e.isDirectory()) continue;
try {
await access(join(SKILLS_DIR, e.name, "SKILL.md"));
} catch {
missing.push(e.name);
}
}
assert.deepEqual(missing, [], `skill dirs without SKILL.md: ${missing.join(", ")}`);
});
test("description field is meaningful (≥50 chars)", async () => {
const dirs = await listSkillDirs();
assert.ok(dirs.length > 0, "no skill dirs found — listSkillDirs is broken");
for (const dir of dirs) {
const content = await readFile(join(SKILLS_DIR, dir, "SKILL.md"), "utf-8");
const match = content.match(/^description:\s*(.+?)$/m);
assert.ok(match, `${dir}: no description field`);
const desc = match![1];
// Nota: o assert antigo exigia a frase-gatilho "Use when" — nenhum dos 43 skills
// reais a usa; o invariante verificável é descrição substantiva (≥50 chars).
assert.ok(desc.length >= 50, `${dir}: description too short (${desc.length})`);
}
});
function scanSkillReferences(raw: string, existing: Set<string>) {
const content = raw.replace(/<!--[\s\S]*?-->/g, " ");
const references = [...content.matchAll(/skills\/([A-Za-z0-9_.-]+)\/SKILL\.md/g)].map(
(match) => match[1]
);
return {
checked: references.length,
broken: references.filter((name) => !existing.has(name)),
};
}
// #15665: skills linked to `skills/omniroute-*/SKILL.md` after those dirs were renamed to
// `omni-*`/`cli-*`, so agents following the raw URLs hit a 404. Every link to another skill
// manifest (raw GitHub URL or relative path) must resolve to a dir that exists today.
// HTML comments are skipped: `<!-- Migrated from skills/omniroute-x/SKILL.md -->` is
// provenance, not a link.
test("every skills/<dir>/SKILL.md reference inside a skill resolves (#15665)", async () => {
const dirs = await listSkillDirs();
const existing = new Set(dirs);
const broken: string[] = [];
let checked = 0;
for (const dir of dirs) {
const raw = await readFile(join(SKILLS_DIR, dir, "SKILL.md"), "utf-8");
const result = scanSkillReferences(raw, existing);
checked += result.checked;
for (const name of result.broken) broken.push(`${dir} -> skills/${name}/SKILL.md`);
}
assert.ok(checked > 0, "no cross-skill references found — the extraction regex is broken");
assert.deepEqual(broken, [], `dangling skill links:\n${broken.join("\n")}`);
});
// #15306: comment masking must preserve visible token boundaries and dangling-link checks.
for (const { name, raw, checked, broken } of [
{
name: "keeps a visible reference to an existing skill",
raw: "See [entry](skills/known/SKILL.md).",
checked: 1,
broken: [],
},
{
name: "reports a visible reference to a missing skill",
raw: "See skills/missing/SKILL.md.",
checked: 1,
broken: ["missing"],
},
{
name: "ignores complete provenance comments",
raw: "<!-- Migrated from skills/missing/SKILL.md --> skills/known/SKILL.md",
checked: 1,
broken: [],
},
{
name: "handles multiple and multiline comments without hiding visible missing links",
raw: "<!-- skills/old/SKILL.md --> skills/known/SKILL.md <!--\nother provenance\n--> skills/missing/SKILL.md",
checked: 2,
broken: ["missing"],
},
{
name: "does not assemble a reference prefix across a comment",
raw: "ski<!-- provenance -->lls/missing/SKILL.md",
checked: 0,
broken: [],
},
{
name: "does not assemble a skill name across a comment",
raw: "skills/mis<!-- provenance -->sing/SKILL.md",
checked: 0,
broken: [],
},
]) {
test(`skill reference scanner ${name}`, () => {
assert.deepEqual(scanSkillReferences(raw, new Set(["known"])), { checked, broken });
});
}