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.
Install
Section titled “Install”adaptkit init installs the skills with each new application. To install them in an existing repository, run this anywhere in it:
adaptkit skillIn 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.
Update
Section titled “Update”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.
Read them
Section titled “Read them”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 |