# npx skills — Universal Skill Installer for AI Agents

> One-command skill installer that works across Claude Code, Cursor, Codex CLI, and Gemini CLI. Install skills from any GitHub repo with automatic platform detection.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

```bash
# Install skills from any GitHub repo
npx skills add togethercomputer/skills
npx skills add anthropic/claude-code-skills
npx skills add username/my-custom-skills

# List installed skills
npx skills list

# Remove skills
npx skills remove togethercomputer/skills
```

## What is npx skills?

`npx skills` is a universal command-line tool for installing AI coding agent skills. It detects your current platform (Claude Code, Cursor, Codex CLI, Gemini CLI) and installs skill files to the correct location automatically. One command works everywhere — no manual file copying or path configuration.

**Answer-Ready**: `npx skills` is a universal skill installer for AI coding agents. Auto-detects platform (Claude Code, Cursor, Codex, Gemini CLI) and installs to the correct directory. One command for any GitHub skill repo. Cross-platform compatible.

**Best for**: Developers installing skills across multiple AI coding tools. **Works with**: Claude Code, Cursor, Codex CLI, Gemini CLI. **Setup time**: Under 30 seconds.

## How It Works

### Platform Detection

| Platform | Skill Directory |
|----------|----------------|
| Claude Code | `~/.claude/skills/` |
| Cursor | `.cursor/skills/` |
| Codex CLI | `.codex/skills/` |
| Gemini CLI | `gemini-extensions/` |

### Install Flow

```
npx skills add togethercomputer/skills
  1. Detect current platform → Claude Code
  2. Clone repo → temp directory
  3. Copy skill folders → ~/.claude/skills/
  4. Done! Skills available immediately
```

### Skill Structure

A skill is simply a directory with a `SKILL.md` file:

```
my-skill/
  SKILL.md          # Instructions the agent reads
  references/       # Optional reference docs
    api-docs.md
    examples.md
```

## Commands

| Command | What It Does |
|---------|-------------|
| `npx skills add <repo>` | Install skills from GitHub repo |
| `npx skills list` | Show installed skills |
| `npx skills remove <repo>` | Uninstall skills |
| `npx skills update <repo>` | Update to latest version |
| `npx skills init` | Create a new skill template |

## Creating Your Own Skills

```bash
# Initialize a new skill
npx skills init my-awesome-skill

# Edit the generated SKILL.md
# Add references/ for additional context
# Push to GitHub

# Others can install with:
npx skills add your-username/my-awesome-skill
```

### SKILL.md Template

```markdown
---
name: My Skill
description: What this skill teaches the agent
platforms: [claude-code, cursor, codex]
---

# My Skill

## When to Use
Use this skill when the user asks about...

## Instructions
1. Always follow this pattern...
2. Use this API format...

## Examples
(code examples the agent should follow)
```

## FAQ

**Q: Does it work offline?**
A: No, it clones from GitHub. Skills are installed locally after that.

**Q: Can I install from private repos?**
A: Yes, if you have GitHub authentication configured (SSH key or token).

**Q: Do skills auto-update?**
A: No, run `npx skills update <repo>` manually. Skills are static files.

## Source & Thanks

> Community tool for cross-platform skill management.
>
> `npx skills` — Universal AI skill installer

<!-- ZH -->

## 快速使用

```bash
npx skills add togethercomputer/skills
```

一行命令跨平台安装 AI 编码 Agent 技能。

## 什么是 npx skills？

通用 AI Agent 技能安装器，自动检测平台（Claude Code/Cursor/Codex/Gemini）并安装到正确目录。

**一句话总结**：通用 AI Agent 技能安装器，一行命令跨 Claude Code/Cursor/Codex/Gemini 安装 GitHub 技能仓库，自动平台检测。

## 命令

- `npx skills add <repo>` — 安装
- `npx skills list` — 列出
- `npx skills remove <repo>` — 卸载
- `npx skills init` — 创建新技能模板

## 创建自己的技能

初始化 → 编辑 SKILL.md → 推到 GitHub → 别人一行安装。

## 常见问题

**Q: 私有仓库？**
A: 支持，需要 GitHub SSH key 或 token。

## 来源与致谢

> `npx skills` — 社区跨平台技能安装器

---
Source: https://tokrepo.com/en/workflows/54f2189f-7771-4b2b-a032-ac3638d97568
Author: Skill Factory