Skill Loaders

Overview

Skill loaders discover and load skills from various sources. Pass one or more loaders to Skills():

from upsonic.skills import Skills, LocalSkills, BuiltinSkills

skills = Skills(loaders=[
    BuiltinSkills(),
    LocalSkills("./my-skills"),
])

When multiple loaders provide a skill with the same name, later loaders override earlier ones.

Available Loaders

LocalSkills

Load skills from local filesystem directories. Supports single skill folders or parent directories with multiple skills.

BuiltinSkills

Use skills bundled with Upsonic — code-review, summarization, and data-analysis. No setup required.

InlineSkills

Define skills programmatically in code using Skill objects — no filesystem needed.

GitHubSkills

Download skills from GitHub repositories. Supports private repos, branch selection, and local caching.

URLSkills

Load skills from remote zip or tar archives via HTTP. Supports custom headers for authentication.

Combining Loaders

Mix and match loaders to layer skills — start with defaults, add shared skills, then apply project-specific overrides:

from upsonic import Agent, Task
from upsonic.skills import Skills, LocalSkills, BuiltinSkills, GitHubSkills

skills = Skills(loaders=[
    BuiltinSkills(),                                  # Base: built-in skills
    GitHubSkills(repo="myorg/shared-skills"),          # Shared team skills
    LocalSkills("./project-skills"),                   # Project overrides
])

agent = Agent(
    model="anthropic/claude-sonnet-4-6",
    name="My Agent",
    role="Development Assistant",
    goal="Help with development tasks",
    skills=skills,
)

task = Task(description="Analyze this code for quality issues and summarize the findings.")
result = agent.print_do(task)

Remote Loader Caching

All remote loaders (GitHubSkills, URLSkills) cache downloads locally to avoid repeated network requests:

Parameter	Type	Default	Description
`cache_dir`	`str`	`~/.upsonic/skills_cache/`	Directory for cached downloads
`cache_ttl`	`int`	`3600`	Cache TTL in seconds (1 hour)
`validate`	`bool`	`True`	Validate skills on load
`force_refresh`	`bool`	`False`	Bypass cache and re-download

GET STARTED

CONCEPTS

STARTING AN AGENT PROJECT

READY TO USE SNIPPETS

DEPLOYMENT

FURTHER READINGS

Overview

Available Loaders

LocalSkills

BuiltinSkills

InlineSkills

GitHubSkills

URLSkills

Combining Loaders

Remote Loader Caching

​Overview

​Available Loaders

LocalSkills

BuiltinSkills

InlineSkills

GitHubSkills

URLSkills

​Combining Loaders

​Remote Loader Caching

Overview

Available Loaders

Combining Loaders

Remote Loader Caching