@sagargupta1610/skillcheck 0.2.1 → 0.2.2

package/dist/{chunk-MGSKVMAQ.js → chunk-X3UHBJW7.js}

@@ -1029,6 +1029,9 @@ async function lintSkillDir(dir, options = {}) {
       bundledFiles
     })
   );
+  findings.push(
+    ...await deepReferenceChains(skillDir, parsed.body, bundledFiles)
+  );
   const skillName = parsed.frontmatter && typeof parsed.frontmatter.name === "string" ? parsed.frontmatter.name.trim().normalize("NFKC") : null;
   return summarize(skillDir, skillName, applyOverrides(findings, options));
 }
@@ -1071,6 +1074,50 @@ function applyOverrides(findings, options) {
   }
   return out;
 }
+function extractReferences(body) {
+  const refs = /* @__PURE__ */ new Set();
+  for (const m of body.matchAll(/\[[^\]]*\]\(([^)]+)\)/g)) {
+    const target = (m[1] ?? "").split(/[#?]/)[0]?.trim() ?? "";
+    if (target) refs.add(target);
+  }
+  for (const m of body.matchAll(
+    /`((?:scripts|references|assets)\/[^\s`]+)`/g
+  )) {
+    refs.add((m[1] ?? "").trim());
+  }
+  return [...refs].filter(
+    (t) => !/^[a-z][a-z0-9+.-]*:\/\//i.test(t) && !t.startsWith("#") && !t.startsWith("mailto:") && !t.includes("${") && !t.includes("{{") && !/^(\/|[A-Za-z]:[\\/]|~\/)/.test(t)
+  );
+}
+async function deepReferenceChains(skillDir, body, bundledFiles) {
+  const findings = [];
+  const bundled = new Set(bundledFiles.map((f) => f.replace(/\\/g, "/")));
+  for (const ref of extractReferences(body)) {
+    const normalized = ref.replace(/^\.\//, "").replace(/\\/g, "/");
+    if (!normalized.endsWith(".md") || !bundled.has(normalized)) continue;
+    let childBody;
+    try {
+      childBody = await readFile2(join2(skillDir, normalized), "utf8");
+    } catch {
+      continue;
+    }
+    const childRefs = extractReferences(childBody).filter((t) => {
+      const childDir = normalized.includes("/") ? normalized.slice(0, normalized.lastIndexOf("/")) : "";
+      const resolved = t.startsWith("./") || !t.includes("/") ? `${childDir ? `${childDir}/` : ""}${t.replace(/^\.\//, "")}` : t;
+      return bundled.has(resolved.replace(/\\/g, "/"));
+    });
+    if (childRefs.length > 0) {
+      findings.push({
+        code: "SC103",
+        alias: "deep-reference-chain",
+        severity: "info",
+        message: `\`${normalized}\` references further bundled files (${childRefs.slice(0, 3).join(", ")}${childRefs.length > 3 ? ", ..." : ""}) -- spec recommends keeping references one level deep from SKILL.md`,
+        file: normalized
+      });
+    }
+  }
+  return findings;
+}
 async function listBundledFiles(skillDir) {
   const files = [];
   async function walk(dir, depth) {

package/dist/cli.js

@@ -5,14 +5,14 @@ import {
   initEvals,
   lintSkillDir,
   toSarif
-} from "./chunk-MGSKVMAQ.js";
+} from "./chunk-X3UHBJW7.js";
 
 // src/cli.ts
 import { appendFile, readFile, stat, writeFile } from "fs/promises";
 import { join } from "path";
 import { Command } from "commander";
 import { glob } from "glob";
-var VERSION = "0.2.1";
+var VERSION = "0.2.2";
 var program = new Command();
 program.name("skillcheck").description("Conformance suite for Agent Skills (SKILL.md)").version(VERSION);
 program.command("lint").description(
@@ -32,14 +32,27 @@ program.command("lint").description(
   "--fail-on <severity>",
   "minimum severity that fails: error | warning | never",
   "error"
-).option("--sarif <path>", "also write a SARIF 2.1.0 report to this path").option("--max-warnings <n>", "fail when warnings exceed this count").action(async (paths, opts) => {
-  const skillDirs = await expandSkillDirs(paths);
+).option("--sarif <path>", "also write a SARIF 2.1.0 report to this path").option("--max-warnings <n>", "fail when warnings exceed this count").option(
+  "--ignore-pattern <glob...>",
+  "glob(s) to exclude during discovery (adds to config ignore)"
+).action(async (paths, opts) => {
+  if (opts.strict && opts.profile === "lenient") {
+    console.error("--strict conflicts with --profile lenient; pick one");
+    process.exit(2);
+  }
+  if (opts.strict) {
+    console.error(
+      "warning: --strict is deprecated; strict is the default (use --profile)"
+    );
+  }
+  const config = await loadConfig();
+  const ignore = [...config?.ignore ?? [], ...opts.ignorePattern ?? []];
+  const skillDirs = await expandSkillDirs(paths, ignore);
   if (skillDirs.length === 0) {
     console.error("no SKILL.md found under the given paths");
     process.exit(2);
   }
   const profile = opts.profile === "lenient" ? "lenient" : "strict";
-  const config = await loadConfig();
   const results = [];
   for (const dir of skillDirs) {
     const result = await lintSkillDir(dir, {
@@ -103,7 +116,7 @@ async function loadConfig() {
     return null;
   }
 }
-async function expandSkillDirs(paths) {
+async function expandSkillDirs(paths, extraIgnore = []) {
   const dirs = /* @__PURE__ */ new Set();
   for (const p of paths) {
     if (await exists(join(p, "SKILL.md")) || await exists(join(p, "skill.md"))) {
@@ -112,7 +125,7 @@ async function expandSkillDirs(paths) {
     }
     const matches = await glob("**/{SKILL,skill}.md", {
       cwd: p,
-      ignore: ["**/node_modules/**", "**/.git/**"],
+      ignore: ["**/node_modules/**", "**/.git/**", ...extraIgnore],
       absolute: true
     });
     for (const m of matches) {

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   lintSkillDir,
   parseSkillMd,
   toSarif
-} from "./chunk-MGSKVMAQ.js";
+} from "./chunk-X3UHBJW7.js";
 export {
   KNOWN_EXTENSIONS,
   RULES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sagargupta1610/skillcheck",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Conformance suite for Agent Skills: lint SKILL.md against the spec, run it against real agent runtimes, publish a compatibility matrix",
   "keywords": [
     "agent-skills",