# list_skills

> **Function** in `deepagents_cli`

📖 [View in docs](https://reference.langchain.com/python/deepagents-cli/skills/load/list_skills)

List skills from built-in, user, and/or project directories.

This is a CLI-specific wrapper around the prebuilt middleware's skill loading
functionality. It uses FilesystemBackend to load skills from local directories.

Precedence order (lowest to highest):
0. `built_in_skills_dir` (`<package>/built_in_skills/`)
1. `user_skills_dir` (`~/.deepagents/{agent}/skills/`)
2. `user_agent_skills_dir` (`~/.agents/skills/`)
3. `project_skills_dir` (`.deepagents/skills/`)
4. `project_agent_skills_dir` (`.agents/skills/`)
5. `user_claude_skills_dir` (`~/.claude/skills/`, experimental)
6. `project_claude_skills_dir` (`.claude/skills/`, experimental)

Skills from higher-precedence directories override those with the same name.

## Signature

```python
list_skills(
    *,
    built_in_skills_dir: Path | None = None,
    user_skills_dir: Path | None = None,
    project_skills_dir: Path | None = None,
    user_agent_skills_dir: Path | None = None,
    project_agent_skills_dir: Path | None = None,
    user_claude_skills_dir: Path | None = None,
    project_claude_skills_dir: Path | None = None,
) -> list[ExtendedSkillMetadata]
```

## Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `built_in_skills_dir` | `Path \| None` | No | Path to built-in skills shipped with the package. (default: `None`) |
| `user_skills_dir` | `Path \| None` | No | Path to `~/.deepagents/{agent}/skills/`. (default: `None`) |
| `project_skills_dir` | `Path \| None` | No | Path to `.deepagents/skills/`. (default: `None`) |
| `user_agent_skills_dir` | `Path \| None` | No | Path to `~/.agents/skills/` (alias). (default: `None`) |
| `project_agent_skills_dir` | `Path \| None` | No | Path to `.agents/skills/` (alias). (default: `None`) |
| `user_claude_skills_dir` | `Path \| None` | No | Path to `~/.claude/skills/` (experimental). (default: `None`) |
| `project_claude_skills_dir` | `Path \| None` | No | Path to `.claude/skills/` (experimental). (default: `None`) |

## Returns

`list[ExtendedSkillMetadata]`

Merged list of skill metadata from all sources, with higher-precedence
directories taking priority when names conflict.

---

[View source on GitHub](https://github.com/langchain-ai/deepagents/blob/0b13f3e0e2726fdb7bbe1e0cf88dac76dbd43b01/libs/cli/deepagents_cli/skills/load.py#L47)