---
title: "Create a user skill"
method: POST
path: "/api/experimental/users/{user}/skills"
tags: ["Users"]
---

# Create a user skill

`POST /api/experimental/users/{user}/skills`

## Path parameters

- `user` string, required

## Request body

- CodersdkCreateUserSkillRequest
  - `content` string — Content must be SKILL.md-format Markdown with YAML frontmatter. The frontmatter must include name, may include description, and must be followed by a non-empty body.

## Response `201`

Created

- CodersdkUserSkill
  - `content` string
  - `created_at` string, date-time
  - `description` string
  - `id` string, uuid
  - `name` string
  - `updated_at` string, date-time

---

[API](https://skmtc.net/coder/apis/coder-api.md) · [All operations](https://skmtc.net/coder/apis/coder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coder/coder-api/versions/56b6e9f08540/schema)