---
title: "POST /experimental/skills/improve"
method: POST
path: "/experimental/skills/improve"
tags: ["Skills"]
---

# POST /experimental/skills/improve

`POST /experimental/skills/improve`

Iteratively improves a SKILL.md via LLM passes guided by the review pipeline; returns the diff and revised content.

## Headers

- `Authorization` string

## Request body

- object
  - `content` string, required
  - `model` string — Model override to use for the improve passes instead of the default model
  - `max-iterations` integer — Maximum number of improve iterations (1-10, default 3)

## Response `200`

Default Response

- object
  - `originalContent` string, required
  - `improvedContent` string, required
  - `diff` string, required
  - `reviewSummary` string, required
  - `summaryOfChanges` string, required
  - `originalScore` integer, nullable, required
  - `finalScore` integer, nullable, required
  - `iterations` integer, required
  - `credits` number, required — Credits charged for this improvement (0 if nothing was billed).

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

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