Skip to main content

01 — Markdown Skills

Demonstrates the SkillRegistry in three modes: eager (all skills injected), lazy (catalog + read_skill tool), and auto (agent picks based on collection size).
from definable.agent import Agent
from definable.skill import SkillRegistry

registry = SkillRegistry()  # loads 8 built-in library skills

# Eager mode — all skill instructions in system prompt
agent = Agent(model=model, skills=registry.as_eager())
output = agent.run("Review this code: def add(a, b): return a + b")

# Lazy mode — catalog table + read_skill tool
agent = Agent(model=model, skills=[registry.as_lazy()])
output = agent.run("Help me debug a null pointer error")

# Auto mode — picks eager or lazy based on collection size
agent = Agent(model=model, skill_registry=registry)
output = agent.run("Write a project plan for a REST API")

Full source

definable/examples/skills/01_markdown_skills.py