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

# Skills

> Extend the agent with domain-specific expertise using reusable knowledge packages that follow the agentskills.io specification.

export const Availability = ({tags = []}) => {
  const tagColor = {
    invite: "purple",
    beta: "gray",
    "private-preview": "purple",
    vscode: "blue",
    jetbrains: "orange",
    vim: "gray",
    neovim: "gray",
    cli: "green"
  };
  return <div className="flex items-center space-x-2 border-b pb-4 border-gray-200 dark:border-white/10">
      <span className="text-sm font-medium">Availability</span>
      {tags.map(tag => <Badge key={tag} size="sm" color={tagColor[tag] || "gray"}>
          {tag}
        </Badge>)}
    </div>;
};

## About Skills

Skills are reusable knowledge packages that extend the agent with domain-specific expertise — deployment guides, debugging playbooks, framework best practices, and more. Each skill is a self-contained skill folder with a markdown file that provides specialized instructions the agent can draw on during conversations.

Skills follow the [agentskills.io](https://agentskills.io) specification, ensuring compatibility across AI tools.

## Creating a Skill

Each skill lives in its own named directory containing a markdown file that shares the name of the directory:

```
cosmos/files/organization/.augment/skills/
  ├── python-testing/
  │   └── python-testing.md
  ├── api-design/
  │   └── api-design.md
  └── deploy-guide/
      └── deploy-guide.md
```

### Markdown Format

Each markdown file must include YAML frontmatter with a `name` and `description`, followed by markdown content with instructions:

```markdown theme={null}
---
name: deploy-guide
description: Step-by-step deployment procedures for our production infrastructure
---

# Deployment Guide

## Pre-deployment Checklist
1. Run all tests with `npm test`
2. Verify environment variables are set
3. Check database migrations are up to date

## Deploying to Production
...
```

### Frontmatter Fields

| Field         | Description                            | Requirements                                                                        |
| :------------ | :------------------------------------- | :---------------------------------------------------------------------------------- |
| `name`        | Skill identifier                       | 1–64 characters, lowercase alphanumeric and hyphens only, must match directory name |
| `description` | What the skill does and when to use it | 1–1024 characters                                                                   |

### Skill Name Requirements

Skill names must:

* Be 1–64 characters long
* Use only lowercase letters, numbers, and hyphens
* Not start or end with a hyphen
* Not contain consecutive hyphens
* Match the directory name containing the markdown file

**Valid names**: `python-testing`, `api-design`, `deploy-guide`

**Invalid names**: `Python-Testing`, `api_design`, `-deploy`, `my--skill`

## Skill Locations

Skills are discovered from multiple locations in order of precedence:

| Location                                     | Scope        | Description                                                      |
| :------------------------------------------- | :----------- | :--------------------------------------------------------------- |
| `cosmos/files/organization/.augment/skills/` | Organization | Available to all users in your Organization (highest precedence) |
| `cosmos/files/user/.augment/skills/`         | User         | Private to you across all sessions                               |
| `<repo>/<workspace>/.claude/skills/`         | Project      | Compatible with Claude Code                                      |
| `<repo>/<workspace>/.agents/skills/`         | Project      | Industry-standard location                                       |

When multiple skills with the same name exist in different locations, the skill from the higher-precedence location is used.

## Getting Started

<Steps>
  <Step title="Create a directory to host your skill">
    Navigate to Files > Organization > .augment > skills and create a new directory for your skill.
  </Step>

  <Step title="Create the my-skill.md file">
    Upload a markdown file to directory using the Upload File button:

    ```markdown theme={null}
    ---
    name: my-skill
    description: Custom skill for my project workflow
    ---

    # My Custom Skill

    Add your domain-specific guidance, examples, and instructions here.
    ```
  </Step>

  <Step title="Use the skill">
    The skill will be discovered automatically and injected into your Expert's context.
  </Step>
</Steps>

## Best Practices

1. **Focus each skill on a single domain** — keep skills modular and specific
2. **Include concrete examples** — provide code samples and commands
3. **Write clear descriptions** — help the agent understand when to apply each skill

## See Also

* [agentskills.io Specification](https://agentskills.io/specification) — Official skill format specification
* [Understanding Files](/cosmos/understanding-files) — the Files system where Skills are stored and managed
* [Skills in Auggie CLI](/cli/skills) — Using skills with the CLI