Docs / quickstart

Better tools for
the agent you use.

Chops searches a public index of Agent Skills and installs source-pinned, digest-verified contents into one shared local store, linked into every agent you use. No account, no global install — everything below works from a bare terminal.

01

Install the CLI

The CLI ships on npm as chops-sh and installs the chops command. No account required for public skills.

npm install -g chops-sh

Prefer not to install anything? Every command below also works as npx chops-sh <command> — that’s the form skill pages use, and the right one for agents and CI.

02

Find by intent

Describe the outcome you want — Chops combines semantic and keyword relevance, so “make my queries faster” finds a skill described as “database query optimization.” Returns the top 10 matches.

chops find "optimize postgres queries"
03

Add the skill

Use the slug from a result (owner/repo@skill). Chops downloads the pinned package, checks its SHA-256 digest against the registry manifest, and only then links it into your agents. You’ll be asked to confirm first — pass --yes to skip.

chops add owner/repo@skill
04

Teams & private skills

Some skills shouldn’t be public — deploy runbooks, internal APIs, house style. Chops hosts those privately: @me/<name> for just you, @<team>/<name> for your team. Private skills are encrypted at rest and never appear in the public index or search.

Sign in without leaving the terminal — a one-time email code, no password, no browser:

chops auth start you@company.com
chops auth verify 123456

Publish a skill directory privately (add --team to share it):

chops publish ./skills/deploy --team yourteam

Create a team and invite teammates by email. Invites can be accepted from the browser or entirely in-terminal with chops team join:

chops team create yourteam
chops team invite dana@company.com

Teammates install with the same verified flow as public skills — digest checked, linked into every agent:

chops add @yourteam/deploy

Manage members, pending invites, and your team’s skill list at chops.sh/app/teams. Teams are free while in preview.

05

Commands & flags

The full surface — small on purpose.

CommandWhat it does
find "<query>"Search the index by intent. Top 10 results, ranked by relevance.
add <ref>Verify, install, and link a skill — public (owner/repo@skill) or private (@me/name, @team/name). Confirms before writing unless --yes.
listShow everything installed, from the lockfile — public, private, and team.
remove <ref>Remove the store entry and its agent links.
auth start|verify|status|logoutPasswordless sign-in with a one-time email code. Credentials live in ~/.chops/credentials.json (0600).
team create|list|invite|join|membersCreate teams, invite by email, accept invites, see who’s in.
publish <path> [--team <slug>]Publish a skill privately — to you by default, to a team with --team. Encrypted at rest.
help · --versionUsage and CLI version.
FlagMeaning
--jsonMachine-readable output. The right mode when an agent is driving.
--yes, -ySkip the install confirmation. Required when there’s no TTY.
--agent <names>Where to link, comma-separated: claude-code, cursor, codex (alias agents — the shared ~/.agents/skills). Default: ~/.agents/skills, plus ~/.claude/skills when it exists.
--api-url <url>Point at another registry (default https://api.chops.sh; env CHOPS_API_URL).
06

How an install works

Five steps, each one inspectable afterwards:

  1. The registry returns a manifest: your slug, the pinned content SHA, and the package’s SHA-256 digest.
  2. The tarball is downloaded and rejected outright if its digest doesn’t match the manifest.
  3. Contents unpack once into ~/.chops/store/<owner>/<repo>/<skill>@<sha>/.
  4. That store path is symlinked into each selected agent directory (junctions on Windows).
  5. The install is recorded in ~/.chops/chops.lock.

Published versions are immutable — packages are content-addressed and mirrored by the registry, so a force-pushed source repo can’t change what you already installed.

07

For coding agents

Chops is built to be driven by your agent, not just for it. Two rules: always --json, always --yes.

npx chops-sh find "your task" --json
npx chops-sh add owner/repo@skill --yes --json

find --json returns each result’s slug, description, publisher, agent compatibility, stars, installs, last-published date, and pinned SHA — everything needed to explain a choice before installing. add --json returns { ok, slug, sha, store, links }. Failures print a JSON error and exit non-zero.

Agent-readable docs. This documentation is published for machines too: chops.sh/llms.txt (overview + links), chops.sh/docs.md (this page as markdown), and api.chops.sh/llms.txt (curl-only workflow, straight from the API). Point your agent at any of them.
08

Headless: curl only

The entire read path is plain HTTP — an LLM (or anyone) can find and install skills with nothing installed. Search, read the manifest, download the tarball, check the digest, unpack:

curl "https://api.chops.sh/skills/search?q=optimize+postgres+queries&limit=5"
curl "https://api.chops.sh/manifest?slug=owner/repo@skill"
curl -L -o skill.tgz "<tarball_url>" && shasum -a 256 skill.tgz
tar -xzf skill.tgz -C ~/.agents/skills/<skill-name>

The digest must equal the manifest’s sha256 — discard the download if it doesn’t. Tarballs are immutable and content-addressed. The API also documents itself: curl api.chops.sh returns an endpoint map, and api.chops.sh/llms.txt serves this whole workflow as plain text an agent can read directly.

09

Public registry API

Everything the CLI uses is a plain, unauthenticated HTTP API at https://api.chops.sh — build on it directly if you prefer.

EndpointReturns
GET /skills/search?q=<query>&limit=<1-50>Hybrid semantic + keyword search results. Optional owner and agent filters.
GET /skills?sort=popular|recent&limit=<1-50>&offset=<n>The browsable index with a total count.
GET /manifest?slug=<owner/repo@skill>Pinned version, tarball URL, SHA-256 digest, size.
GET /tarballs/<sha256>The immutable, content-addressed package.
GET /health · GET /versionService status and deployed version.
10

Use it everywhere

Chops maintains one local copy and links it into supported agent directories — install once, available in every session.

Claude CodeCodexCursorCopilotGeminiAmpOpenCode