skillgild

Official Python client for SkillGild, the marketplace for hosted AI agent skills. Search the catalog, run hosted skills and drive hybrid tool sessions from Python 3.9+. Standard library only, fully typed (py.typed, TypedDict responses).

pip install skillgild

Usage

import os, uuid
from skillgild import SkillGildClient, SkillGildError

client = SkillGildClient(api_key=os.environ["SKILLGILD_API_KEY"])

# Browse the catalog (no key needed)
page = client.list_skills("video", limit=20)
skill = client.get_skill("logo-design")  # includes media, tools and page copy

# Hybrid skills: your agent follows the guide and calls SkillGild server tools
session = client.start_session("logo-design")
check = client.call_tool(session["session_id"], "validate_svg", {"svg": "<svg .../>"})
client.end_session(session["session_id"])

# Hosted skills run in one call; reuse the idempotency key only when retrying
try:
    run = client.run_skill("some-hosted-skill", {"prompt": "..."}, idempotency_key=str(uuid.uuid4()))
    print(run["output"], run["usage"])
except SkillGildError as error:
    if error.status == 429:
        print("retry in", error.retry_after, "s")
    else:
        raise

API

SkillGildClient(api_key=None, base_url="https://api.skillgild.dev/v1", timeout=100.0). Errors are SkillGildError with status, code and retry_after.

Full reference: SkillGild API documentation · Skill catalog · Source and other languages

MIT © SkillGild, Inc.