amicsdocs
For agents

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 install

The 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 universal

Use --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:

FormatManifest
Agent Plugins 1.0plugin.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.

On this page