Skills API

Skills are reusable instruction blocks (typically SKILL.md files) that modify how an agent thinks. Unlike tools — which add capability — skills shape behavior. They’re first-class manifest components, so a change to a skill appears in your regression-check impact report. The runtime that picks the right skill for the right query is the Skill Router — read that first if you haven’t.

Lifecycle

The SkillRouter Python class wraps every CRUD operation; the REST endpoints below are what it calls under the hood.

Common patterns

Routing at runtime

The Skill Router picks which skills to load on every query — and produces the telemetry that scores them.

Bulk-sync from disk

Watch ./skills/*.md, send the whole batch on every change. The platform diffs by content hash — unchanged files are no-ops.

Publish to registry

Skills with visibility=public appear in the registry. SkillScore (0–100) is a composite of benchmark lift, live eval pass rate, AI-judge rating and cross-org adoption, computed from real activations.

Version history

Each body change creates a new version. The version history is the audit log — every version preserves its body markdown and content hash.

Quick start

from decimalai.skill_router import SkillRouter

router = SkillRouter(api_key="dai_sk_...")

# Create a skill
router.create_skill(
    name="search-flights",
    description="Search available flights",
    body_markdown="# Search Flights\n\n## When to activate\nUse when the user asks about flight availability.",
)

# Sync many skills at once from a local directory
from decimalai.skills import discover_skills
router.sync_skills(skills=discover_skills(["./skills"]))

# Smart-route a query to the best skill (see /api-reference/skills/router for details)
result = router.smart_route(query="Find flights to Tokyo", top_k=5)

Concepts

Skill vs tool: a skill is a structured instruction; a tool is an executable function. See Skills & Data Pipeline for the distinction.
Skill activation: a record of which skills were loaded for a given trace — used for effectiveness analytics. The Router produces these.
Fork: POST /api/v1/registry/skills/{id}/fork copies a registry skill into your org as an editable copy. Edits to your fork don’t affect the public version. Use /use instead for a linked pointer that tracks upstream.

Skill Router — the runtime concept + telemetry it produces
Skills Guide — hands-on tutorial
Skills & Data Pipeline — conceptual model
Registry API — browse / fork public skills

Overview

Traces

Evaluations

Replay

Skills

Manifests

Datasets

Registry

Lifecycle

Common patterns

Routing at runtime

Bulk-sync from disk

Publish to registry

Version history

Quick start

Concepts

​Lifecycle

​Common patterns

Routing at runtime

Bulk-sync from disk

Publish to registry

Version history

​Quick start

​Concepts

​Related

Lifecycle

Common patterns

Quick start

Concepts

Related