---
title: "Create agent skill"
method: POST
path: "/agent_skills"
tags: ["agent_skills"]
---

# Create agent skill

`POST /agent_skills`

Upload a zip file containing agent skill. The zip file must contain a SKILL.md file (case-insensitive) with YAML format containing 'name' and 'description' fields. The name and description will be extracted from SKILL.md. Files are stored as Disk Artifacts. Optionally associate with a user identifier.

## Response `201`

Returns agent skill with name and description extracted from SKILL.md

- object
  - `code` integer
  - `error` string
  - `msg` string
  - `data` ModelAgentSkills
    - `created_at` string
    - `description` string
    - `disk_id` string — DiskID references the Disk that stores this skill's files as Artifacts
    - `file_index` ModelFileInfo[] — FileIndex is computed at query time from the Disk's Artifacts, not persisted
      - `mime` string — MIME type of the file
      - `path` string — Relative path from skillName root
    - `id` string
    - `meta` object
    - `name` string — Name is not unique - multiple skills can have the same name
    - `updated_at` string
    - `user_id` string

## Changes

> 50 revisions in range; 1 could not be searched.

- **2025-12-30** `69c8b7c21807` — 1 info
  - endpoint added
- **2025-11-12** `a1c1bcb0e2ee` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/memodb-io/apis/acontext-api/changes/agent_skills/post.md)

---

[API](https://skmtc.dev/memodb-io/apis/acontext-api.md) · [All operations](https://skmtc.dev/memodb-io/apis/acontext-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/memodb-io/acontext-api/revisions/c8775333b1ed/schema)