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

# Skills

> Extend AI agents with domain-specific knowledge, custom workflows, and organization-specific procedures

**Skills are instruction packages that turn general-purpose AI agents into domain experts.**

Instead of repeating the same context in every conversation, you write it once as a skill—your team's coding standards, review checklists, incident procedures, compliance rules—and the agent applies it automatically. Skills bridge the gap between what AI agents can do and what your organization needs them to do.

***

## What you get

<CardGroup cols={2}>
  <Card title="Custom Skills" icon="wand-magic-sparkles">
    Create workspace-private skills with your organization's specific knowledge, standards, and procedures. Write them manually or let AI generate them for you.
  </Card>

  <Card title="Feature Assignment" icon="puzzle-piece">
    Assign skills to specific features like Code Review, Deep Response Engine, or Assessment. Each feature only loads the skills relevant to its domain.
  </Card>

  <Card title="AI-Assisted Creation" icon="robot">
    Describe what you need in plain language and let AI generate a complete skill for you. Edit and refine it with AI assistance at any time.
  </Card>
</CardGroup>

***

## How skills work

<Steps>
  <Step title="Create a skill">
    Write skill instructions manually or generate with AI.
  </Step>

  <Step title="Enable it">
    Toggle the skill on in your workspace. Disabled skills are saved but not applied.
  </Step>

  <Step title="Assign to features">
    Choose which features should use the skill—Code Review, Incident, Assessment, or any combination.
  </Step>

  <Step title="Agent applies automatically">
    When an agent runs a task for an assigned feature, it loads the skill instructions and follows them alongside its default behavior.
  </Step>
</Steps>

***

## What a skill looks like

A skill is a Markdown file with YAML frontmatter. Here's a minimal example:

```markdown theme={null}
---
name: pr-size-limits
description: Enforce PR size limits and flag oversized changes
---

## Rules

- Flag PRs with more than 500 lines changed as "needs splitting"
- Warn on PRs with more than 10 files changed
- Suggest logical split points when flagging oversized PRs

## Exceptions

- Auto-generated files (migrations, lockfiles) do not count toward line limits
- Documentation-only PRs are exempt from file count limits
```

***

## Next steps

<CardGroup cols={2}>
  <Card title="Custom Skills" icon="wand-magic-sparkles" href="/guide/skills/custom-skills">
    Learn how to create, upload, and manage workspace-level skills.
  </Card>

  <Card title="Skill Format" icon="file-code" href="/guide/skills/skill-format">
    Understand the SKILL.md file structure, frontmatter, and best practices for writing effective instructions.
  </Card>
</CardGroup>