# docs: Add Skills documentation \(\#57095\) · gitcafe/zed

[View on GitCafe](https://git.cafe/gitcafe/zed/commit/dd528e3efbb5c5632cc9e5cb162c0159b79f6ea6)

Repository: [gitcafe/zed](https://git.cafe/gitcafe/zed)

Visibility: public

Requested revision: dd528e3efbb5c5632cc9e5cb162c0159b79f6ea6

Requested commit: dd528e3efbb5c5632cc9e5cb162c0159b79f6ea6

Commit: dd528e3efbb5c5632cc9e5cb162c0159b79f6ea6

Tree: f26e388c60aea1879703caf8632b43fcab7fa96d

Author: María Craig

Committer: GitHub

## Message

```
docs: Add Skills documentation (#57095)

Adds documentation for the new Skills feature, which replaces Rules
starting in Zed v1.4.0.

## Changes

- **New page**: `docs/src/ai/skills.md` — covers what skills are,
finding and installing skills from skills.sh, using skills via slash
commands and model invocation, creating a skill (folder structure,
SKILL.md format, frontmatter fields, bundled resources), where skills
live (global vs project-local), security model, and limitations
- **Updated**: `docs/src/ai/rules.md` — added deprecation notice
pointing to Skills
- **Updated**: `docs/src/SUMMARY.md` — added Skills entry above Rules in
the AI section
- **Updated**: `docs/src/ai/agent-panel.md` — replaced reference to
"rules files" with "skills" in the Adding Context section

Release Notes:

- Added documentation for the Skills feature

---------

Co-authored-by: zed-zippy[bot] <234243425+zed-zippy[bot]@users.noreply.github.com>
Co-authored-by: Danilo Leal <daniloleal09@gmail.com>
```

## Parents

- [a4c6a8392d903dfaa9f4cdf25ed45fea1e7fcfd0](https://git.cafe/gitcafe/zed/commit/a4c6a8392d903dfaa9f4cdf25ed45fea1e7fcfd0?format=markdown)

[Source at this commit](https://git.cafe/gitcafe/zed/tree/dd528e3efbb5c5632cc9e5cb162c0159b79f6ea6?format=markdown)