agent-skills-platform

Installation Guide

Every way to install agent-skills-platform (and the skills it generates) beyond the chooser in Create your first skill: per-tool native plugins, per-project clones, all 17 platform paths, and the universal skill installer.

Installing a skill you didn’t write? Scan it first. A skill ships executable scripts that run with your filesystem access and your API keys, and its instruction body is read by the agent before any code runs.
python3 scripts/skill_graph.py run ./the-skill/ --jobs 4
Every skill is checked as one connected system. The skill graph links its instructions, scripts, evaluations, and expected outputs. Two structural requirements confirm that every expected result is tested and every predictable multi-step workflow has one reliable entry point. Four checks—specification, pipeline, security, and evaluation schema—run in parallel. Finally, a representative run proves that the skill produces a useful result.

See Why the checks matter. Everything below assumes you trust the source.

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-skills-platform
/plugin install agent-skills-platform@agent-skills-platform

OpenAI Codex CLI (plugins since v0.117):

codex plugin marketplace add FrancyJGLisboa/agent-skills-platform
codex plugin add agent-skills-platform@agent-skills-platform

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

copilot plugin marketplace add FrancyJGLisboa/agent-skills-platform
copilot plugin install agent-skills-platform@agent-skills-platform

/plugin marketplace add FrancyJGLisboa/agent-skills-platform
/plugin install agent-skills-platform@agent-skills-platform

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

gemini extensions install https://github.com/FrancyJGLisboa/agent-skills-platform

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>.

Governed team bundles for VS Code Copilot

An ACME marketplace release installs through GitHub CLI 2.90 or newer. Every managed install must pin an immutable tag:

python3 scripts/team_marketplace.py install \
  --bundle analyst-starter \
  --scope user \
  --pin v1.2.0 \
  --marketplace ./acme-skills

Use --scope project to install under the current repository. To roll back, repeat the command with the previous tag and --force. GitHub selects exact skill paths through gh skill. GitLab shallow-clones the configured repository at the exact tag and copies only the bundle’s declared paths into Copilot.

Repository creation, schema-v1 migration, approval gates, and releases are in the complete marketplace timeline.

GitLab setup, release, install, update, and rollback commands are in the GitLab marketplace workflow.

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-skills-platform
./install.sh              # Link to all detected platforms
./install.sh              # Also installs pinned Semantic Recon by default
./install.sh --without-semantic-recon  # Explicit opt-out for source-free environments
./install.sh --dry-run    # Preview without changes
./install.sh --uninstall  # Remove all links

Windows (PowerShell):

cd agent-skills-platform
.\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-skills-platform.git ~/.claude/skills/agent-skills-platform

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

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

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

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

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

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

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

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

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

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

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-skills-platform.git .github/skills/agent-skills-platform

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

# Windsurf
git clone https://github.com/FrancyJGLisboa/agent-skills-platform.git .windsurf/rules/agent-skills-platform

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

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

# Trae
git clone https://github.com/FrancyJGLisboa/agent-skills-platform.git .trae/rules/agent-skills-platform

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

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

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

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

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-skills-platform.git ~/agent-skills/agent-skills-platform

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

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

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

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

Using the installer (for generated skills)

Every skill generated by agent-skills-platform 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-skills-platform/ --variant desktop
# Then: Settings > Skills > Upload the generated .zip

Update

cd ~/.agents/skills/agent-skills-platform && 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)

macOS / Linux:

# From git URL
./scripts/install-skill.sh https://github.com/someone/sales-report-skill.git

# From local path
./scripts/install-skill.sh ./sales-report-skill

# To a specific platform only
./scripts/install-skill.sh ./sales-report-skill --platform cursor --project

# Preview / remove
./scripts/install-skill.sh ./sales-report-skill --dry-run
./scripts/install-skill.sh ./sales-report-skill --uninstall

Windows (PowerShell):

# From git URL
.\scripts\install-skill.ps1 https://github.com/someone/sales-report-skill.git

# From local path
.\scripts\install-skill.ps1 .\sales-report-skill

# To a specific platform only
.\scripts\install-skill.ps1 .\sales-report-skill -Platform cursor -Project

# Preview / remove
.\scripts\install-skill.ps1 .\sales-report-skill -DryRun
.\scripts\install-skill.ps1 .\sales-report-skill -Uninstall

This site is open source. Improve this page.