> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Discover Skills • AI Agent SDK

> discover_skills: Discover all valid skills in the given directories.

# discover\_skills

Function

> This function is defined in the [**discovery**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/discovery.md) module.

Discover all valid skills in the given directories.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
def discover_skills(skill_dirs: Optional[List[str]], include_defaults: bool, sources: Optional[List]) -> List[SkillProperties]
```

## Parameters

**skill\_dirs** `Optional`

List of directory paths to scan for skills. Each directory should contain skill subdirectories.

**include\_defaults** `bool` (default: True)

Whether to include default skill directories

**sources** `Optional[List]`

Optional declarative remote skill sources (URL strings, `{"url","ref"}` dicts, or objects implementing `fetch`). These are synced into a versioned local cache and scanned after local directories. Opt-in and offline-safe (falls back to the last-good cache). Remote skills are re-validated by the parser like any other.

### Returns

**Returns** `List[SkillProperties]`

List of SkillProperties for all valid skills found

## Uses

* `resolve`
* `expanduser`
* `Path`
* `path.exists`
* `path.is_dir`
* `get_default_skill_dirs`
* `fetch_remote_skill_dirs`
* `logger.warning`
* `seen.add`
* `find_skill_md`

## Used By

* [`SkillManager.discover`](../functions/SkillManager-discover)
* [`SkillManager.reload`](../functions/SkillManager-reload)
* [`SkillManager.add_skill_by_name`](../functions/SkillManager-add_skill_by_name)

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/skills/discovery.py#L77)
>
> `praisonaiagents/skills/discovery.py` at line 77

***

## Related Documentation

> [card] [Skills Concept](https://praison.ai/docs/docs/concepts/skills)

> [card] [Skills Feature](https://praison.ai/docs/docs/features/skills)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.