fmddr-skills 0.6.0 → 0.6.2

package/README.md

@@ -1,7 +1,7 @@
-# fmddr — Claude Code skills
+# fmddr — agent skills
 
-Four agent skills for working with [`fmddr`](https://github.com/proofsh/fmddr)
-from Claude Code:
+Skills for working with [`fmddr`](https://github.com/proofsh/fmddr) from
+Claude Code, Cursor, and any agent that reads `AGENTS.md`.
 
 | Skill           | Triggers on                                                               | Purpose                                                        |
 | --------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------- |
@@ -10,47 +10,50 @@ from Claude Code:
 | `fmddr-issue`   | "report a bug", "file an issue", "feature request" — for fmddr            | Open a high-quality issue at proofsh/fmddr (with severity)     |
 | `fmddr-release` | "release fmddr", "cut a patch", "publish to PyPI"                         | End-to-end release flow: bump, changelog, build, tag, publish  |
 
-**Typical first-time flow:**
-1. `npx fmddr-skills` — installs all four skills
-2. In a Claude Code session: "set up fmddr for my DDR" → `fmddr-setup` activates
-3. Now any FileMaker question → `fmddr` activates automatically
-
 ## Install
 
-### npx (no git required)
+### Claude Code
 
 ```sh
-npx fmddr-skills                   # install all four skills (personal)
-npx fmddr-skills fmddr fmddr-setup # install specific skills only
+npx fmddr-skills                   # personal (~/.claude/skills/)
 npx fmddr-skills --project         # project-scoped (.claude/skills/)
+npx fmddr-skills fmddr fmddr-setup # specific skills only
 ```
 
-### Manual — personal (one user, all projects)
+In a Claude Code session type `/` to confirm they appear, or ask
+"is the fmddr skill loaded?".
+
+### Cursor
 
 ```sh
-mkdir -p ~/.claude/skills
-cp -R skills/fmddr         ~/.claude/skills/
-cp -R skills/fmddr-setup   ~/.claude/skills/
-cp -R skills/fmddr-issue   ~/.claude/skills/
-cp -R skills/fmddr-release ~/.claude/skills/
+npx fmddr-skills --cursor          # writes .cursor/rules/fmddr-*.mdc
 ```
 
-### Manual — project-scoped (this repo only)
+Installs each skill as a `.mdc` rule file in `.cursor/rules/` of the
+current directory. Rules for `fmddr`, `fmddr-setup`, and
+`fmddr-generate-docs` auto-activate on `.fmp12` / `.xml` / `.fmddr.db`
+files; the others are available on demand. Restart Cursor or open the
+Rules panel after installing.
+
+### AGENTS.md (Codex and other agents)
 
 ```sh
-mkdir -p .claude/skills
-cp -R skills/fmddr         .claude/skills/
-cp -R skills/fmddr-setup   .claude/skills/
-cp -R skills/fmddr-issue   .claude/skills/
-cp -R skills/fmddr-release .claude/skills/
+npx fmddr-skills --agents-md       # writes AGENTS.md in the current directory
 ```
 
-Project skills override personal skills with the same name.
+Writes a single `AGENTS.md` file combining all skill instructions.
+Compatible with any agent that picks up `AGENTS.md` from the project root
+(OpenAI Codex, etc.). Re-run to update after a new version is published.
 
-## Verify
+### Manual — Claude Code personal
 
-In a Claude Code session, type `/` and look for the skills, or ask
-"is the fmddr skill loaded?" — Claude will list available skills.
+```sh
+mkdir -p ~/.claude/skills
+cp -R skills/fmddr         ~/.claude/skills/
+cp -R skills/fmddr-setup   ~/.claude/skills/
+cp -R skills/fmddr-issue   ~/.claude/skills/
+cp -R skills/fmddr-release ~/.claude/skills/
+```
 
 ## Layout
 

package/bin/install.js

@@ -7,22 +7,25 @@ const os = require("os");
 
 const ALL_SKILLS = ["fmddr", "fmddr-generate-docs", "fmddr-issue", "fmddr-release", "fmddr-setup"];
 
-// Parse args: `npx fmddr-skills [skill1 skill2 ...]`
-const requested = process.argv.slice(2).filter(a => !a.startsWith("-"));
-const showHelp = process.argv.includes("--help") || process.argv.includes("-h");
-const scopeFlag = process.argv.includes("--project") || process.argv.includes("-p")
-  ? "project"
-  : "personal";
+const args = process.argv.slice(2);
+const showHelp = args.includes("--help") || args.includes("-h");
+const cursorFlag = args.includes("--cursor");
+const agentsMdFlag = args.includes("--agents-md");
+const scopeFlag = args.includes("--project") || args.includes("-p") ? "project" : "personal";
+
+// Positional args are skill names
+const requested = args.filter(a => !a.startsWith("-"));
 
 if (showHelp) {
   console.log(`
-fmddr-skills — install Claude Code skills for fmddr
+fmddr-skills — install fmddr agent skills
 
 Usage:
-  npx fmddr-skills                  install all skills (personal)
-  npx fmddr-skills fmddr            install one skill
-  npx fmddr-skills fmddr fmddr-issue install two skills
-  npx fmddr-skills --project        install into .claude/skills/ (project-scoped)
+  npx fmddr-skills                    install all skills for Claude Code (personal)
+  npx fmddr-skills fmddr fmddr-issue  install specific skills only
+  npx fmddr-skills --project          install into .claude/skills/ (project-scoped)
+  npx fmddr-skills --cursor           install as Cursor rules (.cursor/rules/)
+  npx fmddr-skills --agents-md        write AGENTS.md in the current directory
 
 Available skills: ${ALL_SKILLS.join(", ")}
 `);
@@ -31,7 +34,6 @@ Available skills: ${ALL_SKILLS.join(", ")}
 
 const toInstall = requested.length > 0 ? requested : ALL_SKILLS;
 
-// Validate
 for (const name of toInstall) {
   if (!ALL_SKILLS.includes(name)) {
     console.error(`Unknown skill: "${name}". Available: ${ALL_SKILLS.join(", ")}`);
@@ -39,38 +41,117 @@ for (const name of toInstall) {
   }
 }
 
-// Resolve destination
-const dest =
-  scopeFlag === "project"
-    ? path.join(process.cwd(), ".claude", "skills")
-    : path.join(os.homedir(), ".claude", "skills");
+const skillsRoot = path.join(__dirname, "..");
 
-fs.mkdirSync(dest, { recursive: true });
+// ── Helpers ────────────────────────────────────────────────────────────────
 
-// Copy a directory tree recursively
 function copyDir(src, dst) {
   fs.mkdirSync(dst, { recursive: true });
   for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
     const srcPath = path.join(src, entry.name);
     const dstPath = path.join(dst, entry.name);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, dstPath);
-    } else {
-      fs.copyFileSync(srcPath, dstPath);
-    }
+    if (entry.isDirectory()) copyDir(srcPath, dstPath);
+    else fs.copyFileSync(srcPath, dstPath);
   }
 }
 
-const skillsRoot = path.join(__dirname, "..");
-let installed = 0;
+// Parse the YAML frontmatter block at the top of a SKILL.md.
+// Returns { meta: { key: value, ... }, body: "content after frontmatter" }
+function parseFrontmatter(text) {
+  const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+  if (!match) return { meta: {}, body: text };
+  const meta = {};
+  for (const line of match[1].split(/\r?\n/)) {
+    const kv = line.match(/^(\w+):\s*(.*)/);
+    if (kv) meta[kv[1]] = kv[2].trim();
+  }
+  return { meta, body: match[2] };
+}
 
-for (const name of toInstall) {
-  const src = path.join(skillsRoot, name);
-  const dst = path.join(dest, name);
-  copyDir(src, dst);
-  console.log(`  ✓ ${name} → ${dst}`);
-  installed++;
+// ── Claude Code install ────────────────────────────────────────────────────
+
+function installClaudeCode(skills) {
+  const dest =
+    scopeFlag === "project"
+      ? path.join(process.cwd(), ".claude", "skills")
+      : path.join(os.homedir(), ".claude", "skills");
+  fs.mkdirSync(dest, { recursive: true });
+  for (const name of skills) {
+    copyDir(path.join(skillsRoot, name), path.join(dest, name));
+    console.log(`  ✓ ${name} → ${dest}/${name}`);
+  }
+  console.log(`\nInstalled ${skills.length} skill${skills.length === 1 ? "" : "s"} into ${dest}`);
+  console.log("Open a Claude Code session and type / to confirm they appear.");
+}
+
+// ── Cursor rules install ───────────────────────────────────────────────────
+
+// Globs that make sense for each skill — auto-activates the rule when
+// the user is working on matching files.
+const CURSOR_GLOBS = {
+  "fmddr":               "**/*.fmp12, **/*.xml, **/*.fmddr.db",
+  "fmddr-setup":         "**/*.fmp12, **/*.xml, **/*.fmddr.db",
+  "fmddr-issue":         "",
+  "fmddr-release":       "",
+  "fmddr-generate-docs": "**/*.fmp12, **/*.xml, **/*.fmddr.db",
+};
+
+function installCursor(skills) {
+  const dest = path.join(process.cwd(), ".cursor", "rules");
+  fs.mkdirSync(dest, { recursive: true });
+  for (const name of skills) {
+    const skillMd = path.join(skillsRoot, name, "SKILL.md");
+    if (!fs.existsSync(skillMd)) continue;
+    const { meta, body } = parseFrontmatter(fs.readFileSync(skillMd, "utf8"));
+    const description = meta.description
+      ? meta.description.slice(0, 200)   // Cursor shows ~120 chars in the UI
+      : `fmddr skill: ${name}`;
+    const globs = CURSOR_GLOBS[name] ?? "";
+    const frontmatter = [
+      "---",
+      `description: ${description}`,
+      globs ? `globs: ${globs}` : "globs:",
+      "alwaysApply: false",
+      "---",
+      "",
+    ].join("\n");
+    const outPath = path.join(dest, `${name}.mdc`);
+    fs.writeFileSync(outPath, frontmatter + body, "utf8");
+    console.log(`  ✓ ${name} → ${outPath}`);
+  }
+  console.log(`\nInstalled ${skills.length} Cursor rule${skills.length === 1 ? "" : "s"} into ${dest}`);
+  console.log("Restart Cursor or open the Rules panel to confirm they appear.");
 }
 
-console.log(`\nInstalled ${installed} skill${installed === 1 ? "" : "s"} into ${dest}`);
-console.log("Open a Claude Code session and type / to confirm they appear.");
+// ── AGENTS.md install ──────────────────────────────────────────────────────
+
+function installAgentsMd(skills) {
+  const outPath = path.join(process.cwd(), "AGENTS.md");
+  const sections = [];
+
+  sections.push(
+    "# fmddr Agent Instructions\n",
+    "> Generated by `npx fmddr-skills --agents-md`. Re-run to update.\n",
+  );
+
+  for (const name of skills) {
+    const skillMd = path.join(skillsRoot, name, "SKILL.md");
+    if (!fs.existsSync(skillMd)) continue;
+    const { body } = parseFrontmatter(fs.readFileSync(skillMd, "utf8"));
+    sections.push(`---\n\n${body.trim()}\n`);
+  }
+
+  fs.writeFileSync(outPath, sections.join("\n"), "utf8");
+  console.log(`  ✓ Wrote ${outPath}`);
+  console.log(`\nAGENTS.md contains instructions for ${skills.length} skill${skills.length === 1 ? "" : "s"}.`);
+}
+
+// ── Dispatch ───────────────────────────────────────────────────────────────
+
+if (cursorFlag) {
+  installCursor(toInstall);
+} else if (agentsMdFlag) {
+  installAgentsMd(toInstall);
+} else {
+  installClaudeCode(toInstall);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fmddr-skills",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Claude Code skills for fmddr — FileMaker DDR analyzer",
   "keywords": [
     "claude-code",