# HTTP: skills

Arc agent documentation

All 5 skills endpoints, with request fields and access notes.

[HTTP directory](/arc/docs/reference/http) · [Transport guide](/arc/docs/guides/http)

Request fields and access notes below are partial. Additional constraints and permissions may apply. Prefer the corresponding MCP tool and schema where available.

## GET /v1/skills

List skills.

Query field names (types and requiredness not specified here): `include_archived`, `include_body`, `include_manual`, `project_id`.

## POST /v1/skills

Create skill.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

### Request body fields (partial)

| Field | Type | Required | Constraints |
| --- | --- | --- | --- |
| `project_id` | string | yes | See operation notes. |
| `name` | string | yes | See operation notes. |
| `slug` | string | no | See operation notes. |
| `summary` | string | no | See operation notes. |
| `activation` | string | no | See operation notes. |
| `tags` | array | no | See operation notes. |
| `delivery` | string | no | See operation notes. |
| `replacement_skill_id` | string | no | See operation notes. |
| `last_reviewed_at` | string | no | See operation notes. |
| `metadata` | object | no | See operation notes. |

Other constraints may apply, including for fields marked optional.

Additional body field names (types and requiredness not specified here): `body`.

## DELETE /v1/skills/{id}

Delete skill.

Path parameters: `id`.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.

## GET /v1/skills/{id}

Get skill.

Path parameters: `id`.

Query field names (types and requiredness not specified here): `locale`, `session_id`.

## PATCH /v1/skills/{id}

Patch skill.

Path parameters: `id`.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

### Request body fields (partial)

| Field | Type | Required | Constraints |
| --- | --- | --- | --- |
| `name` | string | no | See operation notes. |
| `slug` | string | no | See operation notes. |
| `summary` | string | no | See operation notes. |
| `activation` | string | no | See operation notes. |
| `tags` | array | no | See operation notes. |
| `delivery` | string | no | See operation notes. |
| `archived` | boolean | no | See operation notes. |
| `replacement_skill_id` | string | no | See operation notes. |
| `last_reviewed_at` | string | no | See operation notes. |
| `metadata` | object | no | See operation notes. |

Other constraints may apply, including for fields marked optional.

Additional body field names (types and requiredness not specified here): `body`.