Documentation Index
Fetch the complete documentation index at: https://docs.upsonic.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Skills system provides an in-memory TTL cache for skill content. When enabled, skill instructions, references, and system prompt sections are cached to avoid re-reading files on every access.
Usage
from upsonic import Agent
from upsonic.skills import Skills, LocalSkills
skills = Skills(
loaders=[LocalSkills("./my-skills")],
cache_ttl=300, # Cache entries for 5 minutes
)
agent = Agent(
model="anthropic/claude-sonnet-4-6",
name="Agent",
role="Assistant",
goal="Help with tasks",
skills=skills,
)
# First call reads from disk, subsequent calls within 5 min use cache
result = agent.print_do("Review this code.")
result = agent.print_do("Now review this other code.") # Uses cached skill data
Force Refresh
Call reload() to clear the cache and reload all skills from their loaders:
from upsonic.skills import Skills, LocalSkills
skills = Skills(
loaders=[LocalSkills("./my-skills")],
cache_ttl=600,
)
# After editing skill files on disk
skills.reload() # Clears cache, reloads from loaders
What Gets Cached
| Content | Cache Key |
|---|
| Skill instructions | instructions:{skill_name} |
| System prompt section | system_prompt:{task_description} |
Parameters
| Parameter | Type | Default | Description |
|---|
cache_ttl | int | None | Cache TTL in seconds. None disables caching. |
