@skilly-hand/skilly-hand 0.8.1 → 0.10.0

package/CHANGELOG.md

@@ -16,6 +16,42 @@ All notable changes to this project are documented in this file.
 ### Removed
 - _None._
 
+## [0.10.0] - 2026-04-04
+[View on npm](https://www.npmjs.com/package/@skilly-hand/skilly-hand/v/0.10.0)
+
+### Added
+- Added support for `antigravity`, `windsurf`, and `trae` agent targets across install flows.
+- Added native install target coverage for Antigravity (`.agents/skills`, `.agent/skills`, and `.agents/rules/skilly-hand.md`), Windsurf (`.windsurf/skills`), and TRAE (`.trae/skills`).
+
+### Changed
+- Refactored installer agent target handling to use centralized install profiles for instruction files and skill symlink paths.
+- Updated CLI help output and repository documentation to reflect expanded assistant compatibility and install targets.
+- Expanded tests for new agent support, install/uninstall behavior, and shared `AGENTS.md` target deduplication.
+
+### Fixed
+- _None._
+
+### Removed
+- _None._
+
+## [0.9.0] - 2026-04-04
+[View on npm](https://www.npmjs.com/package/@skilly-hand/skilly-hand/v/0.9.0)
+
+### Added
+
+- `standard` agent option: installs `AGENTS.md` and a `skills/` symlink directly at the project root with no vendor-specific folder (`.claude/`, `.codex/`, etc.).
+
+### Changed
+
+- Interactive agent selection now pre-checks only `standard` instead of all five agents, so accepting defaults gives a clean, agent-agnostic installation.
+- `codex` and `standard` both produce `AGENTS.md`; when both are selected the file is written once.
+
+### Fixed
+- _None._
+
+### Removed
+- _None._
+
 ## [0.8.1] - 2026-04-04
 [View on npm](https://www.npmjs.com/package/@skilly-hand/skilly-hand/v/0.8.1)
 

package/README.md

@@ -24,7 +24,7 @@
 
 - **Installs portable AI agent skills** into your project from a curated catalog
 - **Auto-detects your stack** and recommends relevant skills automatically
-- **Supports every major coding assistant** — Claude Code, OpenCode, Cursor, Copilot, Gemini, and Codex — from a single command
+- **Supports every major coding assistant** — Claude Code, OpenCode, Cursor, Copilot, Gemini, Codex, Antigravity, Windsurf, and TRAE — from a single command
 - **Ships a curated core skill set** including orchestration, SDD workflow, and Figma MCP onboarding
 - **Preserves original agentic structures** in `source/legacy/` as a migration reference
 
@@ -112,11 +112,20 @@ Skills are installed into `.skilly-hand/` with the correct format for each tool:
 
 | Tool | Install Target |
 | ---- | -------------- |
+| Antigravity | `.agents/skills/`, `.agent/skills/` (compat), `.agents/rules/skilly-hand.md`, `AGENTS.md` |
 | Claude Code / OpenCode | `.claude/skills/` |
 | Cursor | `.cursor/skills/` |
 | GitHub Copilot | `.github/copilot-instructions.md` |
 | Gemini CLI | `.gemini/skills/` |
 | Codex (OpenAI) | `.codex/skills/` |
+| Windsurf | `.windsurf/skills/`, `AGENTS.md` |
+| TRAE | `.trae/skills/`, `AGENTS.md` |
+
+### AI Integrated Structures
+
+- Antigravity: rules at `~/.gemini/GEMINI.md` (global) and workspace `.agents/rules/` (with `.agent/rules/` backward support); skills at `.agents/skills/` or `~/.gemini/antigravity/skills/`; MCP config at `~/.gemini/antigravity/mcp_config.json`.
+- Windsurf: AGENTS-based directory scoping via `AGENTS.md`, rules in `.windsurf/rules/`, skills in `.windsurf/skills/` (plus `.agents/skills/` compatibility), MCP config at `~/.codeium/mcp_config.json`.
+- TRAE: project rules in `.trae/rules/` with `AGENTS.md` support, skills in `.trae/skills/` (optional `.agents/skills/` compatibility toggle), MCP project config via `.trae/mcp.json` and manual/marketplace management in-app.
 
 ---
 

package/catalog/README.md

@@ -8,8 +8,8 @@ Published portable skills consumed by the `skilly-hand` CLI.
 | `agents-root-orchestrator` | Author root AGENTS.md as a Where/What/When orchestrator that routes tasks and skill invocation clearly. | core, workflow, orchestration | all |
 | `angular-guidelines` | Guide Angular code generation and review using latest stable Angular verification and modern framework best practices. | angular, frontend, workflow, best-practices | all |
 | `figma-mcp-0to1` | Guide users from Figma MCP installation and authentication through first canvas creation, with function-level tool coverage and operational recovery patterns. | figma, mcp, workflow, design | all |
-| `frontend-design` | Project-aware frontend design skill that detects the existing tech stack, UI libraries, CSS variables, and design tokens before proposing any UI work. Never invents design decisions — reads the project first, confirms with the user, then designs. | frontend, design, workflow, ui | all |
-| `life-guard` | Review code, decisions, and artifacts through a multi-perspective committee and a domain expert safety guard, then synthesize a structured verdict. | core, review, workflow, quality | all |
+| `frontend-design` | Project-aware frontend design skill that detects the existing tech stack, UI libraries, CSS variables, and design tokens before proposing any UI work. | frontend, design, workflow, ui | all |
+| `life-guard` | Review code, decisions, and artifacts through a multi-perspective committee and a domain expert safety guard, then synthesize a structured verdict. | core, workflow, review, quality | all |
 | `skill-creator` | Create and standardize AI skills with reusable structure, metadata rules, and templates. | core, workflow, authoring | all |
 | `spec-driven-development` | Plan, execute, and verify multi-step work through versioned specs with small, testable tasks. | core, workflow, planning | all |
 | `test-driven-development` | Guide implementation using the RED → GREEN → REFACTOR TDD cycle: write a failing test first, write the minimum code to pass, then refactor while tests stay green. | testing, workflow, quality, core | all |

package/catalog/skills/accessibility-audit/manifest.json

@@ -7,7 +7,7 @@
   "detectors": ["always"],
   "detectionTriggers": ["manual"],
   "installsFor": ["all"],
-  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
     "last-edit": "2026-04-04",

package/catalog/skills/agents-root-orchestrator/manifest.json

@@ -7,7 +7,7 @@
   "detectors": ["always"],
   "detectionTriggers": ["always"],
   "installsFor": ["all"],
-  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
     "last-edit": "2026-04-03",

package/catalog/skills/angular-guidelines/manifest.json

@@ -7,7 +7,7 @@
   "detectors": ["angular"],
   "detectionTriggers": ["auto"],
   "installsFor": ["all"],
-  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
     "last-edit": "2026-04-03",

package/catalog/skills/figma-mcp-0to1/manifest.json

@@ -7,7 +7,7 @@
   "detectors": ["always"],
   "detectionTriggers": ["manual"],
   "installsFor": ["all"],
-  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
     "last-edit": "2026-04-03",

package/catalog/skills/frontend-design/manifest.json

@@ -7,7 +7,7 @@
   "detectors": ["always"],
   "detectionTriggers": ["manual"],
   "installsFor": ["all"],
-  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
     "last-edit": "2026-04-04",

package/catalog/skills/life-guard/manifest.json

@@ -7,7 +7,7 @@
   "detectors": ["always"],
   "detectionTriggers": ["manual"],
   "installsFor": ["all"],
-  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
     "last-edit": "2026-04-04",

package/catalog/skills/skill-creator/manifest.json

@@ -7,7 +7,7 @@
   "detectors": ["always"],
   "detectionTriggers": ["always"],
   "installsFor": ["all"],
-  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
     "last-edit": "2026-03-27",

package/catalog/skills/spec-driven-development/manifest.json

@@ -7,7 +7,7 @@
   "detectors": ["always"],
   "detectionTriggers": ["always"],
   "installsFor": ["all"],
-  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
     "last-edit": "2026-04-03",

package/catalog/skills/test-driven-development/manifest.json

@@ -7,7 +7,7 @@
   "detectors": ["always"],
   "detectionTriggers": ["manual"],
   "installsFor": ["all"],
-  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
     "last-edit": "2026-04-04",

package/catalog/skills/token-optimizer/manifest.json

@@ -7,7 +7,7 @@
   "detectors": ["always"],
   "detectionTriggers": ["always"],
   "installsFor": ["all"],
-  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
     "last-edit": "2026-04-03",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/skilly-hand",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "publishConfig": {

package/packages/cli/src/bin.js

@@ -91,7 +91,7 @@ function buildHelpText(renderer, appVersion) {
     "--json                        Emit stable JSON output for automation",
     "--yes, -y                     Skip install/uninstall confirmations",
     "--verbose, -v                 Reserved for future debug detail",
-    "--agent, -a <name>            codex|claude|cursor|gemini|copilot (repeatable)",
+    "--agent, -a <name>            standard|codex|claude|cursor|gemini|copilot|antigravity|windsurf|trae (repeatable)",
     "--cwd <path>                  Project root (defaults to current directory)",
     "--include <tag>               Include only skills matching all tags",
     "--exclude <tag>               Exclude skills matching any tag",
@@ -102,7 +102,7 @@ function buildHelpText(renderer, appVersion) {
     "npx skilly-hand",
     "npx skilly-hand install --dry-run",
     "npx skilly-hand detect --json",
-    "npx skilly-hand install --agent codex --agent claude",
+    "npx skilly-hand install --agent antigravity --agent windsurf",
     "npx skilly-hand uninstall --yes"
   ], { bullet: "-" }));
 
@@ -352,7 +352,7 @@ async function runInteractiveInstall({
     choices: services.defaultAgents.map((agent) => ({
       value: agent,
       name: agent,
-      checked: true
+      checked: agent === "standard"
     }))
   });
 

package/packages/core/src/index.js

@@ -3,8 +3,45 @@ import path from "node:path";
 import { copySkillTo, loadAllSkills, renderAgentsMarkdown, verifyCatalogFiles } from "../../catalog/src/index.js";
 import { detectProject, inspectProjectFiles } from "../../detectors/src/index.js";
 
-export const DEFAULT_AGENTS = ["codex", "claude", "cursor", "gemini", "copilot"];
+export const DEFAULT_AGENTS = ["standard", "codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"];
 const MANAGED_MARKER = "<!-- Managed by skilly-hand.";
+const AGENT_INSTALL_PROFILES = {
+  standard: {
+    instructionFiles: [["AGENTS.md"]],
+    skillPaths: [["skills"]]
+  },
+  codex: {
+    instructionFiles: [["AGENTS.md"]],
+    skillPaths: [[".codex", "skills"]]
+  },
+  claude: {
+    instructionFiles: [["CLAUDE.md"]],
+    skillPaths: [[".claude", "skills"]]
+  },
+  cursor: {
+    instructionFiles: [["cursor-instructions.md"]],
+    skillPaths: [[".cursor", "skills"]]
+  },
+  gemini: {
+    instructionFiles: [["GEMINI.md"]],
+    skillPaths: [[".gemini", "skills"]]
+  },
+  copilot: {
+    instructionFiles: [[".github", "copilot-instructions.md"]]
+  },
+  antigravity: {
+    instructionFiles: [["AGENTS.md"], [".agents", "rules", "skilly-hand.md"]],
+    skillPaths: [[".agents", "skills"], [".agent", "skills"]]
+  },
+  windsurf: {
+    instructionFiles: [["AGENTS.md"]],
+    skillPaths: [[".windsurf", "skills"]]
+  },
+  trae: {
+    instructionFiles: [["AGENTS.md"]],
+    skillPaths: [[".trae", "skills"]]
+  }
+};
 
 function uniq(values) {
   return [...new Set(values)];
@@ -168,30 +205,29 @@ async function ensureSymlink(targetPath, sourcePath, backupsDir, lockData) {
   lockData.managedSymlinks.push(targetPath);
 }
 
-function buildInstructionFiles({ agentsMarkdown, selectedAgents }) {
-  const files = [];
-
-  if (selectedAgents.includes("codex")) {
-    files.push({ pathParts: ["AGENTS.md"], content: agentsMarkdown });
-  }
-
-  if (selectedAgents.includes("claude")) {
-    files.push({ pathParts: ["CLAUDE.md"], content: agentsMarkdown });
-  }
+function buildInstallTargets(selectedAgents) {
+  const instructionTargets = new Map();
+  const skillTargets = new Map();
 
-  if (selectedAgents.includes("gemini")) {
-    files.push({ pathParts: ["GEMINI.md"], content: agentsMarkdown });
-  }
+  for (const agent of selectedAgents) {
+    const profile = AGENT_INSTALL_PROFILES[agent];
+    if (!profile) {
+      continue;
+    }
 
-  if (selectedAgents.includes("cursor")) {
-    files.push({ pathParts: ["cursor-instructions.md"], content: agentsMarkdown });
-  }
+    for (const pathParts of profile.instructionFiles || []) {
+      instructionTargets.set(path.join(...pathParts), pathParts);
+    }
 
-  if (selectedAgents.includes("copilot")) {
-    files.push({ pathParts: [".github", "copilot-instructions.md"], content: agentsMarkdown });
+    for (const pathParts of profile.skillPaths || []) {
+      skillTargets.set(path.join(...pathParts), pathParts);
+    }
   }
 
-  return files;
+  return {
+    instructionTargets: [...instructionTargets.values()],
+    skillTargets: [...skillTargets.values()]
+  };
 }
 
 export async function installProject({
@@ -252,23 +288,16 @@ export async function installProject({
 
   await writeFile(path.join(installRoot, "AGENTS.md"), agentsMarkdown, "utf8");
 
-  for (const instructionFile of buildInstructionFiles({ agentsMarkdown, selectedAgents })) {
-    await ensureManagedTextFile(path.join(cwd, ...instructionFile.pathParts), instructionFile.content, backupsDir, lockData);
+  const { instructionTargets, skillTargets } = buildInstallTargets(selectedAgents);
+
+  for (const pathParts of instructionTargets) {
+    await ensureManagedTextFile(path.join(cwd, ...pathParts), agentsMarkdown, backupsDir, lockData);
   }
 
   const skillsSourcePath = path.join(installRoot, "catalog");
 
-  if (selectedAgents.includes("codex")) {
-    await ensureSymlink(path.join(cwd, ".codex", "skills"), skillsSourcePath, backupsDir, lockData);
-  }
-  if (selectedAgents.includes("claude")) {
-    await ensureSymlink(path.join(cwd, ".claude", "skills"), skillsSourcePath, backupsDir, lockData);
-  }
-  if (selectedAgents.includes("gemini")) {
-    await ensureSymlink(path.join(cwd, ".gemini", "skills"), skillsSourcePath, backupsDir, lockData);
-  }
-  if (selectedAgents.includes("cursor")) {
-    await ensureSymlink(path.join(cwd, ".cursor", "skills"), skillsSourcePath, backupsDir, lockData);
+  for (const pathParts of skillTargets) {
+    await ensureSymlink(path.join(cwd, ...pathParts), skillsSourcePath, backupsDir, lockData);
   }
 
   await writeJson(lockPath, lockData);