# list_skills

> **Function** in `deepagents_code`

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

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

This is a dcode-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. `plugin_skill_sources`
2. `user_skills_dir` (`~/.deepagents/{agent}/skills/`)
3. `user_agent_skills_dir` (`~/.agents/skills/`)
4. `project_skills_dir` (`.deepagents/skills/`)
5. `project_agent_skills_dir` (`.agents/skills/`)
6. `user_claude_skills_dir` (`~/.claude/skills/`, experimental)
7. `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,
    plugin_skill_sources: Sequence[tuple[Path, str]] = (),
    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`) |
| `plugin_skill_sources` | `Sequence[tuple[Path, str]]` | No | Plugin skill source directories with namespaces. (default: `()`) |
| `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/3812967c84d90619848f3185f22470204fc88bd8/libs/code/deepagents_code/skills/load.py#L48)