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

<Badge color="blue">AI Agent</Badge>

Declarative remote skill sources with a versioned local cache.

A remote skill source is fetched at discovery time, cached under
`~/.praisonai/cache/remote-skills/&lt;source-id&gt;/` 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

<CardGroup cols={2}>
  <Card title="GitRemoteSkillSource" icon="brackets-curly" href="../classes/GitRemoteSkillSource">
    Default remote skill source backed by a shallow git clone.
  </Card>
</CardGroup>

## Functions

<CardGroup cols={2}>
  <Card title="get_remote_cache_root()" icon="function" href="../functions/get_remote_cache_root">
    Return the root cache directory for remote skill sources.
  </Card>

  <Card title="fetch_remote_skill_dirs()" icon="function" href="../functions/fetch_remote_skill_dirs">
    Fetch all remote skill sources and return validated cache directories.
  </Card>
</CardGroup>

### Constants

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