---
title: "Create Skill"
method: POST
path: "/v1/skills"
tags: ["anthropic_skills"]
---

# Create Skill

`POST /v1/skills`

Create a new skill on Anthropic.

Requires `?beta=true` query parameter.

Model-based routing (for multi-account support):
- Pass model via header: `x-litellm-model: claude-account-1`
- Pass model via query: `?model=claude-account-1`
- Pass model via form field: `model=claude-account-1`

Example usage:
```bash
# Basic usage
curl -X POST "http://localhost:4000/v1/skills?beta=true"       -H "Content-Type: multipart/form-data"       -H "Authorization: Bearer your-key"       -F "display_title=My Skill"       -F "files[]=@skill.zip"

# With model-based routing
curl -X POST "http://localhost:4000/v1/skills?beta=true"       -H "Content-Type: multipart/form-data"       -H "Authorization: Bearer your-key"       -H "x-litellm-model: claude-account-1"       -F "display_title=My Skill"       -F "files[]=@skill.zip"
```

Returns: Skill object with id, display_title, etc.

## Query parameters

- `custom_llm_provider` string, nullable

## Response `200`

Successful Response

- Skill — Represents a skill from the Anthropic Skills API
  - `created_at` string, required
  - `display_title` string, nullable
  - `id` string, required
  - `latest_version` string, nullable
  - `source` string, required
  - `type` string
  - `updated_at` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/flock/apis/litellm-api.md) · [All operations](https://skmtc.net/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flock/litellm-api/revisions/8fbaab4fc7c5/schema)