Supported agents

GSKILL installs skills into seven AI coding agents. Every project skill’s content is committed once at .agents/skills/<name>/. Claude Code, Codex, and Cursor each get their own skills directory that links to it. Antigravity CLI, OpenCode, OpenClaw, and Hermes Agent read .agents/skills/ directly, so GSKILL creates nothing extra for them.

Adapters

Agent	Agent ID	Detected by	Project install	Global install (`--global`)
Claude Code	`claude`	`.claude/`	`.claude/skills/<name>/` (link)	`~/.claude/skills/<name>/`
Codex	`codex`	`.codex/`	`.codex/skills/<name>/` (link)	`~/.codex/skills/<name>/`
Cursor	`cursor`	`.cursor/`	`.cursor/skills/<name>/` (link)	`~/.cursor/skills/<name>/`
Antigravity CLI	`antigravity`	never detected	`.agents/skills/<name>/` (shared)	`~/.gemini/antigravity-cli/skills/<name>/`
OpenCode	`opencode`	`.opencode/`, `opencode.json`, or `opencode.jsonc`	`.agents/skills/<name>/` (shared)	`~/.config/opencode/skills/<name>/`
OpenClaw	`openclaw`	never detected	`.agents/skills/<name>/` (shared)	`~/.openclaw/skills/<name>/`
Hermes Agent	`hermes`	`.hermes/`	`.agents/skills/<name>/` (shared)	`~/.hermes/skills/<name>/`

Use an agent ID with --agent (e.g. gskill add ./skill --agent opencode). Any other ID fails with exit 9, and the error lists the supported IDs.

Shared-location agents

Antigravity CLI, OpenCode, OpenClaw, and Hermes Agent read project skills from .agents/skills/, the directory where GSKILL commits each skill. Installing a skill for one of them records the agent in skills-lock.json with mode shared and writes no other file or link. --copy and --symlink have no effect on these agents. They still apply to the other agents in the same command.

Because all four read that directory, every project skill is visible to all four, whichever agents you target. Targeting decides what GSKILL records and what --global installs, not what these agents can see.

OpenCode also reads .claude/skills/, so in a project that targets both claude and opencode it can find the same skill twice. Both copies have identical content.

Per-agent notes

Antigravity CLI: global installs go to the CLI’s own folder. The folder shared with the Antigravity IDE and desktop app (~/.gemini/config/skills/) is not written.
OpenCode: OpenCode skips a skill whose frontmatter name differs from its directory, or is longer than 64 characters. GSKILL names the installed directory after the source folder, so when the two differ, add, install, and gskill project check print a warning naming the skill. The install itself still succeeds.
OpenClaw: OpenClaw sees project skills only when the repository is its workspace. If you run OpenClaw from its default workspace, install with --global.
Hermes Agent: Hermes loads a repository’s skills only after you trust the project once with hermes skills trust. GSKILL prints this reminder after a project install that targets hermes, and gskill doctor lists it as a note.

Detection

When you don’t pass --agent, GSKILL installs into the agents it detects in the project, using the markers in the table above.
Antigravity CLI and OpenClaw have no project marker. Name them with --agent, in a skill’s agents list in skills.toml, or in defaults.agents.
.agents/ never counts as a marker, because every GSKILL project has one.
If you specify no agents and none are detected, GSKILL writes nothing and exits 9 (unsupported / undetected agent).
gskill doctor reports which agents are detected.

Scope

Project (default): the content is committed at .agents/skills/<name>/. Claude Code, Codex, and Cursor each get a committed relative symlink into it; the shared-location agents read it directly.
Global (--global): skills install as verified copies into each agent’s user-global location (the last column above), outside the repo-owned model.