Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ixo.world/llms.txt

Use this file to discover all available pages before exploring further.

Source: packages/oracle-runtime/src/plugins/skills/
AttributeValue
Visibilityalways
Stabilitystable
Categorydata
Default stateOn
Depends onsandbox (hard dep — boot fails without it)

​
Summary

Discover IXO skill capsules. Both list_skills and search_skills mint an ixo:skills UCAN invocation per call so the registry surfaces the caller’s own published private skills alongside public ones. When minting fails the tools degrade to public-only — they never throw on auth issues. Pairs with sandbox for execution (see Plugin vs Skill).

​
Environment variables

VarRequiredDescription
SKILLS_CAPSULES_BASE_URLnoDefaults to https://capsules.skills.ixo.earth.
NETWORKnoRead but not owned (declared by the core base env schema). Forwarded as X-IXO-Network.

​
What it contributes

  • Tools: list_skills, search_skills.
  • Sub-agents: none.
  • Middleware: none.
  • HTTP routes: none.
  • Shared state: none.

​
Opt out / Opt in

const app = await createOracleApp({
  config,
  features: { skills: false }, // never load
  // features: { skills: true }, // force load (default)
});

​
When to use it

  • User asks “what skills are available?” or “what can you do?”.
  • User asks the agent to find a skill for a specific task (“a skill for invoices”, “is there a skill for KYC?”).
  • Before running a skill via the sandbox, list or search to obtain its cid and path.

​
When NOT to use it

  • Executing a skill — that goes through sandbox (sandbox_run), not the skills tools.
  • General web search — use firecrawl.

Plugin vs Skill

Why skills discovers and sandbox executes.

Declare dependencies

Pattern used here to require sandbox.