Go (any platform)

<p align="center">
  <img src="assets/logo-mark.svg" alt="adeptability: cross-harness AI skill portability CLI" width="150">
</p>

<h1 align="center">write an AI skill once, run it in every coding agent</h1>

<p align="center">
  <a href="https://github.com/itaywol/adeptability/releases/latest"><img src="https://img.shields.io/github/v/release/itaywol/adeptability?logo=github&sort=semver" alt="Release"></a>
  <a href="https://github.com/itaywol/adeptability/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/itaywol/adeptability/ci.yml?branch=main&logo=github&label=CI" alt="CI"></a>
  <a href="https://pkg.go.dev/github.com/itaywol/adeptability"><img src="https://pkg.go.dev/badge/github.com/itaywol/adeptability.svg" alt="Go Reference"></a>
  <a href="https://goreportcard.com/report/github.com/itaywol/adeptability"><img src="https://goreportcard.com/badge/github.com/itaywol/adeptability" alt="Go Report Card"></a>
  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
</p>

<p align="center"><a href="https://adeptability.itaywol.tools"><b>adeptability.itaywol.tools</b></a></p>

<p align="center">
  <img src="assets/demo.gif" alt="Write one skill, run adept sync, and it renders into Claude Code, Cursor, Codex, and OpenCode at once" width="760">
</p>

`adept` lets you author an AI coding skill (a prompt, rule, or procedure) — or a **subagent**
(a reviewer, test-runner, or other specialist) — **once**, then render it accurately into
Claude Code, Cursor, GitHub Copilot, OpenAI Codex, OpenCode, and 50+ other agents. It handles
each harness's frontmatter, activation rules, aggregation, and size budgets for you — think
**dotfiles for your AI coding agents**: one source of truth, the right on-disk format
everywhere.

📖 **[Full documentation → adeptability.itaywol.tools](https://adeptability.itaywol.tools)**

## Install

```bash
# Go (any platform)
go install github.com/itaywol/adeptability/cmd/adept@latest

# macOS / Linux (Homebrew)
brew install itaywol/tap/adeptability

# Any platform (curl installer)
curl -fsSL https://raw.githubusercontent.com/itaywol/adeptability/main/scripts/install.sh | sh

# Nix / NixOS (flake)
nix profile install github:itaywol/adeptability

# Containers
docker run --rm -v "$PWD:/work" -w /work ghcr.io/itaywol/adeptability:latest --help
```

Or grab a pre-built, cosign-signed binary from the
[latest release](https://github.com/itaywol/adeptability/releases/latest).

## 60-second quickstart

```bash
cd ./my-project
adept init                          # scaffold .adeptability/, adopt any existing .claude/ .cursor/ AGENTS.md, seed default skills
adept skill add lint-style --edit   # scaffold a canonical skill, opens $EDITOR
adept agent add pr-reviewer --template evaluator   # scaffold a subagent (then `adept agent check` lints it)
adept harness add claude-code       # enable a harness (run `adept harness list` for all ids)
adept harness add cursor
adept sync                          # render skills + agents into every enabled harness
adept status                        # init state, libraries, harnesses, and drift at a glance
```

`adept sync` writes `.claude/skills/lint-style/SKILL.md`, `.cursor/rules/lint-style.mdc`,
`.claude/agents/pr-reviewer.md`, and so on — each in that harness's native format. Edit one
inside a harness instead? Run `adept sync-from` to pull it back to canonical, then
`adept sync` to re-publish everywhere. Building scheduled automation? `adept loop add`
composes a discovery skill + evaluator agent + cron skeleton in one shot — see the
[loops guide](https://adeptability.itaywol.tools/docs/guides/loops/).

`init` also seeds bundled default skills (`using-adept`, `authoring-adept-skills`,
`authoring-adept-agents`, `authoring-adept-loops`, `adept-self-improve`) so a fresh project is
useful on day one. Skip with `--no-default-skills`.

### Global skills

Prefix any command with `--global` to target your home directory instead of a project — for
skills you want everywhere without an `adept init` per repo. Supported by `claude-code`,
`codex`, and `opencode` (not Cursor or Copilot). See
[Scopes](https://adeptability.itaywol.tools/docs/concepts/scopes/).

```bash
adept --global harness add claude-code && adept --global skill add lint-style --edit && adept --global sync
```

## Core concepts

- **Canonical skill** — one `SKILL.md` (YAML frontmatter + markdown body) plus optional
  `scripts/`, `references/`, `assets/` sidecars. The single source of truth for a skill.
- **Canonical agent** — one `.adeptability/agents/<id>.md` (frontmatter + system prompt)
  rendered to `.claude/agents/`, `.opencode/agents/`, `.cursor/agents/`, `.github/agents/`,
  and `.codex/agents/*.toml`. `adept agent check` runs a safety scan plus a best-practice
  lint. See [Canonical agents](https://adeptability.itaywol.tools/docs/concepts/agents/).
- **Harness** — a target AI agent (Claude Code, Cursor, Codex, …). `adept 

... (truncated)