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

# Skills

> Extend Adapt with specialized knowledge and workflows

Skills are modular knowledge packages that extend Adapt's capabilities for specific domains, workflows, or tasks. Teach Adapt how your team works.

## What skills are

Skills bundle documentation, templates, and context that Adapt loads on-demand for relevant tasks:

* **Specialized knowledge** for specific domains or tools
* **Templates and examples** matching your team's standards
* **Step-by-step workflows** for complex processes
* **Best practices** codified from your organization

## How skills work

<Steps>
  <Step title="Adapt detects relevance">
    When you ask a question or request a task, Adapt checks if any skills match
  </Step>

  <Step title="Skill loads">
    The relevant skill's knowledge and templates become available
  </Step>

  <Step title="Adapt applies the skill">
    Responses follow the skill's specialized context
  </Step>
</Steps>

## Create custom skills

Build skills tailored to your organization's needs.

### Skill structure

A skill consists of:

```
my-skill/
├── SKILL.md          # Main skill file with frontmatter and content
├── templates/        # Optional templates and examples
└── reference/        # Optional reference documentation
```

### SKILL.md format

```markdown theme={null}
---
name: my-custom-skill
description: What this skill helps with
---

# Skill content

Instructions, templates, and knowledge go here...
```

### Required fields

| Field         | Requirements                                                                                        |
| ------------- | --------------------------------------------------------------------------------------------------- |
| `name`        | Lowercase letters, numbers, and hyphens only. Cannot start or end with a hyphen. Max 64 characters. |
| `description` | What the skill helps with. Max 1024 characters.                                                     |

### Optional fields

| Field      | Requirements                                |
| ---------- | ------------------------------------------- |
| `license`  | License name or reference (string)          |
| `metadata` | Key-value pairs (object with string values) |

### Example: internal communications skill

```markdown theme={null}
---
name: internal-comms
description: Write internal communications using company formats
---

# Internal communications guide

## Status report template

**Format:** Weekly status reports follow this structure...

## Leadership update template

**Audience:** Executive team
**Tone:** Concise, data-driven...
```

## Use skills

Skills load automatically when relevant. Reference them directly:

```
Use the internal-comms skill to write a status report
for the product launch
```

Or request a specific skill:

```
Following our internal communications format, draft
an update on the Q4 roadmap
```

## Manage skills

### Connect a skill source

Skills are synced from GitHub repositories. Connect a repo in **Settings** > **Skills**:

1. Click **Add skill source**
2. Enter the repository owner and name (e.g., `myorg/skills`)
3. Set the branch (defaults to `main`)
4. Set the path where skills are located (defaults to `/`)
5. Click **Create** to sync

Adapt scans the repository for directories containing `SKILL.md` files and imports each as a skill.

### Sync skills

Click **Sync** on a skill source to pull the latest changes from the repository. Adapt tracks the commit SHA to detect updates.

### Enable or disable skills

Toggle individual skills on or off from the skills settings page. Disabled skills won't appear in the agent's available skills.

## Best practices

<CardGroup cols={2}>
  <Card title="Be specific" icon="bullseye">
    Write clear descriptions so skills activate at the right time
  </Card>

  <Card title="Include examples" icon="code">
    Provide templates and examples for consistent output
  </Card>

  <Card title="Stay current" icon="rotate">
    Update skills as your processes evolve
  </Card>

  <Card title="Test thoroughly" icon="flask">
    Verify skills produce the expected results
  </Card>
</CardGroup>

## Skill ideas

Common use cases:

* **Onboarding guides** — Help new team members get up to speed
* **Code standards** — Enforce coding conventions and review guidelines
* **Report formats** — Standardize reporting across teams
* **Runbooks** — Document operational procedures
* **Brand voice** — Maintain consistent communication style
* **Data dictionaries** — Define business metrics and terminology