Agent Skills

SDK methods to create, list, retrieve, update, and delete agent skills in TrueFoundry.

Methods

get

Get an agent skill artifact by its ID.

Parameters

agent_skill_id · str · required

Returns

GetAgentSkillResponse · GetAgentSkillResponse

🔗 GetAgentSkillResponse

Successful Response

Usage

from truefoundry import TrueFoundry

client = TrueFoundry(
    api_key="YOUR_API_KEY",
    base_url="https://yourhost.com/path/to/api",
)

client.agent_skills.get(
    agent_skill_id="value",
)

delete

Delete an agent skill artifact by its ID.

Parameters

agent_skill_id · str · required

Returns

EmptyResponse · EmptyResponse

🔗 EmptyResponse

Successful Response

Usage

from truefoundry import TrueFoundry

client = TrueFoundry(
    api_key="YOUR_API_KEY",
    base_url="https://yourhost.com/path/to/api",
)

client.agent_skills.delete(
    agent_skill_id="value",
)

list

List agent skills with optional filtering by FQN, ML Repo, or name. When present, latest_version.manifest.source is blob-storage with description only; use GET agent skill version for full SKILL.md (inline source with skill_md).

Parameters

fqn · typing.Optional[str]

Fully qualified name to filter agent skills by (format: ‘agent-skill://’)

ml_repo_id · typing.Optional[str]

ML Repo ID filter

name · typing.Optional[str]

Agent skill name filter

offset · typing.Optional[int]

Pagination offset

limit · typing.Optional[int]

Page size

include_empty_agent_skills · typing.Optional[bool]

Whether to include agent skills that have no versions

Returns

SyncPager[AgentSkill, ListAgentSkillsResponse] · SyncPager[AgentSkill, ListAgentSkillsResponse]

🔗 ListAgentSkillsResponse

Successful Response

Usage

from truefoundry import TrueFoundry

client = TrueFoundry(
    api_key="YOUR_API_KEY",
    base_url="https://yourhost.com/path/to/api",
)

client.agent_skills.list(
    fqn="value",
    ml_repo_id="value",
    name="value",
    offset=10,
    limit=10,
    include_empty_agent_skills="value",
)

# Iterate through results
for item in response:
    print(item.name)

# Or paginate page by page
for page in response.iter_pages():
    for item in page:
        print(item.name)

create_or_update

Create or update an agent skill version from a manifest.

Parameters

manifest · AgentSkillManifest · required

🔗 AgentSkillManifest

Manifest containing metadata for the agent skill to apply

Returns

GetAgentSkillVersionResponse · GetAgentSkillVersionResponse

🔗 GetAgentSkillVersionResponse

The created or updated agent skill version

Usage

from truefoundry import TrueFoundry

client = TrueFoundry(
    api_key="YOUR_API_KEY",
    base_url="https://yourhost.com/path/to/api",
)

client.agent_skills.create_or_update(
    manifest={"key": "value"},
)