AI Skill

Adapter ships with optional Codex skills for AI coding assistants.

This page focuses on installing and verifying the skills. The skills contain the agent-facing Adapter guidance.

If AI Skills are new to you, read more in the official Codex docs:

• Codex
• Codex Skills

Install The Skills

Adapter includes a CLI that installs the packaged skills into your local Codex skills directory:

adapter skill-install

When --target is omitted, it prompts before installing to .agents/skills/ in the current project. Press Enter to use that default, or type another path to override it.

For Deno/JSR one-shot usage, run the exported command module:

deno run -A jsr:@devcapsule/adapter/adapter skill-install

For npm-compatible projects, add Adapter through JSR first:

npx jsr add @devcapsule/adapter

Then run the installed package bin from the project:

npx adapter skill-install

The command copies the bundled adapter-framework and adapter-design-system skills into the target skills directory.

Install Location

By default, the installer prompts before writing to .agents/skills/ in the current project. At the prompt, press Enter to use that directory, type another path to override it, or type n to cancel.

After installation, the skills directory should include:

adapter-framework/
  SKILL.md
  references/
adapter-design-system/
  SKILL.md
  references/

Options

Useful options:

adapter skill-install --dry-run
adapter skill-install --target /path/to/skills
adapter skill-install --force

Use --dry-run to preview the default destination without writing files. Use --target when testing, scripting, or installing into a non-default skills directory. Use --force only when you intentionally want to replace existing Adapter skills.

Test The Installer Safely

To test the installer without touching your real Codex skills directory, install into a temporary directory:

tmp=$(mktemp -d /tmp/adapter-skill-test.XXXXXX)
deno run -A jsr:@devcapsule/adapter/adapter skill-install --target "$tmp"
ls "$tmp/adapter-framework"
ls "$tmp/adapter-design-system"

Expected output includes SKILL.md and references/.

To verify overwrite protection, run the same install command again. It should fail and tell you to re-run with --force if you want to overwrite the existing skills.

Where The Skills Live

The packaged skill sources are:

• src/agent-skills/adapter-framework/SKILL.md
• src/agent-skills/adapter-design-system/SKILL.md