[Feat] New API - Claude Skills API (Anthropic) (#17042)

* init readme

* init BaseSkillsAPIConfig

* init types for Skills APIs

* add feat: add create, list, retrieve skills

* add base skills config

* add BaseSkillsAPIConfig

* add get_provider_skills_api_config

* init skills

* add ANTHROPIC_SKILLS_API_BETA_VERSION

* init skills APIs

* working list, get skills

* working e2e skills API anthropic API

* add _prepare_skill_multipart_request

* add skills routes to llm api routes

* router _initialize_skills_endpoints

* add fix skills endpoints

* add convert_upload_files_to_file_data

* fix routing skills endpoints

* fix route llm request

* Potential fix for code scanning alert no. 3806: Clear-text logging of sensitive information

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

* Potential fix for code scanning alert no. 3809: Clear-text logging of sensitive information

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

* fix ruff checks

* test_initialize_skills_endpoints

* fix claude skills mypy linting errors

---------

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

Author: ishaan-jaff

litellm/__init__.py

@@ -1271,6 +1271,8 @@ def add_known_models():
     OpenAIOSeriesConfig as OpenAIO1Config,  # maintain backwards compatibility
     OpenAIOSeriesConfig,
 )
+from .llms.anthropic.skills.transformation import AnthropicSkillsConfig
+from .llms.base_llm.skills.transformation import BaseSkillsAPIConfig
 
 from .llms.gradient_ai.chat.transformation import GradientAIConfig
 
@@ -1367,6 +1369,18 @@ def add_known_models():
 from .llms.lemonade.chat.transformation import LemonadeChatConfig
 from .llms.snowflake.embedding.transformation import SnowflakeEmbeddingConfig
 from .main import *  # type: ignore
+
+# Skills API
+from .skills.main import (
+    create_skill,
+    acreate_skill,
+    list_skills,
+    alist_skills,
+    get_skill,
+    aget_skill,
+    delete_skill,
+    adelete_skill,
+)
 from .integrations import *
 from .llms.custom_httpx.async_client_cleanup import close_litellm_async_clients
 from .exceptions import (
@@ -1404,6 +1418,16 @@ def add_known_models():
 from .rerank_api.main import *
 from .llms.anthropic.experimental_pass_through.messages.handler import *
 from .responses.main import *
+from .skills.main import (
+    create_skill,
+    acreate_skill,
+    list_skills,
+    alist_skills,
+    get_skill,
+    aget_skill,
+    delete_skill,
+    adelete_skill,
+)
 from .containers.main import *
 from .ocr.main import *
 from .search.main import *

litellm/constants.py

@@ -291,6 +291,7 @@
 
 ############### LLM Provider Constants ###############
 ### ANTHROPIC CONSTANTS ###
+ANTHROPIC_SKILLS_API_BETA_VERSION = "skills-2025-10-02"
 ANTHROPIC_WEB_SEARCH_TOOL_MAX_USES = {
     "low": 1,
     "medium": 5,

litellm/llms/anthropic/skills/__init__.py

@@ -0,0 +1,6 @@
+"""Anthropic Skills API integration"""
+
+from .transformation import AnthropicSkillsConfig
+
+__all__ = ["AnthropicSkillsConfig"]
+

litellm/llms/anthropic/skills/readme.md

@@ -0,0 +1,17 @@
+# Anthropic Skills API
+
+This folder maintains the integration for the Anthropic Skills API.
+
+You can do the following with the Anthropic Skills API:
+
+1. Create a new skill
+2. List all skills
+3. Get a skill
+4. Delete a skill
+
+
+Versions:
+    - Create Skill Version
+    - List Skill Versions
+    - Get Skill Version
+    - Delete Skill Version

litellm/llms/anthropic/skills/transformation.py

@@ -0,0 +1,211 @@
+"""
+Anthropic Skills API configuration and transformations
+"""
+
+from typing import Any, Dict, Optional, Tuple
+
+import httpx
+
+from litellm._logging import verbose_logger
+from litellm.llms.base_llm.skills.transformation import (
+    BaseSkillsAPIConfig,
+    LiteLLMLoggingObj,
+)
+from litellm.types.llms.anthropic_skills import (
+    CreateSkillRequest,
+    DeleteSkillResponse,
+    ListSkillsParams,
+    ListSkillsResponse,
+    Skill,
+)
+from litellm.types.router import GenericLiteLLMParams
+from litellm.types.utils import LlmProviders
+
+
+class AnthropicSkillsConfig(BaseSkillsAPIConfig):
+    """Anthropic-specific Skills API configuration"""
+
+    @property
+    def custom_llm_provider(self) -> LlmProviders:
+        return LlmProviders.ANTHROPIC
+
+    def validate_environment(
+        self, headers: dict, litellm_params: Optional[GenericLiteLLMParams]
+    ) -> dict:
+        """Add Anthropic-specific headers"""
+        from litellm.llms.anthropic.common_utils import AnthropicModelInfo
+
+        # Get API key
+        api_key = None
+        if litellm_params:
+            api_key = litellm_params.api_key
+        api_key = AnthropicModelInfo.get_api_key(api_key)
+
+        if not api_key:
+            raise ValueError("ANTHROPIC_API_KEY is required for Skills API")
+
+        # Add required headers
+        headers["x-api-key"] = api_key
+        headers["anthropic-version"] = "2023-06-01"
+        
+        # Add beta header for skills API
+        from litellm.constants import ANTHROPIC_SKILLS_API_BETA_VERSION
+        
+        if "anthropic-beta" not in headers:
+            headers["anthropic-beta"] = ANTHROPIC_SKILLS_API_BETA_VERSION
+        elif isinstance(headers["anthropic-beta"], list):
+            if ANTHROPIC_SKILLS_API_BETA_VERSION not in headers["anthropic-beta"]:
+                headers["anthropic-beta"].append(ANTHROPIC_SKILLS_API_BETA_VERSION)
+        elif isinstance(headers["anthropic-beta"], str):
+            if ANTHROPIC_SKILLS_API_BETA_VERSION not in headers["anthropic-beta"]:
+                headers["anthropic-beta"] = [headers["anthropic-beta"], ANTHROPIC_SKILLS_API_BETA_VERSION]
+        
+        headers["content-type"] = "application/json"
+
+        return headers
+
+    def get_complete_url(
+        self,
+        api_base: Optional[str],
+        endpoint: str,
+        skill_id: Optional[str] = None,
+    ) -> str:
+        """Get complete URL for Anthropic Skills API"""
+        from litellm.llms.anthropic.common_utils import AnthropicModelInfo
+
+        if api_base is None:
+            api_base = AnthropicModelInfo.get_api_base()
+
+        if skill_id:
+            return f"{api_base}/v1/skills/{skill_id}?beta=true"
+        return f"{api_base}/v1/{endpoint}?beta=true"
+
+    def transform_create_skill_request(
+        self,
+        create_request: CreateSkillRequest,
+        litellm_params: GenericLiteLLMParams,
+        headers: dict,
+    ) -> Dict:
+        """Transform create skill request for Anthropic"""
+        verbose_logger.debug(
+            "Transforming create skill request: %s", create_request
+        )
+        
+        # Anthropic expects the request body directly
+        request_body = {k: v for k, v in create_request.items() if v is not None}
+        
+        return request_body
+
+    def transform_create_skill_response(
+        self,
+        raw_response: httpx.Response,
+        logging_obj: LiteLLMLoggingObj,
+    ) -> Skill:
+        """Transform Anthropic response to Skill object"""
+        response_json = raw_response.json()
+        verbose_logger.debug(
+            "Transforming create skill response: %s", response_json
+        )
+        
+        return Skill(**response_json)
+
+    def transform_list_skills_request(
+        self,
+        list_params: ListSkillsParams,
+        litellm_params: GenericLiteLLMParams,
+        headers: dict,
+    ) -> Tuple[str, Dict]:
+        """Transform list skills request for Anthropic"""
+        from litellm.llms.anthropic.common_utils import AnthropicModelInfo
+
+        api_base = AnthropicModelInfo.get_api_base(
+            litellm_params.api_base if litellm_params else None
+        )
+        url = self.get_complete_url(api_base=api_base, endpoint="skills")
+        
+        # Build query parameters
+        query_params: Dict[str, Any] = {}
+        if "limit" in list_params and list_params["limit"]:
+            query_params["limit"] = list_params["limit"]
+        if "page" in list_params and list_params["page"]:
+            query_params["page"] = list_params["page"]
+        if "source" in list_params and list_params["source"]:
+            query_params["source"] = list_params["source"]
+        
+        verbose_logger.debug(
+            "List skills request made to Anthropic Skills endpoint with params: %s", query_params
+        )
+        
+        return url, query_params
+
+    def transform_list_skills_response(
+        self,
+        raw_response: httpx.Response,
+        logging_obj: LiteLLMLoggingObj,
+    ) -> ListSkillsResponse:
+        """Transform Anthropic response to ListSkillsResponse"""
+        response_json = raw_response.json()
+        verbose_logger.debug(
+            "Transforming list skills response: %s", response_json
+        )
+        
+        return ListSkillsResponse(**response_json)
+
+    def transform_get_skill_request(
+        self,
+        skill_id: str,
+        api_base: str,
+        litellm_params: GenericLiteLLMParams,
+        headers: dict,
+    ) -> Tuple[str, Dict]:
+        """Transform get skill request for Anthropic"""
+        url = self.get_complete_url(
+            api_base=api_base, endpoint="skills", skill_id=skill_id
+        )
+        
+        verbose_logger.debug("Get skill request - URL: %s", url)
+        
+        return url, headers
+
+    def transform_get_skill_response(
+        self,
+        raw_response: httpx.Response,
+        logging_obj: LiteLLMLoggingObj,
+    ) -> Skill:
+        """Transform Anthropic response to Skill object"""
+        response_json = raw_response.json()
+        verbose_logger.debug(
+            "Transforming get skill response: %s", response_json
+        )
+        
+        return Skill(**response_json)
+
+    def transform_delete_skill_request(
+        self,
+        skill_id: str,
+        api_base: str,
+        litellm_params: GenericLiteLLMParams,
+        headers: dict,
+    ) -> Tuple[str, Dict]:
+        """Transform delete skill request for Anthropic"""
+        url = self.get_complete_url(
+            api_base=api_base, endpoint="skills", skill_id=skill_id
+        )
+        
+        verbose_logger.debug("Delete skill request - URL: %s", url)
+        
+        return url, headers
+
+    def transform_delete_skill_response(
+        self,
+        raw_response: httpx.Response,
+        logging_obj: LiteLLMLoggingObj,
+    ) -> DeleteSkillResponse:
+        """Transform Anthropic response to DeleteSkillResponse"""
+        response_json = raw_response.json()
+        verbose_logger.debug(
+            "Transforming delete skill response: %s", response_json
+        )
+        
+        return DeleteSkillResponse(**response_json)
+

litellm/llms/base_llm/skills/__init__.py

@@ -0,0 +1,6 @@
+"""Base Skills API configuration"""
+
+from .transformation import BaseSkillsAPIConfig
+
+__all__ = ["BaseSkillsAPIConfig"]
+