Installation Guide

Every way to install agent-skill-creator (and the skills it generates) beyond the one-liner in the README Quick start: per-tool native plugins, per-project clones, all 17 platform paths, and the universal skill installer.

Advanced Install

If you prefer to install to a single tool, or you already cloned the repo:

Install from inside your agent — by runtime:

The repo ships native plugin/extension manifests for every runtime that has an in-tool install. Commands follow each runtime's official plugin docs; the universal installer below always works as the fallback.

Claude Code — send as two separate prompts:

/plugin marketplace add FrancyJGLisboa/agent-skill-creator
/plugin install agent-skill-creator@agent-skill-creator

OpenAI Codex CLI (plugins since v0.117):

codex plugin marketplace add FrancyJGLisboa/agent-skill-creator
codex plugin add agent-skill-creator@agent-skill-creator

GitHub Copilot CLI — shell or the in-TUI slash equivalents:

copilot plugin marketplace add FrancyJGLisboa/agent-skill-creator
copilot plugin install agent-skill-creator@agent-skill-creator

/plugin marketplace add FrancyJGLisboa/agent-skill-creator
/plugin install agent-skill-creator@agent-skill-creator

Gemini CLI (also Antigravity CLI via agy plugin install):

gemini extensions install https://github.com/FrancyJGLisboa/agent-skill-creator

Cursor — in-editor only (no CLI install): command palette → /add-plugin, or add the repo as a marketplace under Customize. The .cursor-plugin/ manifests are shipped; .cursor/rules file-copy still works too.

opencode · Goose · everything else — no native install verb; these read skills from ~/.agents/skills/ or their own skill folders, which is exactly what the one-line bootstrap and install.sh set up.

Runtime	Mechanism	Manifest shipped
Claude Code	`/plugin marketplace add` + `/plugin install`	`.claude-plugin/`
Codex CLI	`codex plugin marketplace add` + `codex plugin add`	`.codex-plugin/` + `.agents/plugins/marketplace.json`
Copilot CLI	`copilot plugin install` or in-TUI `/plugin`	`.github/plugin/`
Gemini CLI / Antigravity	`gemini extensions install <repo-url>`	`gemini-extension.json` (context: `AGENTS.md`)
Cursor	in-editor `/add-plugin`	`.cursor-plugin/`
opencode, Goose, 10 more	universal path / installer	`install.sh`, `bootstrap.sh`

Skills generated by the factory ship the same Claude Code manifests, so any skill it builds is installable with /plugin marketplace add <repo-or-local-path>.

Clone to a specific tool: every per-tool git clone path is in Global install and Per-project install below — one canonical list.

Already cloned? Link to all tools:

macOS / Linux:

cd agent-skill-creator
./install.sh              # Link to all detected platforms
./install.sh --dry-run    # Preview without changes
./install.sh --uninstall  # Remove all links

Windows (PowerShell):

cd agent-skill-creator
.\install.ps1              # Link to all detected platforms
.\install.ps1 -DryRun     # Preview without changes
.\install.ps1 -Uninstall  # Remove all links

See the full platform table below for every supported tool and path.

All Platforms

17 platforms supported. Same skill, same invocation, same results everywhere.

How it works

Every generated skill outputs both SKILL.md (~15 tools read it natively) and AGENTS.md (~15 tools read it) to maximize reach. Tools in Tier 2 need format conversion — the installer handles it automatically.

Tier	Platforms	What happens
Tier 1 — Native SKILL.md	Claude Code, Copilot, Codex CLI, Gemini CLI, Kiro, Cline, Roo Code, Kilo Code, Goose, OpenCode, Factory Droid, Antigravity	Reads SKILL.md directly
Tier 2 — Auto-adapted	Cursor, Windsurf, Trae, Junie	Installer converts SKILL.md to native format (.mdc, .md rules, guidelines)
Tier 3 — Manual	Zed, Augment, Aider, Continue.dev	Copy skill body into tool's config file

Global install (each tool's native path)

# Claude Code
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.claude/skills/agent-skill-creator

# GitHub Copilot
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.copilot/skills/agent-skill-creator

# Gemini CLI
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.gemini/skills/agent-skill-creator

# Kiro
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.kiro/skills/agent-skill-creator

# Cline
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.cline/skills/agent-skill-creator

# Roo Code
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.roo/skills/agent-skill-creator

# Kilo Code
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.kilocode/skills/agent-skill-creator

# Factory Droid
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.factory/skills/agent-skill-creator

# Goose
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.config/goose/skills/agent-skill-creator

# OpenCode
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.config/opencode/skills/agent-skill-creator

# Codex CLI / universal path (read by 7+ tools as fallback)
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.agents/skills/agent-skill-creator

Use each tool's own native path. The universal ~/.agents/skills/ path works as a fallback for Codex CLI, Gemini CLI, OpenCode, Goose, Cline, Roo Code, and Kilo Code.

Per-project install

# GitHub Copilot
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .github/skills/agent-skill-creator

# Cursor (project only — no global path exists)
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .cursor/skills/agent-skill-creator

# Windsurf
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .windsurf/rules/agent-skill-creator

# Cline
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .clinerules/skills/agent-skill-creator

# Kiro
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .kiro/skills/agent-skill-creator

# Trae
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .trae/rules/agent-skill-creator

# Roo Code
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .roo/skills/agent-skill-creator

# Kilo Code
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .kilocode/skills/agent-skill-creator

# Junie (JetBrains)
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .junie/skills/agent-skill-creator

# Antigravity (note: .agent/ singular, NOT .agents/)
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .agent/skills/agent-skill-creator

Cursor — global workaround

Cursor has no global skills directory. Clone once and symlink per project:

# 1. Clone once
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/agent-skills/agent-skill-creator

# 2. In any project, symlink
mkdir -p .cursor/rules && ln -s ~/agent-skills/agent-skill-creator .cursor/rules/agent-skill-creator

Add a shell alias to automate this (~/.zshrc or ~/.bashrc):

alias install-skills='mkdir -p .cursor/rules && ln -s ~/agent-skills/agent-skill-creator .cursor/rules/agent-skill-creator'

Then in any project: install-skills. Updates propagate automatically via the symlink.

Using the installer (for generated skills)

Every skill generated by agent-skill-creator includes a cross-platform installer — both install.sh (macOS/Linux) and install.ps1 (Windows):

macOS / Linux:

./install.sh                          # Auto-detect platform
./install.sh --platform cursor        # Force specific platform (auto-generates .mdc)
./install.sh --all                    # Install to every detected tool at once
./install.sh --dry-run                # Preview without installing

Windows (PowerShell):

.\install.ps1                          # Auto-detect platform
.\install.ps1 -Platform cursor         # Force specific platform
.\install.ps1 -All                     # Install to every detected tool at once
.\install.ps1 -DryRun                  # Preview without installing

Both installers handle all 17 platforms and create a universal ~/.agents/skills/ link after every install for cross-tool discoverability.

Claude Desktop / claude.ai

python3 scripts/export_utils.py ./agent-skill-creator/ --variant desktop
# Then: Settings > Skills > Upload the generated .zip

Update

cd ~/.agents/skills/agent-skill-creator && git pull

If you used the bootstrap one-liner or ./install.sh, all symlinks update automatically — just git pull once from the canonical location. The skill also performs a silent git-based version check when loaded and will mention if a newer version is available.

Install Any Skill (Universal Installer)