using-adeptlisted

# Using the `adept` CLI `adept` makes one AI skill portable across every coding harness. You **author once** in a canonical format; `adept` **renders accurately** into each harness's native layout and keeps both sides in sync. ## Mental model ``` canonical skill ──render──▶ .claude/skills/… (per-skill) (.adeptability/ ──render──▶ .cursor/rules/….mdc (single-file) skills/<id>/ ──render──▶ AGENTS.md (Codex aggregate) SKILL.md) ──render──▶ .github/instructions (Copilot aggregate) ◀─sync-from─ (adopt edits made directly in a harness file) ``` - **Identity is `(id, content-hash)`** — no version numbers. The hash decides what changed. - A skill is a directory `<root>/skills/<id>/` with one `SKILL.md` (YAML frontmatter + markdown body) and optional sidecars (`scripts/`, `references/`, `assets/`). - An **agent** (subagent) is a single file `.adeptability/agents/<id>.md`; it renders to `.claude/agents/`, `.opencode/agents/`, `.cursor/agents/`, `.github/agents/`, and `.codex/agents/*.toml` the same way. See [[authoring-adept-agents]]. - The **filesystem is the source of truth.** `config.json` only records enabled harnesses, the materialization mode, and library remotes. ## The commands you'll use most ```bash adept init # scaffold .adeptability/ (and seed the default skills) adept harness add <id> # enable a harness (claude-code | cursor | codex | copilot | opencode | …) adept sync