Skip to content

Interface: RemoteSkillSourceOptions

One remote skill source and its per-source policy.

source is AITOOLS_SOURCE or anything the skills ecosystem understands: a GitHub owner/repo shorthand, a full GitHub / GitLab / git URL, or a direct download URL to a SKILL.md or archive.

optional experimental?: boolean

Include experimental skills. "aitools" only.


optional failOnError?: boolean

When false, a source that fails to resolve is logged and skipped instead of failing app startup. Overrides the top-level ProvisionRemoteSkillsOptions.failOnError.


optional maxDownloadBytes?: number

Override the byte ceiling on a direct-fetch download for this source.


optional ref?: string

Pin the repo ref (tag / branch / sha). "aitools" only; defaults to main.


optional refreshTtlMs?: number

How long this source’s provisioned tree is reused before it is downloaded again, in milliseconds. Overrides the top-level ProvisionRemoteSkillsOptions.refreshTtlMs; 0 re-downloads on every boot.


optional skills?: string | string[]

Install only these skill names from the source.


source: UrlLike

"aitools", a GitHub shorthand, a git / GitLab URL, or a download URL.