Skip to main content

Module skills

Module skills 

Source
Available on crate feature skills only.
Expand description

The Skills API (beta).

Skills are reusable named bundles of files (with a required SKILL.md at the bundle root) that Claude can load on demand. A Skill is the named container and a SkillVersion is one immutable snapshot of its files.

§Beta

Every Skills method automatically sends anthropic-beta: skills-2025-10-02. Override the beta version on the Client builder if a newer revision is current.

§Endpoints

MethodPathFunction
POST/v1/skillsSkills::create
GET/v1/skillsSkills::list
GET/v1/skills/{skill_id}Skills::get
DELETE/v1/skills/{skill_id}Skills::delete
POST/v1/skills/{skill_id}/versionsSkills::create_version
GET/v1/skills/{skill_id}/versionsSkills::list_versions
GET/v1/skills/{skill_id}/versions/{version}Skills::get_version
DELETE/v1/skills/{skill_id}/versions/{version}Skills::delete_version

Structs§

CreateSkillRequest
Body for Skills::create.
ListSkillVersionsParams
Query parameters for GET /v1/skills/{skill_id}/versions.
ListSkillsParams
Query parameters for GET /v1/skills.
Skill
A skill resource. The latest_version field points to a SkillVersion::version string – pass it to Skills::get_version.
SkillDeleted
Confirmation returned by DELETE /v1/skills/{id}.
SkillFile
One file in a skill upload. The path is the relative path inside the bundle and must include the top-level directory, e.g. "my-skill/SKILL.md". Every upload must contain a SKILL.md at the directory root.
SkillVersion
One immutable snapshot of a Skill’s file bundle.
SkillVersionDeleted
Confirmation returned by DELETE /v1/skills/{id}/versions/{version}.
Skills
Namespace handle for the Skills API.

Enums§

SkillSource
Source of a skill (who created it). Open-string enum: unknown values fall through to Self::Other.
SkillSourceFilter
Subset of SkillSource valid as the source query filter on GET /v1/skills.