skillmds 1.0.3 → 1.0.4

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to `skillmds` are documented here. Versions follow [semver](https://semver.org).
 
+## 1.0.4
+
+- `skillmd lint`/`scan` print a progress line to stderr and warn when scanning a home directory, so a directory scan never looks like a frozen blank screen.
+- Directory scans skip large build/OS directories (`AppData`, `node_modules`, `target`, …) and cap recursion depth, so `lint .` in a big tree terminates quickly.
+- Clearer message when no `SKILL.md` is found.
+- Bare `skillmd` (no command) prints help.
+
 ## 1.0.3
 
 - CLI (`skillmd`) and MCP server (`skillmds`) now report their version from `package.json` instead of a hardcoded string.

package/dist/cli.js

@@ -5,6 +5,8 @@ import { readFileSync as readFileSync4 } from "fs";
 // ../cli/src/commands/lint.ts
 import { Command } from "commander";
 import { writeFileSync } from "fs";
+import { homedir } from "os";
+import { resolve } from "path";
 
 // ../../packages/core/src/parse.ts
 import { parse as parseYaml } from "yaml";
@@ -273,9 +275,35 @@ function toGithub(results) {
 import { existsSync, statSync, readFileSync, readdirSync, mkdtempSync } from "fs";
 import { tmpdir } from "os";
 import { join, basename, dirname } from "path";
-var IGNORE_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", ".wrangler"]);
-function findSkillFiles(dir) {
+var IGNORE_DIRS = /* @__PURE__ */ new Set([
+  // build/dependency dirs
+  "node_modules",
+  ".git",
+  "dist",
+  "build",
+  "out",
+  ".next",
+  ".wrangler",
+  ".cache",
+  ".npm",
+  ".pnpm-store",
+  ".venv",
+  "venv",
+  "__pycache__",
+  "target",
+  "vendor",
+  // large OS / user dirs (mostly relevant when run from a home directory)
+  "AppData",
+  "Library",
+  "$Recycle.Bin",
+  "System Volume Information",
+  "Windows",
+  "Program Files"
+]);
+var MAX_DEPTH = 12;
+function findSkillFiles(dir, depth = 0) {
   const out = [];
+  if (depth > MAX_DEPTH) return out;
   let entries;
   try {
     entries = readdirSync(dir, { withFileTypes: true });
@@ -285,7 +313,7 @@ function findSkillFiles(dir) {
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORE_DIRS.has(entry.name)) continue;
-      out.push(...findSkillFiles(join(dir, entry.name)));
+      out.push(...findSkillFiles(join(dir, entry.name), depth + 1));
     } else if (entry.name === "SKILL.md") {
       out.push(join(dir, entry.name));
     }
@@ -304,7 +332,9 @@ async function resolveSource(arg) {
     const st = statSync(arg);
     if (st.isFile()) return [loadLocal(arg)];
     const files2 = findSkillFiles(arg);
-    if (files2.length === 0) throw new Error(`No SKILL.md found under ${arg}`);
+    if (files2.length === 0) {
+      throw new Error(`No SKILL.md found under ${arg}. Point at a skill directory, e.g. "skillmd lint ./my-skill", or run "skillmd init" to create one.`);
+    }
     return files2.map(loadLocal);
   }
   const { downloadTemplate } = await import("giget");
@@ -389,6 +419,11 @@ async function runLint(target, flags) {
 }
 function lintCommand() {
   return new Command("lint").alias("check").description("Validate SKILL.md file(s) against the spec and report a quality score").argument("[target]", "local path or GitHub source", ".").option("--format <fmt>", "text | json | sarif | github", "text").option("--strict", "treat warnings as errors").option("--fail-on-warning", "exit non-zero when warnings exist").option("--fix", "apply safe automatic fixes (e.g. add missing license)").action(async (target, opts) => {
+    if (resolve(target) === homedir()) {
+      process.stderr.write("Warning: scanning your entire home directory. Pass a narrower path, e.g. skillmd lint ./my-skill\n");
+    }
+    process.stderr.write(`Looking for SKILL.md under ${target} \u2026
+`);
     const run = await runLint(target, opts);
     console.log(run.output);
     process.exitCode = run.exitCode;
@@ -522,11 +557,11 @@ import pc4 from "picocolors";
 
 // ../cli/src/config.ts
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync3, mkdirSync as mkdirSync2 } from "fs";
-import { homedir } from "os";
+import { homedir as homedir2 } from "os";
 import { join as join3 } from "path";
 var DEFAULT_API = "https://skillmd-api.vinoor.workers.dev";
 function configPath() {
-  return join3(homedir(), ".skillmd", "config.json");
+  return join3(homedir2(), ".skillmd", "config.json");
 }
 function readConfig() {
   try {
@@ -536,7 +571,7 @@ function readConfig() {
   }
 }
 function writeConfig(cfg) {
-  const dir = join3(homedir(), ".skillmd");
+  const dir = join3(homedir2(), ".skillmd");
   mkdirSync2(dir, { recursive: true });
   writeFileSync3(configPath(), JSON.stringify(cfg, null, 2), { encoding: "utf8", mode: 384 });
 }
@@ -605,8 +640,8 @@ import pc5 from "picocolors";
 
 // ../cli/src/agents.ts
 import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync4, rmSync, symlinkSync, existsSync as existsSync3, readdirSync as readdirSync2, statSync as statSync2, readFileSync as readFileSync3 } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join4, resolve, dirname as dirname2 } from "path";
+import { homedir as homedir3 } from "os";
+import { join as join4, resolve as resolve2, dirname as dirname2 } from "path";
 var AGENTS = [
   { id: "claude-code", segments: [".claude", "skills"] },
   { id: "cursor", segments: [".cursor", "skills"] },
@@ -617,7 +652,7 @@ var AGENTS = [
 function agentDir(agentId, opts = {}) {
   const agent = AGENTS.find((a) => a.id === agentId);
   if (!agent) throw new Error(`Unknown agent: ${agentId}. Known: ${AGENTS.map((a) => a.id).join(", ")}`);
-  const root = opts.global ? homedir2() : opts.cwd ?? process.cwd();
+  const root = opts.global ? homedir3() : opts.cwd ?? process.cwd();
   return join4(root, ...agent.segments);
 }
 function detectAgents(opts = {}) {
@@ -628,7 +663,7 @@ function writeSkill(skillName, files, targetDir, opts = {}) {
   if (opts.mode === "symlink" && opts.canonicalDir) {
     mkdirSync3(dirname2(dest), { recursive: true });
     rmSync(dest, { recursive: true, force: true });
-    symlinkSync(resolve(opts.canonicalDir), dest, "dir");
+    symlinkSync(resolve2(opts.canonicalDir), dest, "dir");
     return dest;
   }
   mkdirSync3(dest, { recursive: true });
@@ -939,6 +974,10 @@ program.addCommand(updateCommand());
 program.addCommand(publishCommand());
 program.addCommand(loginCommand());
 program.addCommand(logoutCommand());
+if (process.argv.slice(2).length === 0) {
+  program.outputHelp();
+  process.exit(0);
+}
 program.parseAsync(process.argv).catch((err) => {
   console.error(err instanceof Error ? err.message : String(err));
   process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillmds",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "SkillMD for agents: the `skillmds` MCP server + the `skillmd` CLI (lint, scan, search, install, publish Agent Skills) from skillmd.com.",
   "type": "module",
   "bin": {