AI Skill Registry — Documentation

This service is a canonical registry of AI-executable skills. Skills are published as OpenAPI contracts and selected by AI agents at runtime using explicit policies.

What is a Skill

A skill is not code and not an SDK. A skill is a stable identity (capability) with one or more immutable versions.

Each skill version is a contract that describes:

Once approved, a skill version becomes immutable and safe for agent consumption.

Publishing a Skill

  1. Sign in with Google
  2. Create a skill (capability) and its initial version
  3. Provide an OpenAPI spec and required safety metadata
  4. Submit the version for review
  5. After approval, the skill becomes available to agents

Skill versions are auto-versioned by the system (v1, v2, v3 …). Users do not choose version numbers manually.

Only approved skill versions are visible to agents.

Skill Version Lifecycle

draft → pending → approved → deprecated
          ↓
       rejected

Approved versions cannot be edited. To change behavior, authors create a new version.

Deprecation

Deprecation is used to safely retire older versions without breaking agents.

When a new version is approved, the previously approved version is automatically deprecated.

Agent Integration

Agents do not browse skills manually. They request an action by capability.

Resolve API

POST /api/skills/resolve
Content-Type: application/json

{
  "capability": "get_current_time",
  "max_cost": 0.01,
  "sandbox_only": true
}

The registry applies policies and returns the latest approved, non-deprecated skill version.

If only deprecated versions exist, one may be returned with a deprecation flag.

Important Guarantees