Loading...
    • Developer Guide
    • API Reference
    • MCP
    • Resources
    • Release Notes
    Search...
    ⌘K
    Using the API
    API overviewBeta headersErrors
    Messages
    Create a Message
    Count tokens in a Message
    Models
    List Models
    Get a Model
    Beta
    Create Skill
    List Skills
    Get Skill
    Delete Skill
    Admin
    Completions
    Create a Text Completion
    Support & configuration
    Rate limitsService tiersVersionsIP addressesSupported regionsOpenAI SDK compatibility
    Console
    Log in

    Skills

    Create Skill
    beta.skills.create(SkillCreateParams**kwargs) -> SkillCreateResponse
    POST/v1/skills
    List Skills
    beta.skills.list(SkillListParams**kwargs) -> SyncPageCursor[SkillListResponse]
    GET/v1/skills
    Get Skill
    beta.skills.retrieve(strskill_id, SkillRetrieveParams**kwargs) -> SkillRetrieveResponse
    GET/v1/skills/{skill_id}
    Delete Skill
    beta.skills.delete(strskill_id, SkillDeleteParams**kwargs) -> SkillDeleteResponse
    DELETE/v1/skills/{skill_id}
    ModelsExpand Collapse
    class SkillCreateResponse: …
    id: str

    Unique identifier for the skill.

    The format and length of IDs may change over time.

    created_at: str

    ISO 8601 timestamp of when the skill was created.

    display_title: Optional[str]

    Display title for the skill.

    This is a human-readable label that is not included in the prompt sent to the model.

    latest_version: Optional[str]

    The latest version identifier for the skill.

    This represents the most recent version of the skill that has been created.

    source: str

    Source of the skill.

    This may be one of the following values:

    • "custom": the skill was created by a user
    • "anthropic": the skill was created by Anthropic
    type: str

    Object type.

    For Skills, this is always "skill".

    updated_at: str

    ISO 8601 timestamp of when the skill was last updated.

    class SkillListResponse: …
    id: str

    Unique identifier for the skill.

    The format and length of IDs may change over time.

    created_at: str

    ISO 8601 timestamp of when the skill was created.

    display_title: Optional[str]

    Display title for the skill.

    This is a human-readable label that is not included in the prompt sent to the model.

    latest_version: Optional[str]

    The latest version identifier for the skill.

    This represents the most recent version of the skill that has been created.

    source: str

    Source of the skill.

    This may be one of the following values:

    • "custom": the skill was created by a user
    • "anthropic": the skill was created by Anthropic
    type: str

    Object type.

    For Skills, this is always "skill".

    updated_at: str

    ISO 8601 timestamp of when the skill was last updated.

    class SkillRetrieveResponse: …
    id: str

    Unique identifier for the skill.

    The format and length of IDs may change over time.

    created_at: str

    ISO 8601 timestamp of when the skill was created.

    display_title: Optional[str]

    Display title for the skill.

    This is a human-readable label that is not included in the prompt sent to the model.

    latest_version: Optional[str]

    The latest version identifier for the skill.

    This represents the most recent version of the skill that has been created.

    source: str

    Source of the skill.

    This may be one of the following values:

    • "custom": the skill was created by a user
    • "anthropic": the skill was created by Anthropic
    type: str

    Object type.

    For Skills, this is always "skill".

    updated_at: str

    ISO 8601 timestamp of when the skill was last updated.

    class SkillDeleteResponse: …
    id: str

    Unique identifier for the skill.

    The format and length of IDs may change over time.

    type: str

    Deleted object type.

    For Skills, this is always "skill_deleted".

    SkillsVersions

    Create Skill Version
    beta.skills.versions.create(strskill_id, VersionCreateParams**kwargs) -> VersionCreateResponse
    POST/v1/skills/{skill_id}/versions
    List Skill Versions
    beta.skills.versions.list(strskill_id, VersionListParams**kwargs) -> SyncPageCursor[VersionListResponse]
    GET/v1/skills/{skill_id}/versions
    Get Skill Version
    beta.skills.versions.retrieve(strversion, VersionRetrieveParams**kwargs) -> VersionRetrieveResponse
    GET/v1/skills/{skill_id}/versions/{version}
    Delete Skill Version
    beta.skills.versions.delete(strversion, VersionDeleteParams**kwargs) -> VersionDeleteResponse
    DELETE/v1/skills/{skill_id}/versions/{version}
    ModelsExpand Collapse
    class VersionCreateResponse: …
    id: str

    Unique identifier for the skill version.

    The format and length of IDs may change over time.

    created_at: str

    ISO 8601 timestamp of when the skill version was created.

    description: str

    Description of the skill version.

    This is extracted from the SKILL.md file in the skill upload.

    directory: str

    Directory name of the skill version.

    This is the top-level directory name that was extracted from the uploaded files.

    name: str

    Human-readable name of the skill version.

    This is extracted from the SKILL.md file in the skill upload.

    skill_id: str

    Identifier for the skill that this version belongs to.

    type: str

    Object type.

    For Skill Versions, this is always "skill_version".

    version: str

    Version identifier for the skill.

    Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

    class VersionListResponse: …
    id: str

    Unique identifier for the skill version.

    The format and length of IDs may change over time.

    created_at: str

    ISO 8601 timestamp of when the skill version was created.

    description: str

    Description of the skill version.

    This is extracted from the SKILL.md file in the skill upload.

    directory: str

    Directory name of the skill version.

    This is the top-level directory name that was extracted from the uploaded files.

    name: str

    Human-readable name of the skill version.

    This is extracted from the SKILL.md file in the skill upload.

    skill_id: str

    Identifier for the skill that this version belongs to.

    type: str

    Object type.

    For Skill Versions, this is always "skill_version".

    version: str

    Version identifier for the skill.

    Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

    class VersionRetrieveResponse: …
    id: str

    Unique identifier for the skill version.

    The format and length of IDs may change over time.

    created_at: str

    ISO 8601 timestamp of when the skill version was created.

    description: str

    Description of the skill version.

    This is extracted from the SKILL.md file in the skill upload.

    directory: str

    Directory name of the skill version.

    This is the top-level directory name that was extracted from the uploaded files.

    name: str

    Human-readable name of the skill version.

    This is extracted from the SKILL.md file in the skill upload.

    skill_id: str

    Identifier for the skill that this version belongs to.

    type: str

    Object type.

    For Skill Versions, this is always "skill_version".

    version: str

    Version identifier for the skill.

    Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

    class VersionDeleteResponse: …
    id: str

    Version identifier for the skill.

    Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

    type: str

    Deleted object type.

    For Skill Versions, this is always "skill_version_deleted".

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy