attaform 0.27.0 → 0.27.1

package/bin/attaform.mjs

@@ -8,6 +8,12 @@
  * lockstep with the installed Attaform version: run through `npx` in a
  * project that already has Attaform and it copies that version's skill.
  *
+ * With no `[dir]`, it places the skill next to whichever assistants the
+ * project already uses (`.claude/`, `.cursor/`, `.codex/`, `.agents/`)
+ * and falls back to the vendor-neutral `.agents/skills/` when none is
+ * present. `SKILL.md` is one portable format, so a single copy is read
+ * natively by Claude Code, Cursor, Codex, OpenCode, and the rest.
+ *
  * Zero dependencies (Node built-ins only), so it ships verbatim with no
  * build step.
  */
@@ -20,7 +26,22 @@ import { fileURLToPath } from 'node:url'
 // package.json `files` entry, so it is present in both the git checkout
 // and the installed package.
 const SKILL_SOURCE = fileURLToPath(new URL('../skills/attaform/', import.meta.url))
-const DEFAULT_SKILLS_DIR = '.claude/skills'
+
+// The vendor-neutral skills directory: read by OpenCode, Cursor, Cline,
+// and others, and the destination when a project has not committed to a
+// single assistant yet.
+const NEUTRAL_SKILLS_DIR = '.agents/skills'
+
+// Marker directory an assistant creates -> the skills directory it reads.
+// `SKILL.md` is one portable format, so the same files drop into each.
+// Detection is intentionally narrow: only paths a project would not have
+// for another reason (unlike `.github/`, which nearly every repo carries).
+const ASSISTANT_SKILL_DIRS = [
+  { marker: '.claude', skillsDir: '.claude/skills' },
+  { marker: '.cursor', skillsDir: '.cursor/skills' },
+  { marker: '.codex', skillsDir: '.codex/skills' },
+  { marker: '.agents', skillsDir: NEUTRAL_SKILLS_DIR },
+]
 
 function usage() {
   console.log(
@@ -30,9 +51,12 @@ function usage() {
       "  Copy Attaform's Agent Skill into your project so an AI assistant",
       '  loads it while working on a form.',
       '',
-      `  [dir]   Skills directory to install into (default: ${DEFAULT_SKILLS_DIR}).`,
-      '          Point it at another runtime, e.g. attaform skill .cursor/skills',
-    ].join('\n'),
+      '  With no [dir], the skill lands next to each assistant the project',
+      '  already uses (.claude, .cursor, .codex, .agents), or',
+      `  ${NEUTRAL_SKILLS_DIR}/ when none is present.`,
+      '',
+      '  [dir]   Skills directory to install into, e.g. attaform skill .cursor/skills',
+    ].join('\n')
   )
 }
 
@@ -44,6 +68,21 @@ function countFiles(dir) {
   return total
 }
 
+// The skills directories to install into. An explicit arg wins verbatim.
+// Otherwise place next to each assistant the project already uses, and
+// fall back to the vendor-neutral directory when none is detected.
+function resolveTargets(dirArg) {
+  if (dirArg !== undefined) return { dirs: [dirArg], detected: true }
+
+  const dirs = ASSISTANT_SKILL_DIRS.filter(({ marker }) =>
+    existsSync(resolve(process.cwd(), marker))
+  ).map(({ skillsDir }) => skillsDir)
+
+  return dirs.length > 0
+    ? { dirs, detected: true }
+    : { dirs: [NEUTRAL_SKILLS_DIR], detected: false }
+}
+
 function installSkill(skillsDir) {
   const dest = resolve(skillsDir, 'attaform')
   const existed = existsSync(dest)
@@ -52,9 +91,8 @@ function installSkill(skillsDir) {
   const where = relative(process.cwd(), dest) || dest
   const count = countFiles(dest)
   console.log(
-    `${existed ? 'Updated' : 'Installed'} the Attaform skill (${count} file${count === 1 ? '' : 's'}) at ${where}/`,
+    `${existed ? 'Updated' : 'Installed'} the Attaform skill (${count} file${count === 1 ? '' : 's'}) at ${where}/`
   )
-  console.log('Your assistant will load it while it works on a form in this project.')
 }
 
 const [command, dirArg] = process.argv.slice(2)
@@ -71,8 +109,17 @@ if (command !== 'skill') {
 }
 
 try {
-  installSkill(dirArg ?? DEFAULT_SKILLS_DIR)
+  const { dirs, detected } = resolveTargets(dirArg)
+  for (const dir of dirs) installSkill(dir)
+  if (!detected) {
+    console.log(
+      `No assistant directory found, so the skill went to the vendor-neutral ${NEUTRAL_SKILLS_DIR}/. Pass a path (e.g. attaform skill .claude/skills) to target a specific assistant.`
+    )
+  }
+  console.log('Your assistant will load it while it works on a form in this project.')
 } catch (error) {
-  console.error(`attaform: could not install the skill: ${error instanceof Error ? error.message : String(error)}`)
+  console.error(
+    `attaform: could not install the skill: ${error instanceof Error ? error.message : String(error)}`
+  )
   process.exit(1)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "attaform",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "files": [