Skip to main content
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

1

Adapt detects relevance

When you ask a question or request a task, Adapt checks if any skills match
2

Skill loads

The relevant skill’s knowledge and templates become available
3

Adapt applies the skill

Responses follow the skill’s specialized context

​
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

---
name: my-custom-skill
description: What this skill helps with
---

# Skill content

Instructions, templates, and knowledge go here...

​
Required fields

FieldRequirements
nameLowercase letters, numbers, and hyphens only. Cannot start or end with a hyphen. Max 64 characters.
descriptionWhat the skill helps with. Max 1024 characters.

​
Optional fields

FieldRequirements
licenseLicense name or reference (string)
metadataKey-value pairs (object with string values)

​
Example: internal communications skill

---
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

Be specific

Write clear descriptions so skills activate at the right time

Include examples

Provide templates and examples for consistent output

Stay current

Update skills as your processes evolve

Test thoroughly

Verify skills produce the expected results

​
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