Install the Amics skill
Install the Amics workflow for Codex, Claude Code, Cursor, OpenCode, or another Agent Skills-compatible client.
The Amics CLI includes a portable Agent Skill with the execution workflow, approval rules, lifecycle behavior, and on-demand command references.
Choose where to install
After installing the CLI:
amics skill installThe command detects local coding agents and asks which ones should receive the skill. Choose one or more targets, then review the plan before accepting it.
Target specific agents
amics skill install --agent codex
amics skill install --agent claude-code --agent opencode
amics skill install --agent universalUse --copy when symlinks are unavailable. Add --yes only when you have
already reviewed the source and installation targets. Run
amics skill install --help for the supported agent names.
The universal ~/.agents/skills/amics target is installed only when selected
explicitly. Choosing a specific agent removes an older shared Amics installation.
Plugin formats
Plugin-aware clients can load the same workflow from the public catalog in two formats:
| Format | Manifest |
|---|---|
| Agent Plugins 1.0 | plugin.json |
| Codex | .codex-plugin/plugin.json |
Both manifests expose the existing skills/amics package. They do not
configure an MCP server or replace the local CLI: install amics and use
amics login for authentication as usual.
Verify the workflow
Start a new agent session so it reloads installed skills, then ask:
Use the Amics skill to compare live GPU capacity for a 20-minute command
that runs a CUDA application requiring at least 24 GB VRAM and compute
capability 8.0. Do not acquire anything.A correct response should use amics gpu options, keep the action read-only,
compare only families that meet both requirements, explain what remains unknown
about application performance, and avoid turning that comparison into approval.
Use without a skill-aware client
Give the agent these docs and the CLI:
Read https://docs.amics.ai/llms.txt and
https://docs.amics.ai/agents/approval-and-safety.md before using `amics`.The CLI is the execution interface. There is no production Amics MCP server in the current contract.
Source
The skill lives at
skills/amics/SKILL.md
in the public catalog. Its references/ folder ships alongside it and is read
only when a task needs it. The catalog root is also a portable Agent Plugins
package and contains the Codex-specific manifest described above.