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

# Skills

> Reusable capability modules following the Agent Skills standard: defined in Markdown with YAML frontmatter.

OpenGAP skills follow the [Agent Skills](https://agentskills.io) standard. Each skill is a directory containing a `SKILL.md` with YAML frontmatter and markdown instructions.

## SKILL.md Format

```yaml theme={null}
---
name: code-review
description: Thorough code reviews
license: MIT
compatibility: ">=0.4.0"
allowed-tools: Read Edit Grep Glob Bash
metadata:
  author: "Jane Doe"
  version: "1.0.0"
  category: "developer-tools"
---

# Instructions

Review the code for:
1. Security vulnerabilities
2. Performance issues
3. Code style consistency
```

## Discovery Priority

OpenGAP searches these locations in order when resolving skill names:

| Priority | Path                      | Source            |
| -------- | ------------------------- | ----------------- |
| 1        | `<agent>/skills/`         | Agent-local       |
| 2        | `<agent>/.agents/skills/` | agentskills.io    |
| 3        | `<agent>/.claude/skills/` | Claude Code       |
| 4        | `<agent>/.github/skills/` | GitHub            |
| 5        | `~/.agents/skills/`       | Personal (global) |

## Skill CLI

```bash theme={null}
opengap skills search "code review"          # Search SkillsMP or GitHub
opengap skills install code-review --global  # Install to global or local
opengap skills list                          # List all discovered skills
opengap skills info code-review              # Get skill details
```

## Registries

| Registry     | Description                              |
| ------------ | ---------------------------------------- |
| **SkillsMP** | REST API marketplace at api.skillsmp.com |
| **GitHub**   | Sparse-clone from public repos           |
| **Local**    | Filesystem path copy                     |

## Declaring Skills in agent.yaml

```yaml theme={null}
skills:
  - code-review
  - deployment
  - security-audit
```

Skills are resolved at runtime using the discovery priority above. Agent-local skills always win over global ones.

<CardGroup cols={2}>
  <Card title="SkillsFlow" icon="diagram-project" href="/open-source/opengap/skills/skillsflow">
    Chain skills into deterministic multi-step workflows
  </Card>

  <Card title="agent.yaml" icon="file-code" href="/open-source/opengap/agent-structure/agent-yaml">
    Declare skills and tools in the agent manifest
  </Card>

  <Card title="Design Patterns" icon="lightbulb" href="/open-source/opengap/design-patterns">
    Skills-based architectural patterns
  </Card>

  <Card title="CLI" icon="terminal" href="/open-source/opengap/cli">
    opengap skills commands
  </Card>
</CardGroup>