# skills Option

> The option that picks which skills an agent session may use.

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** Agent SDK skills, Claude Agent SDK skills

## Think of it like

It is like a list of the recipe cards a cook may use.

## Definition

skills is the Agent SDK option that picks which skills a session can use. Pass all for every skill found, or a list of exact skill names. When it is set, the SDK adds the Skill tool to allowedTools for you. Skills are still found on disk through settingSources, so an empty source list leaves nothing to pick.

## Example

Mia's repo has twenty skills, but her support agent needs two. She lists just those two in skills.

## Example code

```typescript
skills: ["pdf", "release-notes"]
```

Only these two skills are on offer.

## Why it matters

Each skill on offer costs context, and a short list keeps the agent on task.

## Common mistake

Setting skills with settingSources empty. Skills are read from disk, so none are found.

## Three principles

- **all, or a list.** Exact names.
- **Adds the Skill tool.** For you.
- **Needs a source.** Found on disk.

## Related terms

- [Claude Code Skill](https://learn.benibix.com/term/ai/claude-code-skill)
- [Skill Tool](https://learn.benibix.com/term/ai/skill-tool)
- [settingSources Option](https://learn.benibix.com/term/ai/setting-sources-option)
- [plugins Option](https://learn.benibix.com/term/ai/plugins-option)

---

Source: https://learn.benibix.com/term/ai/skills-option
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
