Skip to main content

atmos ai skill

Use this command to manage community and custom AI skills. Install skills from GitHub repositories, list installed skills, and remove skills you no longer need.

Experimental

See also: AI Skills Configuration for configuring skills in atmos.yaml | Skill Marketplace for browsing available skills

atmos ai skill --help

Description​

Skills are specialized AI assistants that provide expert knowledge for specific domains. They follow the Agent Skills open standard and can be installed from GitHub repositories.

The atmos ai skill command lets you:

  • Install official skills by name (offline) or community skills from GitHub
  • List the full catalog of available skills alongside what's installed
  • Remove skills you no longer need
Global --skill Flag

You can use installed skills with any Atmos command via the global --skill flag (requires --ai). The skill's system prompt is sent to the AI provider for domain-specific analysis.

atmos terraform plan vpc -s ue1-prod --ai --skill atmos-terraform

See Global Flags for details.

Usage​

atmos ai skill <subcommand> [flags]

Subcommands​

atmos ai skill install​

Install a skill by its bundled name (offline) or from a GitHub repository.

The official Atmos skills are embedded in the binary, so installing one by its bare name (for example atmos-terraform) works fully offline — no network or Git clone required. Run atmos ai skill list to see every available skill. You can also install any skill from a GitHub repository.

Usage:

atmos ai skill install <source> [flags]

Flags:

--force
Reinstall if the skill is already installed.
-y, --yes
Skip the confirmation prompt.

Examples:

# Install an official skill by name (offline)
atmos ai skill install atmos-terraform

# Install a skill from GitHub
atmos ai skill install github.com/user/skill-name

# Install a specific version
atmos ai skill install github.com/user/skill-name@v1.2.3

# Force reinstall
atmos ai skill install github.com/user/skill-name --force

# Install without confirmation
atmos ai skill install github.com/user/skill-name --yes

atmos ai skill list​

List Atmos skills — both the official skills bundled with Atmos and any community skills installed on this system. A filled dot (●) marks an installed skill; a hollow dot (○) marks one that is available to install. The official catalog is embedded in the binary, so listing works offline.

Usage:

atmos ai skill list [flags]

Flags:

-d, --detailed
Show detailed information for each skill, including source, version, install date, and location.
--installed
Show only installed skills, hiding the rest of the available catalog.

Examples:

# List all skills (available and installed)
atmos ai skill list

# Show only installed skills
atmos ai skill list --installed

# Show detailed information
atmos ai skill list --detailed

atmos ai skill uninstall​

Remove an installed skill.

Usage:

atmos ai skill uninstall <name> [flags]

Flags:

-f, --force
Skip the confirmation prompt.

Examples:

# Uninstall a skill
atmos ai skill uninstall skill-name

# Uninstall without confirmation
atmos ai skill uninstall skill-name --force