π The fast, Pythonic way to build MCP servers and clients.
---
title: skill
sidebarTitle: skill
---
# `fastmcp.skills.skill`
Storage-neutral agent skills.
## Classes
### `Skill` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/skills/skill.py#L51" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
An agent skill: a `SKILL.md` plus supporting files, independent of storage.
A `Skill` holds exact file bytes. It doesn't know where it came from or which
URI it is served under; a provider decides that. Author one in Python with the
keyword constructor, or snapshot one from a directory, package, or mapping of
files.
**Methods:**
#### `from_files` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/skills/skill.py#L132" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
from_files(cls, files: Mapping[str, str | bytes]) -> Skill
```
Create a skill from relative paths mapped to text or bytes.
`files` must include `SKILL.md` with valid frontmatter.
#### `from_directory` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/skills/skill.py#L142" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
from_directory(cls, path: str | os.PathLike[str]) -> Skill
```
Read a skill folder once and return an immutable snapshot.
The folder name must match the `name` in its `SKILL.md`. Symlinks and
special files are rejected, so a snapshot never reaches outside the folder.
#### `from_package` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/skills/skill.py#L162" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
from_package(cls, package: str, path: str) -> Skill
```
Load a skill folder shipped as package data, such as `("my_pkg", "skills/review")`.
#### `to_directory` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/skills/skill.py#L188" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
to_directory(self, path: str | os.PathLike[str]) -> Path
```
Write the skill's files into `path`, a folder named after the skill.
The folder name must match the skill's `name`, so `from_directory` can
read it back. An existing folder raises `FileExistsError` unless
`overwrite` is set, in which case it is replaced: files that aren't
part of the skill are removed. Files are staged before replacing an
existing folder. If replacement and restoration both fail, the error
identifies where the previous folder has been retained.
#### `name` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/skills/skill.py#L245" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
name(self) -> str
```
#### `description` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/skills/skill.py#L249" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
description(self) -> str
```
#### `frontmatter` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/skills/skill.py#L253" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
frontmatter(self) -> SkillFrontmatter
```
A copy of the parsed frontmatter; changing it does not change the skill.
#### `files` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/skills/skill.py#L258" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
files(self) -> Mapping[str, bytes]
```
Every file in the skill, keyed by relative path, including `SKILL.md`.
#### `to_mcp_skill` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/skills/skill.py#L262" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
to_mcp_skill(self, path: str | None = None) -> MCPSkill
```
Build the Skills extension entry for this skill served at `skill://{path}/`.