cursor-lint 0.10.0 → 0.11.1

package/README.md

@@ -121,7 +121,7 @@ Every check in cursor-lint comes from [actual experiments](https://dev.to/nedcod
 
 ## Need a deeper review?
 
-cursor-lint catches structural issues. For a full review of your rules, project structure, and model settings, I offer [$50 async setup audits](https://cursorrulespacks.gumroad.com/l/cursor-setup-audit). You get a written report with specific fixes, not generic advice.
+cursor-lint catches structural issues. For a full review of your rules, project structure, and model settings, I offer [$50 async setup audits](https://nedcodes.gumroad.com/l/cursor-setup-audit). You get a written report with specific fixes, not generic advice.
 
 ## License
 
@@ -129,12 +129,12 @@ MIT
 
 ---
 
-Made by [nedcodes](https://dev.to/nedcodes) · [Free rules collection](https://github.com/cursorrulespacks/cursorrules-collection) · [Setup audits](https://cursorrulespacks.gumroad.com/l/cursor-setup-audit)
+Made by [nedcodes](https://dev.to/nedcodes) · [Free rules collection](https://github.com/nedcodes-ok/cursorrules-collection) · [Setup audits](https://nedcodes.gumroad.com/l/cursor-setup-audit)
 
 ---
 
 ## Related
 
-- [cursorrules-collection](https://github.com/cursorrulespacks/cursorrules-collection) — 104 free .mdc rules
-- [Cursor Setup Audit](https://cursorrulespacks.gumroad.com/l/cursor-setup-audit) — Professional review of your rules setup ($50)
+- [cursorrules-collection](https://github.com/nedcodes-ok/cursorrules-collection) — 104 free .mdc rules
+- [Cursor Setup Audit](https://nedcodes.gumroad.com/l/cursor-setup-audit) — Professional review of your rules setup ($50)
 - [Articles on Dev.to](https://dev.to/nedcodes) — Guides on writing effective Cursor rules

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cursor-lint",
-  "version": "0.10.0",
-  "description": "Lint your Cursor rules \u2014 catch common mistakes before they break your workflow",
+  "version": "0.11.1",
+  "description": "Lint your Cursor rules — catch common mistakes before they break your workflow",
   "main": "src/index.js",
   "bin": {
     "cursor-lint": "src/cli.js"
@@ -21,9 +21,10 @@
   ],
   "author": "nedcodes",
   "license": "MIT",
+  "homepage": "https://github.com/nedcodes-ok/cursor-lint",
   "repository": {
     "type": "git",
-    "url": "https://github.com/cursorrulespacks/cursor-lint.git"
+    "url": "https://github.com/nedcodes-ok/cursor-lint.git"
   },
   "engines": {
     "node": ">=16"
@@ -31,4 +32,4 @@
   "files": [
     "src/"
   ]
-}
+}

package/src/cli.js

@@ -8,7 +8,7 @@ const { fixProject } = require('./fix');
 const { generateRules, suggestSkills } = require('./generate');
 const { checkVersions, checkRuleVersionMismatches } = require('./versions');
 
-const VERSION = '0.10.0';
+const VERSION = '0.11.0';
 
 const RED = '\x1b[31m';
 const YELLOW = '\x1b[33m';
@@ -39,6 +39,7 @@ ${YELLOW}Options:${RESET}
 ${YELLOW}What it checks (default):${RESET}
   • .cursorrules files (warns about agent mode compatibility)
   • .cursor/rules/*.mdc files (frontmatter, alwaysApply, etc.)
+  • Agent skill files (SKILL.md in .claude/skills/, skills/)
   • Vague rules that won't change AI behavior
   • YAML syntax errors
 
@@ -69,7 +70,7 @@ ${YELLOW}Examples:${RESET}
   npx cursor-lint --generate   # Download community rules for your stack
 
 ${YELLOW}More info:${RESET}
-  https://github.com/cursorrulespacks/cursor-lint
+  https://github.com/nedcodes-ok/cursor-lint
 `);
 }
 
@@ -431,10 +432,10 @@ async function main() {
     console.log(parts.join(', ') + '\n');
 
     if (totalErrors > 0) {
-      console.log(`${DIM}Need help fixing these? Get a full setup review:${RESET}`);
-      console.log(`${CYAN}https://cursorrulespacks.gumroad.com/l/cursor-setup-audit${RESET}\n`);
+      console.log(`${DIM}Try ${CYAN}cursor-lint --fix${RESET}${DIM} to auto-repair frontmatter issues.${RESET}`);
+      console.log(`${DIM}Run ${CYAN}cursor-lint --order${RESET}${DIM} to check which rules are actually loading.${RESET}\n`);
     } else if (totalPassed > 0) {
-      console.log(`${DIM}If cursor-lint saved you time: ${CYAN}https://github.com/cursorrulespacks/cursor-lint${RESET} ${DIM}(⭐ helps others find it)${RESET}\n`);
+      console.log(`${DIM}If cursor-lint saved you time: ${CYAN}https://github.com/nedcodes-ok/cursor-lint${RESET} ${DIM}(⭐ helps others find it)${RESET}\n`);
     }
 
     process.exit(totalErrors > 0 ? 1 : 0);

package/src/generate.js

@@ -2,7 +2,7 @@ const fs = require('fs');
 const path = require('path');
 const https = require('https');
 
-const BASE_URL = 'https://raw.githubusercontent.com/cursorrulespacks/cursorrules-collection/main/rules-mdc/';
+const BASE_URL = 'https://raw.githubusercontent.com/nedcodes-ok/cursorrules-collection/main/rules-mdc/';
 
 // package.json dependencies → rule files
 const PKG_DEP_MAP = {

package/src/index.js

@@ -94,6 +94,98 @@ async function lintMdcFile(filePath) {
   return { file: filePath, issues };
 }
 
+async function lintSkillFile(filePath) {
+  const content = fs.readFileSync(filePath, 'utf-8');
+  const issues = [];
+
+  const fm = parseFrontmatter(content);
+
+  if (!fm.found) {
+    issues.push({ severity: 'error', message: 'Missing YAML frontmatter', hint: 'Add --- block with name and description fields' });
+  } else if (fm.error) {
+    issues.push({ severity: 'error', message: `YAML frontmatter error: ${fm.error}`, hint: 'Fix frontmatter syntax' });
+  } else {
+    if (!fm.data.name) {
+      issues.push({ severity: 'error', message: 'Missing name in frontmatter', hint: 'Add name: your-skill-name to frontmatter' });
+    }
+    if (!fm.data.description) {
+      issues.push({ severity: 'error', message: 'Missing description in frontmatter', hint: 'Add a description so the agent knows when to use this skill' });
+    }
+    if (fm.data.description && fm.data.description.length < 20) {
+      issues.push({ severity: 'warning', message: 'Description is very short', hint: 'A longer description helps agents understand when to invoke this skill' });
+    }
+  }
+
+  // Check body content
+  const body = fm.found ? content.replace(/^---\n[\s\S]*?\n---\n?/, '') : content;
+
+  if (body.trim().length === 0) {
+    issues.push({ severity: 'error', message: 'Skill file has no body content', hint: 'Add instructions for the agent after the frontmatter' });
+  } else if (body.trim().length < 50) {
+    issues.push({ severity: 'warning', message: 'Skill body is very short (< 50 chars)', hint: 'Skills with more detail produce better agent behavior' });
+  }
+
+  // Check for headings (structure)
+  const headings = body.match(/^#{1,3}\s+.+/gm);
+  if (body.trim().length > 500 && (!headings || headings.length === 0)) {
+    issues.push({ severity: 'warning', message: 'Long skill with no headings', hint: 'Add ## sections to organize instructions for better agent comprehension' });
+  }
+
+  // Vague rules (same as .mdc)
+  const contentLower = content.toLowerCase();
+  for (const pattern of VAGUE_PATTERNS) {
+    const idx = contentLower.indexOf(pattern);
+    if (idx !== -1) {
+      const lineNum = content.slice(0, idx).split('\n').length;
+      issues.push({ severity: 'warning', message: `Vague instruction: "${pattern}"`, line: lineNum });
+    }
+  }
+
+  return { file: filePath, issues };
+}
+
+function findSkillDirs(dir) {
+  const skillDirs = [];
+  // .claude/skills/ (Claude Code)
+  const claudeSkills = path.join(dir, '.claude', 'skills');
+  if (fs.existsSync(claudeSkills)) skillDirs.push(claudeSkills);
+  // .cursor/skills/ (Cursor agent skills - future)
+  const cursorSkills = path.join(dir, '.cursor', 'skills');
+  if (fs.existsSync(cursorSkills)) skillDirs.push(cursorSkills);
+  // skills/ at project root (skills.sh convention)
+  const rootSkills = path.join(dir, 'skills');
+  if (fs.existsSync(rootSkills) && fs.statSync(rootSkills).isDirectory()) {
+    // Only if it looks like agent skills (has SKILL.md files in subdirs)
+    try {
+      const entries = fs.readdirSync(rootSkills);
+      const hasSkillMd = entries.some(e => {
+        const sub = path.join(rootSkills, e);
+        return fs.statSync(sub).isDirectory() && fs.existsSync(path.join(sub, 'SKILL.md'));
+      });
+      if (hasSkillMd) skillDirs.push(rootSkills);
+    } catch {}
+  }
+  return skillDirs;
+}
+
+function collectSkillFiles(skillDirs) {
+  const files = [];
+  for (const dir of skillDirs) {
+    try {
+      for (const entry of fs.readdirSync(dir)) {
+        const sub = path.join(dir, entry);
+        if (fs.statSync(sub).isDirectory()) {
+          const skillMd = path.join(sub, 'SKILL.md');
+          if (fs.existsSync(skillMd)) files.push(skillMd);
+        }
+        // Also handle flat SKILL.md files
+        if (entry === 'SKILL.md') files.push(path.join(dir, entry));
+      }
+    } catch {}
+  }
+  return files;
+}
+
 async function lintCursorrules(filePath) {
   const content = fs.readFileSync(filePath, 'utf-8');
   const issues = [];
@@ -134,10 +226,17 @@ async function lintProject(dir) {
     }
   }
 
+  // Skill files (.claude/skills/, skills/, etc.)
+  const skillDirs = findSkillDirs(dir);
+  const skillFiles = collectSkillFiles(skillDirs);
+  for (const sf of skillFiles) {
+    results.push(await lintSkillFile(sf));
+  }
+
   if (results.length === 0) {
     results.push({
       file: dir,
-      issues: [{ severity: 'warning', message: 'No Cursor rules found in this directory' }],
+      issues: [{ severity: 'warning', message: 'No Cursor rules or agent skills found in this directory' }],
     });
   }