# Skillcrew

> Skillcrew distributes Agent Skills from one Git repository to Claude Code, Codex, Cursor, Copilot and Gemini CLI, and keeps them up to date with no action from developers.

Skillcrew is an open source Go CLI (MIT, macOS and Linux). An organization keeps its Agent Skills (SKILL.md) in one Git repository, the registry: a Claude Code marketplace plus a skillcrew.yaml governance file. Each skill is required, recommended, available, deprecated or blocked, per organization and per team. On each developer machine, `skillcrew init` installs session-start hooks in the agents and an hourly timer that run `skillcrew sync`: skills are copied to ~/.agents/skills and symlinked from ~/.claude/skills.

Source code: https://github.com/yoanbernabeu/skillcrew

## Getting started

- [Install](https://skillcrew.yoandev.co/docs/getting-started/install.md): Install the skillcrew binary on macOS or Linux with Homebrew, the install script or Go.
- [Create a registry](https://skillcrew.yoandev.co/docs/getting-started/create-a-registry.md): Create the Git repository that holds your organization's skills and governance, then publish it.
- [Join as a developer](https://skillcrew.yoandev.co/docs/getting-started/join-as-a-developer.md): Run one command to get your organization's and your teams' skills in every agent, kept up to date.

## Concepts

- [The registry](https://skillcrew.yoandev.co/docs/concepts/registry.md): One Git repository per organization holds every skill and the rules that decide who gets which.
- [Statuses](https://skillcrew.yoandev.co/docs/concepts/statuses.md): Every skill is required, recommended, available, deprecated or blocked, and the status decides where it is installed.
- [Teams and resolution rules](https://skillcrew.yoandev.co/docs/concepts/teams-and-resolution-rules.md): How organization rules, team rules and a developer's own choices combine into one status per skill.
- [Security model](https://skillcrew.yoandev.co/docs/concepts/security-model.md): The registry is your root of trust; Skillcrew copies files, executes nothing from it and stores no secrets.

## Guides

- [Private registries](https://skillcrew.yoandev.co/docs/guides/private-registries.md): Use a private registry over SSH or HTTPS with the Git credentials developers already have.
- [Pin a skill](https://skillcrew.yoandev.co/docs/guides/pinning.md): Hold a skill at a tag or a commit while the rest of the registry moves on.
- [Propose a change](https://skillcrew.yoandev.co/docs/guides/propose-a-change.md): Turn your local edits to a team skill, or one of your personal skills, into a pull request on the registry.
- [Convert a Claude Code marketplace](https://skillcrew.yoandev.co/docs/guides/convert-a-claude-code-marketplace.md): Turn an existing Claude Code marketplace repository into a Skillcrew registry with one command.
- [Validate in CI](https://skillcrew.yoandev.co/docs/guides/ci.md): Run skillcrew validate on every pull request so a broken registry never reaches developer machines.

## Reference

- [CLI](https://skillcrew.yoandev.co/docs/reference/cli.md): Every skillcrew command, its arguments, flags and JSON output.
- [skillcrew.yaml](https://skillcrew.yoandev.co/docs/reference/skillcrew-yaml.md): Full reference of the governance file at the root of the registry, and of the per-machine config.yaml.
- [Files on disk](https://skillcrew.yoandev.co/docs/reference/files-on-disk.md): Every file and directory Skillcrew reads or writes on a developer machine.

## Troubleshooting

- [Diagnose with doctor](https://skillcrew.yoandev.co/docs/troubleshooting/doctor.md): Run skillcrew doctor first, then use the table of symptoms and fixes.
- [FAQ](https://skillcrew.yoandev.co/docs/troubleshooting/faq.md): Short answers about local edits, name collisions, pinning, project skills and uninstalling.

## Optional

- [Full documentation](https://skillcrew.yoandev.co/llms-full.txt): every page above in one file