Skip to content

phlx0/copilot-skills

Repository files navigation

copilot-skills

npm version npm downloads License: MIT Node.js ≥18 CI

Install and manage AI agent skills for GitHub Copilot — and any AI coding tool.

antigravity-awesome-skills (34k+ ⭐) indexes skills for every major AI coding tool. GitHub Copilot was the one tool with no installer. copilot-skills fills that gap.

demo

npx copilot-skills add brainstorming
npx copilot-skills add openai:gh-address-comments
npx copilot-skills add https://github.com/google-labs-code/stitch-skills/tree/main/skills/stitch-design
npx copilot-skills info brainstorming
npx copilot-skills search design --all

Skills are installed to ~/.copilot/skills/<name>/SKILL.md — exactly where VS Code Copilot picks them up.


Installation

No install required — use npx:

npx copilot-skills <command>

Or install globally:

npm install -g copilot-skills

Commands

add <source>

Install a skill from a registry, GitHub URL, or local path.

# From the default registry (antigravity-awesome-skills)
npx copilot-skills add brainstorming
npx copilot-skills add code-review

# From a named registry (registry:skill)
npx copilot-skills add openai:gh-address-comments
npx copilot-skills add openai:pr-description

# From a GitHub URL (tree or blob link)
npx copilot-skills add https://github.com/google-labs-code/stitch-skills/tree/main/skills/stitch-design

# From a GitHub repo path (owner/repo/path)
npx copilot-skills add sickn33/antigravity-awesome-skills/skills/brainstorming

# From a local directory
npx copilot-skills add ./my-skill

list

Show all installed skills with descriptions and sources.

npx copilot-skills list

search <query>

Search the registry index for available skills.

# Search default registry
npx copilot-skills search brainstorming

# Search a specific registry
npx copilot-skills search refactor --registry openai

# Search all registries at once
npx copilot-skills search design --all

info <source>

Preview a skill — description, file list, and install command — without installing it.

npx copilot-skills info brainstorming
npx copilot-skills info openai:gh-address-comments
npx copilot-skills info https://github.com/google-labs-code/stitch-skills/tree/main/skills/stitch-design

update [name]

Update a specific skill or all installed skills.

npx copilot-skills update brainstorming
npx copilot-skills update --all

registries

List all available registry keys and their sources.

npx copilot-skills registries

remove <name>

Uninstall a skill.

npx copilot-skills remove brainstorming

Global options

All commands accept --path / -p to use a custom skills directory:

npx copilot-skills list --path ./project/.copilot/skills

Registries

Key Source Notes
(default) sickn33/antigravity-awesome-skills 34k+ ⭐ · has index for fast search
openai openai/skills Codex / ChatGPT skills
google google-labs-code/stitch-skills Stitch / Gemini design skills
anthropic anthropics/skills Claude skills

How it works

Skills are SKILL.md files (with optional supporting assets) that instruct an AI coding agent how to perform a specialized task. GitHub Copilot in VS Code automatically picks up any .md file under ~/.copilot/skills/.

copilot-skills handles:

  • Discovery — searching indexed registries by keyword
  • Install — downloading skill files from GitHub via the Contents API
  • Manifest — tracking installed skills in ~/.copilot/skills/.manifest.json
  • Updates — re-fetching skills from their original sources
  • Security — sanitizing skill names and file paths to prevent directory traversal

Environment variables

Variable Description
GITHUB_TOKEN Optional. Increases GitHub API rate limit from 60 to 5000 req/h

Contributing

PRs welcome! To add a new registry, open an issue or PR editing src/lib/registry.js.

See CONTRIBUTING.md for details.


License

MIT © 2025 phlx0

About

Install and manage AI agent skills for GitHub Copilot and other AI coding tools

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Contributors