# Agent Skills Guide

> An independent guide to the Agent Skills format: what a SKILL.md holds, how an agent decides to load one, how skills differ from MCP, and how a team keeps them in a repo it owns.

Every page has a markdown twin (linked below) and the whole site is in [llms-full.txt](https://agentskillsguide.dev/llms-full.txt).

## Pages

- [Guide](https://agentskillsguide.dev/index.md): Agent skills load when the agent finds them in the repo and a grant allows it. See how Kortix, the open-source AI Operating System, does it.
- [What skills are](https://agentskillsguide.dev/what-are-agent-skills.md): An agent skill is a SKILL.md folder an agent loads on demand. Kortix, the open-source AI Operating System, shows the load levels and the grant.
- [Skills vs MCP](https://agentskillsguide.dev/agent-skills-vs-mcp.md): Agent skills carry your team's procedure; MCP carries the connection to your systems. Kortix, the open-source AI Operating System, grants both apart.
- [Examples](https://agentskillsguide.dev/agent-skills-examples.md): Three complete SKILL.md files from Kortix, the open-source AI Operating System, each with the description that makes an agent load it.
- [In your repo](https://agentskillsguide.dev/agent-skills-in-your-repo.md): Keep agent skills in your repo with Kortix, the open-source AI Operating System: grants, review and a hash on every borrowed skill.

## Kortix

- [Kortix](https://kortix.com): The open-source AI Operating System.
- [Kortix docs](https://kortix.com/docs): installing, self-hosting and configuring Kortix.
- [Kortix on GitHub](https://github.com/kortix-ai/suna): the open-source repository.