AutoGineer
Generated banner for Skill Installer
Generated logo for Skill Installer

Skill Installer

JetBrainsOfficialCreated by OpenAIDistributed by JetBrains

  • Skill
  • Workflow
  • Agent tooling
  • Apache-2.0
  • Low risk
  • Has scripts
Download ZIP

From the author

Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).
— the description by OpenAI

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The skill-installer provides a structured way to manage the capabilities of a Codex agent. It allows users to browse available skills from a curated repository or install specific skills directly from GitHub paths. The tool handles the retrieval process, including support for private repositories, and ensures that new skills are correctly placed within the local environment. It serves as the primary interface for extending agent functionality by automating the download and directory setup required for new skills to be recognized by the system.

What it does

  • Lists available skills from curated or experimental repositories.
  • Installs new skills from specified GitHub repository paths.
  • Supports installation from private GitHub repositories using existing credentials.
  • Provides status information on whether a skill is already installed.
  • Automates the directory placement of skills into the local Codex environment.

When to use it

  • When a user wants to see what additional capabilities are available for their agent.
  • When a user needs to add a specific skill from a GitHub repository.
  • When a user wants to explore experimental features or community-contributed skills.
  • When setting up a new agent environment that requires specific custom skills.

Advantages

  • Simplifies the process of extending agent functionality.
  • Provides a unified interface for both curated and custom skill sources.
  • Handles complex git operations like sparse checkouts automatically.
  • Integrates seamlessly with existing git authentication for private access.

Usage examples

“What skills can I install?”
The agent lists the available skills from the curated repository, indicating which ones are already present in the local environment.
“Install the web-search skill from the curated list.”
The agent downloads the specified skill and prompts the user to restart Codex to finalize the installation.
“Install a custom skill from my private repo at github.com/myorg/my-skills/tree/main/my-tool.”
The agent uses the installer to fetch the skill from the private repository and places it in the local skills directory.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/jetbrains/skill-installer/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip skill-installer.zip -d .agents/skills

Documentation by OpenAI

Skill Installer

Helps install skills. By default these are from https://github.com/openai/skills/tree/main/skills/.curated, but users can also provide other locations.

Use the helper scripts based on the task:

  • List skills when the user asks what is available, or if the user uses this skill without specifying what to do. Default listing is .curated, but you can pass --path skills/.experimental when they ask about experimental skills.

  • Install from the curated list when the user provides a skill name.

  • Install from another repo when the user provides a GitHub repo/path (including private repos).

Install skills with the helper scripts.

Communication

When listing skills, output approximately as follows, depending on the context of the user's request. If they ask about experimental skills, list from .experimental instead of .curated and label the source accordingly: """ Skills from {repo}:

  1. skill-1

  2. skill-2 (already installed)

  3. ... Which ones would you like installed? """

After installing a skill, tell the user: "Restart Codex to pick up new skills."

Scripts

All of these scripts use network, so when running in the sandbox, request escalation when running them.

  • scripts/list-skills.py (prints skills list with installed annotations)

  • scripts/list-skills.py --format json

  • Example (experimental list): scripts/list-skills.py --path skills/.experimental

  • scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/to/skill> [<path/to/skill> ...]

  • scripts/install-skill-from-github.py --url https://github.com/<owner>/<repo>/tree/<ref>/<path>

  • Example (experimental skill): scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>

Behavior and Options

  • Defaults to direct download for public GitHub repos.

  • If download fails with auth/permission errors, falls back to git sparse checkout.

  • Aborts if the destination skill directory already exists.

  • Installs into $CODEX_HOME/skills/<skill-name> (defaults to ~/.codex/skills).

  • Multiple --path values install multiple skills in one run, each named from the path basename unless --name is supplied.

  • Options: --ref <ref> (default main), --dest <path>, --method auto|download|git.

Notes

  • Curated listing is fetched from https://github.com/openai/skills/tree/main/skills/.curated via the GitHub API. If it is unavailable, explain the error and exit.

  • Private GitHub repos can be accessed via existing git credentials or optional GITHUB_TOKEN/GH_TOKEN for download.

  • Git fallback tries HTTPS first, then SSH.

  • The skills at https://github.com/openai/skills/tree/main/skills/.system are preinstalled, so no need to help users install those. If they ask, just explain this. If they insist, you can download and overwrite.

  • Installed annotations come from $CODEX_HOME/skills.

Files

agents/openai.yaml

interface:
  display_name: "Skill Installer"
  short_description: "Install curated skills from openai/skills or other repos"
  icon_small: "./assets/skill-installer-small.svg"
  icon_large: "./assets/skill-installer.png"

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs Python

Security

What our scanner noticed· Low risk

  • Scripts that your agent may run

This skill includes scripts that your agent may run. Read them before you use it.

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
OpenAI
Publisher
JetBrains (Official)
Distributed by
JetBrains
Source
JetBrains/skills · skill-installer · commit 3f53782
Licence
Apache License 2.0 (redistribution allowed)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by OpenAI or JetBrains.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download skill-installer.zip