> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coddo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Extend Claude Code and Codex with custom skills — create your own or install from the registry.

Skills are **reusable instructions** that extend what your agent can do. Think of them as templates or plugins that give Claude Code or Codex specific expertise for particular tasks.

## What are skills?

A skill is a set of instructions (in markdown) that tells the agent how to handle a specific type of task. For example, a skill could teach Claude or Codex:

* How to write tests following your project's conventions
* How to generate API documentation
* How to create components matching your design system
* How to review code for security issues

## Creating skills

The easiest way to create a skill is to describe what you want and let Coddo generate it with AI:

1. Open the **Skills** view from the sidebar
2. Click **+ New Skill**
3. Describe what the skill should do in plain language
4. Choose the scope: **Project** (this project only) or **Global** (all projects)
5. Coddo uses an AI-powered skill creator to generate the skill content
6. The skill is saved and immediately available for use

You can cancel the generation at any time.

<Tip>
  Be specific in your description. Instead of "write tests", say "write unit tests using Vitest with TypeScript, using describe/it blocks, with setup and teardown".
</Tip>

## Skill scopes

| Scope       | Location                                                    | Description                                                        |
| ----------- | ----------------------------------------------------------- | ------------------------------------------------------------------ |
| **Project** | `.agents/skills/` (Coddo) and `.claude/skills/` (symlinked) | Available only in the current project                              |
| **Global**  | `~/.claude/skills/` and mirrored to `~/.codex/skills/`      | Available across all your projects, for both Claude Code and Codex |

<Info>
  Global skills are mirrored to both Claude and Codex skill directories automatically, so a skill you install once works with both providers.
</Info>

## Skills registry

Browse and install community-created skills from the **Recommended** section:

1. Open the Skills view
2. Scroll to the recommended skills section
3. Click the download button to install a skill
4. Installed skills are immediately available for use

## Install from an external source

You can also install any skill published on GitHub or another registry by pasting its **install command**:

1. Open the Skills view and click **+ Install**
2. Paste a command like `npx skills add https://github.com/owner/repo`
3. Choose **Project** or **Global** scope
4. Coddo runs the installer and the skill is ready to use

This is the fastest way to bring in a skill without creating it from scratch.

## Managing skills

From the Skills view, you can:

* **View** installed skills and their details
* **Search** skills by name or description
* **Uninstall** skills you no longer need
* **Refresh** the skill list to detect changes