adeptability

dotfiles for your AI coding agents

Write an AI skill once, run it in every coding agent.

Author one canonical skill or subagent. adept sync renders it accurately into Claude Code, Cursor, Copilot, Codex, OpenCode + 50 more. Frontmatter, activation rules, aggregation, and size budgets, handled for you.

Get startedGitHub

❯ MIT licensed❯ single Go binary❯ 5 native renderers❯ no lockfile

canonical · one fileSKILL.md+ skill.yamlClaude Code.claude/skills/Cursor.cursor/rules/*.mdcCodexAGENTS.md · aggregatedCopilot.github/instructions/OpenCode.opencode/+ 50 moreWindsurf · Gemini · Cline…
adept sync · fan-out
Terminal recording: one skill is authored, then adept sync renders it into Claude Code, Cursor, Codex, and OpenCode at once.

❯ adept sync: one command, every enabled harness updated in place.

install

Ships as a single Go binary.

Pick your ecosystem. Every path lands the same adept on your $PATH.

GoGo installany platform
$ go install github.com/itaywol/adeptability/cmd/adept@latest
brHomebrewmacOS · Linux
$ brew install itaywol/tap/adeptability
shcurlinstaller
$ curl -fsSL https://raw.githubusercontent.com/…/install.sh | sh
nixNixflake
$ nix profile install github:itaywol/adeptability
◧Dockerghcr.io
$ docker run --rm -v "$PWD:/work" -w /work ghcr.io/itaywol/adeptability:latest --help

Prefer a signed binary? Grab a cosign-signed build from the latest release.

how it works

Three steps, zero copy-paste.

Stop maintaining the same prompt in five dotfolders. Author once, publish everywhere.

01

Author

Write one canonical SKILL.md + skill.yaml: YAML frontmatter, a markdown body, optional scripts/ and references/ sidecars. One source of truth.

02

Sync

Run adept sync. Each harness gets its own native format: frontmatter translated, activation rules mapped, files aggregated, size budgets respected.

03

Everywhere

The same skill materializes into every enabled agent. Five ship specialized renderers; 50+ more work via adapters.

  • Claude Code
  • Cursor
  • Codex
  • Copilot
  • OpenCode
  • +50 more

One source of truth. The right on-disk format everywhere.

see it move

More than sync.

adept skill add · adept status
Terminal recording: authoring a skill with adept skill add, editing SKILL.md, then adept status detecting drift between canonical and a hand-edited harness file.
Author & catch drift. Scaffold a skill, edit it, and adept status flags any harness that has drifted: synced · ahead · behind · diverged.
adept agent add · adept exchange
Terminal recording: creating a subagent with adept agent add, running the safety and best-practice check, then browsing the team expertise exchange.
Subagents & the Exchange. Render a reviewer or test-runner into every harness, then trade expertise with your team over adept exchange.

go deeper

Everything else worth a click.

Docsgetting started + guidesHarness comparisonwhat each renderer emitsExchangeteam expertise billboardReleasessigned builds & changelog