Skilltap

skilltap

One repo = one skill market, even when skills live in nested folders.

Install AI agent skills from any git repository — with multi-agent support.

[中文文档](./README.zh-CN.md) | English

Install

# As a CLI (global)
npm install -g @eddiearc/skilltap

# As an SDK
npm install @eddiearc/skilltap

Concept

A **tap** is a repository containing AI agent skills (directories with `SKILL.md`). `skilltap` recursively discovers skill folders, so it works with both flat repos and nested layouts such as `skills/pdf/SKILL.md`.

Taps can live anywhere — GitHub, GitLab, Bitbucket, Gitea, or any self-hosted git server. Private repos authenticate automatically via your existing SSH keys or credential helper, with no extra token configuration needed.

github.com/anthropics/skills/       <- this is a tap
├── skills/
│   ├── pdf/
│   │   └── SKILL.md
│   ├── frontend-design/
│   │   └── SKILL.md
│   └── canvas-design/
│       └── SKILL.md
└── template/
    └── SKILL.md

Skills are installed to `~/.agents/skills/` (universal directory) by default, and can be symlinked to any agent's directory.

CLI Usage

Marketplace (Recommended)

Marketplaces are git repositories or local directories that act as skill sources. Unlike the legacy source system, they work with any git hosting platform, authenticate via your existing SSH keys, and avoid GitHub REST API rate limits.

Add a marketplace

# GitHub (HTTPS)
skilltap marketplace add anthropics https://github.com/anthropics/skills

# GitHub (SSH) — uses your SSH key automatically for private repos
skilltap marketplace add my-private git@github.com:myorg/private-skills.git

# GitLab (self-hosted)
skilltap marketplace add corp https://gitlab.mycompany.com/team/skills

# Bitbucket
skilltap marketplace add bb https://bitbucket.org/owner/skills-repo

# Local directory
skilltap marketplace add local /path/to/my/skills

# Specific branch
skilltap marketplace add staging https://github.com/anthropics