uberskills

The open agent skills ecosystem — discover and install skills for your AI coding agent.

uberskills add vercel-labs/agent-skills
uberskills find typescript
uberskills list
uberskills update

Installation

npm install -g uberskills
# or run without installing:
npx uberskills

Commands

| Command | Description | |---------|-------------| | uberskills add <package> | Install a skill from GitHub or a URL | | uberskills find [query] | Search for skills interactively | | uberskills list | List installed skills | | uberskills remove | Remove installed skills | | uberskills check | Check for available updates | | uberskills update | Update all skills to latest versions | | uberskills init [name] | Scaffold a new SKILL.md | | uberskills experimental_install | Restore skills from skills-lock.json | | uberskills experimental_sync | Sync skills from node_modules |

Sources

Skills can be installed from:

• GitHub shorthand: uberskills add owner/repo
• GitHub URL: uberskills add https://github.com/owner/repo
• Specific skill: uberskills add owner/repo@skill-name
• Local path: uberskills add ./my-skill
• Direct URL: uberskills add https://example.com/SKILL.md

Options

-g, --global           Install globally (~/ instead of project)
-a, --agent <agents>   Target specific agents
-s, --skill <skills>   Select specific skills from a repo
-y, --yes              Skip confirmation prompts
--copy                 Copy files instead of symlinking
--all                  Install all skills to all agents non-interactively

Supported Agents

uberskills installs skills into agent-specific directories for 40+ agents including Claude Code, Cursor, Windsurf, OpenCode, Pi, Codex, and more.

Skills are installed to .agents/skills/ (universal) and symlinked into each agent's expected location automatically.

Environment Variables

| Variable | Description | |----------|-------------| | UBERSKILLS_API_URL | Override the skills search API endpoint | | UBERSKILLS_TELEMETRY_URL | Enable telemetry by setting an endpoint URL | | DISABLE_TELEMETRY | Disable telemetry (also respects DO_NOT_TRACK) |

Development

pnpm install
pnpm build      # build dist/
pnpm dev        # run from source with tsx
pnpm test       # run tests
pnpm type-check # TypeScript type checking

Architecture

src/
  cli.ts            Entry point — command routing, banner, version
  add.ts            install command (GitHub clone, direct URL, well-known)
  find.ts           search/find command (API-backed)
  list.ts           list installed skills
  remove.ts         remove skills
  check / update    (in cli.ts) version checking via GitHub Trees API
  sync.ts           sync skills from node_modules
  install.ts        restore from skills-lock.json
  agents.ts         agent configs (skill dirs, detection)
  installer.ts      file system install/symlink/copy logic
  skills.ts         SKILL.md discovery and parsing
  source-parser.ts  parse source strings (GitHub URLs, shorthand, etc.)
  git.ts            git clone via simple-git
  skill-lock.ts     global lock file (~/.agents/.skill-lock.json)
  local-lock.ts     project lock file (skills-lock.json)
  telemetry.ts      optional telemetry (disabled by default)
  providers/        host providers (Mintlify, HuggingFace, well-known)
  prompts/          custom interactive prompts

License

MIT