Skip to content

Agent skills

Agent skills are folders of instructions that a coding agent loads when a task needs them. Adaptkit ships two, in the open Agent Skills format:

Skill What it teaches the agent
adapt-app To create and change applications: structure, code, services, pages, security, tests, and publication.
adapt-emulator To test applications in the local emulator.

See Build with an AI agent for how to work with them.

adaptkit init installs the skills with each new application. To install them in an existing repository, run this anywhere in it:

Terminal window
adaptkit skill

In a Git repository, the skills go to .agents/skills at the root, with links in .claude/skills for Claude Code. Outside Git, they go next to the nearest manifest.json.

  • Directoryadapt-apps/
    • Directory.agents/skills/
      • Directoryadapt-app/
        • SKILL.md
        • Directoryreferences/ six reference files
          • …
      • Directoryadapt-emulator/
        • SKILL.md
    • Directory.claude/skills/
      • adapt-app link to .agents/skills/adapt-app
      • adapt-emulator link to .agents/skills/adapt-emulator
    • Directoryticket_form/ an application
      • …

Commit both folders, so that your whole team uses the same version.

Agents load a skill when your request matches it, so say “Adapt app” in your request. Some agents also let you invoke a skill by name.

Agent Reads project skills from Invoke
Claude Code .claude/skills Automatically, or with /adapt-app
OpenAI Codex .agents/skills Automatically, or with $adapt-app
Gemini CLI .agents/skills or .gemini/skills Automatically
GitHub Copilot in VS Code .agents/skills, .claude/skills, or .github/skills Automatically

This table follows each agent’s documentation at the time of writing. If your agent reads skills from another folder, link or copy the two skill folders there.

Each Adaptkit version has matching skills. After you update Adaptkit, run adaptkit skill again and commit the result. It replaces the two skill folders and leaves your other skills and files alone.

The skills are short, and written in plain language. They are a good summary of the platform’s rules. adapt-app has reference files for the deeper topics, and these guides explain the same topics for people:

Reference Guide
browser-ui.md Browser pages
endpoint-security.md Endpoint security
jtd-schema.md Signals
runtime.md Runtime and state
services.md Services and credentials
state-and-compatibility.md Publish and update