Skip to main content

AI Skill Marketplace

The Atmos AI Skill Marketplace enables you to install, share, and use community-created AI skills from GitHub repositories. Installed skills are stored in ~/.atmos/skills/ and appear in the TUI skill selector (Ctrl+A).

Experimental
Not Claude's Marketplace

The Atmos Skill Marketplace is not related to Anthropic's Claude marketplace. This is Atmos's own system for installing and sharing specialized AI skills from GitHub repositories. Skills follow the Agent Skills open standard governed by the Linux Foundation's Agentic AI Foundation (AAIF).

Installing Skills​

Install skills using various GitHub URL formats:

terminal

# Install all 21+ official Atmos skills (recommended)
atmos ai skill install cloudposse/atmos

# With specific version tag
atmos ai skill install cloudposse/atmos@v1.200.0

# With branch name
atmos ai skill install cloudposse/atmos@main

# Full GitHub URL
atmos ai skill install https://github.com/cloudposse/atmos.git

# Force reinstall
atmos ai skill install cloudposse/atmos --force

# Skip confirmation prompt
atmos ai skill install cloudposse/atmos --yes
Security Consideration

Only use --yes with skills from trusted sources. Always review skill metadata before installing, especially the tools.allowed section.

When you install a skill, Atmos downloads the repository, validates the SKILL.md file, checks version compatibility, prompts for confirmation, and registers it in the local skill registry.

Managing Installed Skills​

List Installed Skills​

terminal

atmos ai skill list

Uninstall a Skill​

terminal

# Interactive confirmation
atmos ai skill uninstall atmos-terraform

# Force uninstall (no confirmation)
atmos ai skill uninstall atmos-terraform --force

Enable/Disable Skills​

(Coming soon) Temporarily disable skills without uninstalling:

terminal

atmos ai skill disable atmos-terraform
atmos ai skill enable atmos-terraform

Creating Marketplace Skills​

SKILL.md Format​

Skills follow the Agent Skills open standard format -- a single SKILL.md file with YAML frontmatter and a Markdown body containing the system prompt.

your-skill-repo/
├── SKILL.md             # Skill definition (required)
├── README.md            # Documentation (recommended)
├── examples/            # Usage examples (optional)
└── LICENSE              # License file (recommended)

SKILL.md Structure​

The frontmatter declares metadata and tool access. The Markdown body is the AI system prompt.

SKILL.md (abbreviated)

---
name: terraform-expert
display_name: "Terraform Expert"
version: 1.0.0
author: Cloud Posse
description: >
  Specialized AI skill for Terraform component development,
  debugging, and best practices.
category: refactor

atmos:
  min_version: 1.50.0
  max_version: ""

tools:
  allowed:
    - atmos_describe_component
    - read_component_file
    - read_file
    - edit_file
    - execute_bash
  restricted:
    - edit_file
    - execute_bash

capabilities:
  - terraform-development
  - component-architecture

dependencies:
  - terraform

repository: https://github.com/yourorg/atmos-skill-terraform
---

# Skill: Terraform Expert

## Role

You are a specialized AI skill for Terraform component development...

## Instructions

[Detailed instructions for the AI skill go here]

## Restrictions

- Always confirm before executing destructive commands
- Never commit secrets or credentials to code
name
Unique skill identifier in kebab-case.
display_name
User-facing display name.
version
Semantic version (e.g., 1.2.3).
author
Author name or organization.
description
Brief description of skill purpose.
category
One of: general, analysis, refactor, security, validation, optimization.
atmos.min_version
Minimum compatible Atmos version.
tools.allowed
Tools the skill can use. Tools in restricted require user confirmation each time.
repository
GitHub repository URL.

Publishing Your Skill​

Create a GitHub repository with a valid SKILL.md, tag a release, and share it:

terminal

mkdir atmos-skill-terraform && cd atmos-skill-terraform
git init

# Create SKILL.md with frontmatter and prompt (see format above)

git add . && git commit -m "Initial skill release"
git remote add origin git@github.com:yourorg/atmos-skill-terraform.git
git push -u origin main
git tag v1.0.0 && git push origin v1.0.0

Share your skill in Atmos Discussions and add the atmos-skill topic to your repository.

Naming Convention
  • Repository: prefix with atmos-skill-, use kebab-case (e.g., atmos-skill-cost-optimizer)
  • Skill name: no prefix, kebab-case (e.g., cost-optimizer)
  • Display name: title case (e.g., "Cost Optimizer")

Tool Access and Security​

Skills declare which tools they need. Review the tools.allowed section before installing any skill.

Review Before Installing

Always review skill source code on GitHub before installing skills that request:

  • File write access (edit_file, write_stack_file, write_component_file)
  • Command execution (execute_bash_command, execute_atmos_command)

Use the restricted field to require user confirmation for sensitive operations. A tool listed in both allowed and restricted means the skill can use it, but the user must approve each invocation.

Troubleshooting​

Skill Not Found After Installation​

Skill may be disabled or the registry is corrupted. Check with atmos ai skill list and inspect ~/.atmos/skills/registry.json.

Version Compatibility Error​

Error: skill requires Atmos >= 1.50.0, but current version is 1.48.0

Upgrade Atmos (brew upgrade atmos) or install an older skill version (atmos ai skill install user/skill@v0.9.0).

Invalid Metadata Error​

The skill's SKILL.md has malformed frontmatter. Report the issue to the skill author or try a different version tag.

Registry Corruption​

terminal

# Backup and reset registry
cp ~/.atmos/skills/registry.json ~/.atmos/skills/registry.json.backup
rm ~/.atmos/skills/registry.json

# Reinstall skills
atmos ai skill install cloudposse/atmos