> ## Documentation Index > Fetch the complete documentation index at: https://www.truefoundry.com/llms.txt > Use this file to discover all available pages before exploring further. # Get agent skill > Get an agent skill by its ID. ## OpenAPI ````yaml /openapi.json get /api/ml/v1/agent-skills/{agent_skill_id} openapi: 3.1.0 info: title: TrueFoundry API description: API for TrueFoundry version: 0.1.0 contact: {} servers: - url: https://{controlPlaneURL} variables: controlPlaneURL: default: app.truefoundry.com description: Control Plane URL security: [] tags: - name: Agent - name: Agent Skills - name: Applications - name: Apply - name: Artifacts - name: Audit Logs - name: Clusters - name: Jobs - name: Logs - name: MCP Servers V2 - name: MLRepos - name: Model Deployments - name: Models - name: Personal Access Tokens - name: Prompts - name: Provider Integrations - name: SCIM v2 - name: Secret Groups - name: Secrets - name: Teams - name: Traces - name: Users - name: Virtual Accounts - name: Role Bindings - name: Workspaces paths: /api/ml/v1/agent-skills/{agent_skill_id}: get: tags: - Agent Skills summary: Get agent skill description: Get an agent skill by its ID. operationId: get_agent_skill_v1_agent_skills__agent_skill_id__get parameters: - required: true schema: type: string title: Agent Skill Id name: agent_skill_id in: path responses: '200': description: The agent skill data content: application/json: schema: $ref: '#/components/schemas/GetAgentSkillResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - jwt: [] components: schemas: GetAgentSkillResponse: properties: data: allOf: - $ref: '#/components/schemas/AgentSkill' title: Data description: The agent skill data type: object required: - data title: GetAgentSkillResponse x-fern-type-name: GetAgentSkillResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError x-fern-type-name: HTTPValidationError AgentSkill: properties: id: type: string title: Id description: Unique identifier for the artifact ml_repo_id: type: string title: Ml Repo Id description: ID of the ML Repo that this artifact belongs to type: type: string enum: - agent-skill title: Type description: Artifact type; always 'agent-skill' for agent skill entities default: agent-skill name: type: string title: Name description: >- Name of the artifact (alphanumeric characters, hyphens, and underscores only, max 256 characters) fqn: type: string title: Fqn description: >- Fully qualified name of the artifact in the format '{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}' created_by_subject: allOf: - $ref: '#/components/schemas/Subject' title: Created By Subject description: Subject (user, team, or service account) that created this artifact created_at: type: string format: date-time title: Created At description: Timestamp when the artifact was created updated_at: type: string format: date-time title: Updated At description: Timestamp when the artifact was last updated latest_version: allOf: - $ref: '#/components/schemas/AgentSkillVersion' title: Latest Version description: The most recent version of this agent skill type: object required: - id - ml_repo_id - name - fqn - created_by_subject title: AgentSkill description: Core artifact fields (identity, type, latest version) x-fern-type-name: AgentSkill ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError x-fern-type-name: ValidationError Subject: type: object properties: subjectId: type: string description: Subject ID subjectType: description: Subject type allOf: - $ref: '#/components/schemas/SubjectType' subjectSlug: type: string description: Subject slug nullable: true subjectDisplayName: type: string description: Subject display name nullable: true subjectPatName: type: string description: Subject PAT name nullable: true subjectControllerName: type: string nullable: true subjectExternalIdentitySlug: type: string description: External identity slug (external_identity_id:sub:email) nullable: true required: - subjectId - subjectType title: Subject x-fern-type-name: Subject AgentSkillVersion: properties: id: type: string title: Id description: Unique identifier for the artifact version fqn: type: string title: Fqn description: >- Fully qualified name of the artifact version in the format '{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}:{version}' created_by_subject: allOf: - $ref: '#/components/schemas/Subject' title: Created By Subject description: >- Subject (user, team, or service account) that created this artifact version created_at: type: string format: date-time title: Created At description: Timestamp when the artifact version was created updated_at: type: string format: date-time title: Updated At description: Timestamp when the artifact version was last updated manifest: allOf: - $ref: '#/components/schemas/AgentSkillManifest' title: Manifest description: Manifest containing metadata specific to this agent skill version ml_repo_id: type: string title: Ml Repo Id description: ID of the ML Repo that this artifact version belongs to agent_skill_id: type: string title: Agent Skill Id description: ID of the parent agent skill artifact that this version belongs to usage_code_snippets: items: $ref: '#/components/schemas/UsageCodeSnippet' type: array title: Usage Code Snippets description: >- Code snippets demonstrating how to download or use this agent skill version type: object required: - id - fqn - created_by_subject - manifest - ml_repo_id - agent_skill_id title: AgentSkillVersion description: Shared artifact-version fields (identity, manifest union, ML repo). x-fern-type-name: AgentSkillVersion SubjectType: type: string enum: - user - team - serviceaccount - virtualaccount - external-identity - role description: >- Type of the authenticated subject. "user" for human users, "serviceaccount" (also known as virtual account) for programmatic access. title: SubjectType x-fern-type-name: SubjectType AgentSkillManifest: properties: name: type: string maxLength: 64 minLength: 1 pattern: ^(?!.*anthropic)(?!.*claude)[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$ title: Name description: Name of the skill. metadata: type: object title: Metadata description: >- Key value metadata. Should be valid JSON. For e.g. `{"business-unit": "sales", "quality": "good", "rating": 4.5}` ml_repo: type: string pattern: ^[a-zA-Z][a-zA-Z0-9\-]{1,98}[a-zA-Z0-9]$ title: Ml Repo description: Name of the ML Repo version: type: integer minimum: 1 title: Version description: Version of the entity type: type: string enum: - agent-skill title: Type default: agent-skill source: oneOf: - $ref: '#/components/schemas/AgentSkillSourceInline' - $ref: '#/components/schemas/AgentSkillSourceBlobStorage' - $ref: '#/components/schemas/AgentSkillSourceLocal' title: Source discriminator: propertyName: type mapping: inline: $ref: '#/components/schemas/AgentSkillSourceInline' blob-storage: $ref: '#/components/schemas/AgentSkillSourceBlobStorage' local: $ref: '#/components/schemas/AgentSkillSourceLocal' type: object required: - name - metadata - ml_repo - source title: AgentSkillManifest description: >- Apply/API agent-skill manifest; ``source`` is inline (apply) or blob-storage (stored). x-fern-type-name: AgentSkillManifest UsageCodeSnippet: properties: display_name: type: string title: Display Name description: >- Display label for the snippet (e.g. 'Python', 'Download via TFY CLI') language: type: string title: Language description: Language identifier (e.g. 'python', 'bash', 'javascript') libraries: items: type: string type: array title: Libraries description: Libraries, CLIs, or frameworks relevant to the snippet code: type: string title: Code description: The snippet body shown to users icon: type: string title: Icon description: Use a URL or an icon name like 'download'. type: object required: - display_name - language - code title: UsageCodeSnippet description: >- Example code or shell commands for using an ML entity (prompt, agent skill, etc.). x-fern-type-name: UsageCodeSnippet AgentSkillSourceInline: properties: type: type: string enum: - inline title: Type skill_md: type: string maxLength: 20000 minLength: 1 title: Skill Md description: Main body of SKILL.md file. type: object required: - type - skill_md title: AgentSkillSourceInline description: SKILL.md for this version when using inline source. x-fern-type-name: AgentSkillSourceInline AgentSkillSourceBlobStorage: properties: type: type: string enum: - blob-storage title: Type description: type: string maxLength: 1024 minLength: 1 title: Description description: 1–1024 chars. uri: type: string minLength: 1 title: Uri description: Storage URI of the blob storage object where the skill is stored. type: object required: - type - description - uri title: AgentSkillSourceBlobStorage description: SKILL.md content stored on blob x-fern-type-name: AgentSkillSourceBlobStorage AgentSkillSourceLocal: properties: type: type: string enum: - local title: Type skill_dir: type: string minLength: 1 title: Skill Dir description: >- Path to the skill root directory, including SKILL.md and related assets. type: object required: - type - skill_dir title: AgentSkillSourceLocal description: >- Load the skill from a local directory. The directory must include SKILL.md with valid YAML front matter. x-fern-type-name: AgentSkillSourceLocal securitySchemes: jwt: type: http scheme: bearer bearerFormat: JWT ````