> ## 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.

# remote • AI Agent SDK

> Declarative remote skill sources with a versioned local cache.

# remote

AI Agent

Declarative remote skill sources with a versioned local cache.

A remote skill source is fetched at discovery time, cached under
`~/.praisonai/cache/remote-skills/<source-id>/` in a versioned directory, and
atomically swapped in when the remote changes. Sync is opt-in, offline-safe
(falls back to the last-good cache), and adds zero import-time cost — the module
is only imported when a caller passes `sources=` to `discover_skills`.

Remote content is untrusted: callers re-run the existing skill validator on the
returned directories before injecting anything into a prompt.

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents.skills import remote
```

## Classes

> [card] [GitRemoteSkillSource](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/GitRemoteSkillSource.md)
>
> Default remote skill source backed by a shallow git clone.

## Functions

> [card] [get\_remote\_cache\_root()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/get_remote_cache_root.md)
>
> Return the root cache directory for remote skill sources.

> [card] [fetch\_remote\_skill\_dirs()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/fetch_remote_skill_dirs.md)
>
> Fetch all remote skill sources and return validated cache directories.

### Constants

| Name | Value |
| - | - |
| `CACHE_SUBDIR` | `'remote-skills'` |
| `_CURRENT_LINK` | `'current'` |
| `_GIT_TIMEOUT` | `120` |


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