Skills

Discover and use skills directly in CloudCLI. Skills are loaded from your local skill folders and appear in the command menu while you chat.

Skills let you package repeatable instructions in SKILL.md files and trigger them as commands (for example /my-skill or $my-skill, depending on provider).

How Skills Work in CloudCLI

CloudCLI does not create skill files for you. Instead, it reads provider-native skill directories and automatically exposes discovered skills in the chat composer command menu.

When a SKILL.md file is added or updated in a supported location:

CloudCLI discovers the skill for the selected provider
The command appears in the command menu
Selecting the command inserts it into your prompt input

Using a Skill

Open a chat session for your selected provider
Focus the message input
Type the provider command prefix (/ or $)
Pick a skill from the Skills section in the command menu
Send your prompt

Creating a Skill

Choose the provider and scope (project or user)
Create a folder for the skill in one of that provider's supported skill paths
Add a SKILL.md file with frontmatter
Return to CloudCLI and open the command menu in chat

Minimal `SKILL.md` Example

---
name: summarize-pr
description: Summarize this pull request with risks and next steps.
---

Use this skill to generate a concise PR summary:
- Key changes
- Risks and regressions
- Suggested follow-up tasks

Provider Command Prefixes

Provider	Prefix	Example
Claude	`/`	`/summarize-pr`
Cursor	`/`	`/summarize-pr`
Gemini	`/`	`/summarize-pr`
Codex	`$`	`$summarize-pr`

Skill Locations by Provider

CloudCLI discovers skills from these provider-native paths.

Claude

User: ~/.claude/skills
Project: <workspace>/.claude/skills
Plugin commands: discovered as /<plugin-name>:<skill-name>
Plugin skill markdowns: discovered recursively from plugin skills/ folders

Codex

Repo: <workspace>/.agents/skills
Repo parent: path.dirname(workspacePath)/.agents/skills
Topmost git root: <git-root>/.agents/skills
User: ~/.agents/skills
Admin: /etc/codex/skills
System: ~/.codex/skills/.system

Cursor

Project: <workspace>/.agents/skills
Project: <workspace>/.cursor/skills
User: ~/.cursor/skills

Gemini

User: ~/.gemini/skills
User: ~/.agents/skills
Project: <workspace>/.gemini/skills
Project: <workspace>/.agents/skills

Notes

Skills are discovered from SKILL.md files.
CloudCLI reads name and description from frontmatter.
If name is missing, the containing folder name is used.
Malformed skill files are skipped so valid skills still load.

Troubleshooting

Open the item that matches what you see in the command menu.

The skill does not appear

Confirm the file is named exactly SKILL.md, includes frontmatter with at least name and description, and lives in a supported path for the provider you are using. Then reopen the command menu after saving the file.

The command prefix is wrong

Use / for Claude, Cursor, and Gemini. Use $ for Codex.

The command appears with the wrong name

Check the name value in the SKILL.md frontmatter. If name is omitted, CloudCLI uses the containing folder name.