any-skills 0.1.2 → 0.1.4

package/README.md

@@ -1,32 +1,65 @@
 # any-skills
 
-When installed as a dependency, this package creates a shared skills directory (default: `.skills`) so Claude, Codex, and similar tools can reuse the same skills.
+Create a shared skills directory and link tool-specific folders so Claude, Codex,
+Gemini, and others can reuse the same skills.
 
-- `.claude/skills`
-- `.codex/skills`
+## What it does
 
-## How it works
+- Creates a shared `skills` directory in the working directory (or uses the
+  configured target).
+- Creates tool links such as `.claude/skills` or `.codex/skills`.
+- Auto-detects `claude`, `codex`, and `gemini` commands on your PATH by default.
 
-The `postinstall` script runs at install time. It uses the user's install working directory as the root (prefers `INIT_CWD`, then `npm_config_local_prefix`, and falls back to `process.cwd()`). If the shared skills directory does not exist, it is created, then the tool-specific symlinks are generated (unless overridden by configuration). By default it auto-detects the `claude`, `codex`, and `gemini` commands on your PATH.
+## Install
 
-When installed globally, the postinstall step is skipped. Instead, run the CLI in the project you want to link.
+```sh
+npm install any-skills --save-dev
+```
+
+Or install globally:
+
+```sh
+npm install -g any-skills
+```
+
+## Usage
+
+Create links in the current directory:
+
+```sh
+npx any-skills
+```
+
+Create links in your home directory (for example `~/.claude/skills`):
+
+```sh
+npx any-skills -g
+```
+
+Limit to specific tools:
+
+```sh
+npx any-skills claude
+npx any-skills deepseek
+```
+
+If a tool is not in the configured map, it links to `.<name>/skills` by default.
 
 ## Configuration
 
-You can customize which links are created by adding `.skillsrc` (JSON) in your project root.
+Create `.skillsrc` (JSON) in the working directory.
 
 Supported fields:
 
-- `target`: optional string. Overrides where skills are stored (default: `.skills`).
+- `target`: optional string. Overrides where skills are stored (default: `skills`).
 - `links`: array of link definitions. Strings map to `target` by default.
-- `tools`: optional object mapping command names to link paths, used for auto-detection.
-- `linkRoot`: optional string. Controls where links are created (`cwd`, `home`, `~`, or a path).
+- `tools`: optional object mapping command names to link paths.
 
 Example:
 
 ```json
 {
-  "target": ".skills",
+  "target": "skills",
   "links": [".codex/skills", ".claude/skills"]
 }
 ```
@@ -43,46 +76,11 @@ Example (auto-detect commands):
 }
 ```
 
-Example (link into home directory):
-
-```json
-{
-  "linkRoot": "home"
-}
-```
-
 ## Cross-platform behavior
 
 - macOS / Linux uses `dir` symlinks
 - Windows uses `junction` for better compatibility
 
-## Usage
-
-```sh
-npm install any-skills --save-dev
-```
-
-## Global usage
-
-```sh
-npm install -g any-skills
-```
-
-Then, in the project directory where you want links created:
-
-```sh
-npx any-skills
-```
-
-If the project does not list `any-skills` as a dependency, the CLI defaults to linking into your home directory (for example `~/.claude/skills`). Use `linkRoot` in `.skillsrc` to override.
-
-You can also pass tool names to only create those links:
-
-```sh
-npx any-skills claude
-npx any-skills deepseek
-```
-
 ## Git ignore
 
 Add the tool-specific shared skill directories to your `.gitignore`:

package/package.json

@@ -1,11 +1,8 @@
 {
   "name": "any-skills",
-  "version": "0.1.2",
-  "description": "Share skills between Claude, Codex, and similar tools via a shared .skills directory.",
+  "version": "0.1.4",
+  "description": "Share skills between Claude, Codex, and similar tools via a shared skills directory.",
   "type": "commonjs",
-  "scripts": {
-    "postinstall": "node scripts/postinstall.js"
-  },
   "bin": {
     "any-skills": "scripts/cli.js"
   }

package/scripts/cli.js

@@ -1,57 +1,29 @@
 #!/usr/bin/env node
 'use strict';
 
-const fs = require('fs');
 const os = require('os');
-const path = require('path');
 const { linkSkills } = require('./link-skills');
 
-function readPackageJson(filePath) {
-  try {
-    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
-  } catch (err) {
-    return null;
-  }
-}
-
-function hasAnySkillsDependency(pkg) {
-  const dependencyFields = [
-    'dependencies',
-    'devDependencies',
-    'optionalDependencies',
-    'peerDependencies',
-  ];
-  for (const field of dependencyFields) {
-    if (pkg && pkg[field] && pkg[field]['any-skills']) {
-      return true;
-    }
-  }
-  return false;
-}
-
-function hasLocalInstall(startDir) {
-  let current = path.resolve(startDir);
-  while (true) {
-    const pkgPath = path.join(current, 'package.json');
-    if (fs.existsSync(pkgPath)) {
-      const pkg = readPackageJson(pkgPath);
-      if (hasAnySkillsDependency(pkg)) {
-        return true;
-      }
+function parseArgs(argv) {
+  const flags = new Set();
+  const tools = [];
+  for (const arg of argv) {
+    if (arg === '--global' || arg === '-g') {
+      flags.add('global');
+      continue;
     }
-
-    const parent = path.dirname(current);
-    if (parent === current) {
-      return false;
+    if (arg.startsWith('-')) {
+      continue;
     }
-    current = parent;
+    tools.push(arg);
   }
+  return { flags, tools };
 }
 
 const rootDir = process.cwd();
-const linkRoot = hasLocalInstall(rootDir) ? rootDir : os.homedir();
-const args = process.argv.slice(2).filter(Boolean);
-const explicitTools = args.length ? args : null;
+const { flags, tools } = parseArgs(process.argv.slice(2));
+const linkRoot = flags.has('global') ? os.homedir() : rootDir;
+const explicitTools = tools.length ? tools : null;
 const exitCode = linkSkills(rootDir, { linkRoot, explicitTools });
 if (exitCode) {
   process.exit(exitCode);

package/scripts/link-skills.js

@@ -1,10 +1,9 @@
 'use strict';
 
 const fs = require('fs');
-const os = require('os');
 const path = require('path');
 
-const targetName = '.skills';
+const targetName = 'skills';
 const configFileName = '.skillsrc';
 const defaultToolTargets = {
   claude: '.claude/skills',
@@ -119,29 +118,6 @@ function resolveRootPath(value, baseDir) {
   return path.isAbsolute(value) ? value : path.join(baseDir, value);
 }
 
-function resolveLinkRoot(config, rootDir, defaultLinkRoot) {
-  if (
-    config &&
-    typeof config.linkRoot === 'string' &&
-    config.linkRoot.trim() !== ''
-  ) {
-    const raw = config.linkRoot.trim();
-    if (raw === 'home') {
-      return os.homedir();
-    }
-    if (raw === 'cwd') {
-      return rootDir;
-    }
-    if (raw === '~' || raw.startsWith('~/')) {
-      const suffix = raw.length > 2 ? raw.slice(2) : '';
-      return path.join(os.homedir(), suffix);
-    }
-    return resolveRootPath(raw, rootDir);
-  }
-
-  return defaultLinkRoot || rootDir;
-}
-
 function resolveTarget(config, rootDir) {
   if (
     config &&
@@ -292,7 +268,7 @@ function buildLinkMappings({
   linkRoot,
   explicitTools,
 }) {
-  const resolvedLinkRoot = resolveLinkRoot(config, rootDir, linkRoot);
+  const resolvedLinkRoot = linkRoot || rootDir;
   const explicitTargets = Array.isArray(explicitTools)
     ? resolveExplicitTargets(config, explicitTools)
     : null;

package/scripts/postinstall.js

@@ -1,33 +0,0 @@
-'use strict';
-
-const path = require('path');
-const { linkSkills } = require('./link-skills');
-
-function getInstallRoot() {
-  const initCwd = process.env.INIT_CWD;
-  if (initCwd) {
-    return path.resolve(initCwd);
-  }
-
-  const npmPrefix = process.env.npm_config_local_prefix;
-  if (npmPrefix) {
-    return path.resolve(npmPrefix);
-  }
-
-  return process.cwd();
-}
-
-const isGlobalInstall =
-  process.env.npm_config_global === 'true' ||
-  process.env.npm_config_global === '1';
-
-if (isGlobalInstall) {
-  console.log('[any-skills] Global install detected; skipping postinstall.');
-  process.exit(0);
-}
-
-const rootDir = getInstallRoot();
-const exitCode = linkSkills(rootDir);
-if (exitCode) {
-  process.exit(exitCode);
-}