> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/skills/list-skills.md).

# List Skills

List the available Parvenu skill playbooks.

## List Skills

<mark style="color:blue;">`GET`</mark> `/parvenu_skills_list`

{% hint style="info" %}
Free — no credits are used. No parameters required.
{% endhint %}

Returns the available Parvenu skills — step-by-step playbooks describing which APIs to call and in what order. Pass an `id` to View Skill to read the full page.

**Response**

| Field in each row | Type   | Description                        |
| ----------------- | ------ | ---------------------------------- |
| `id`              | string | Skill id. Pass this to View Skill. |
| `title`           | string | Skill name.                        |
| `description`     | string | One line on what the skill covers. |

The skills are under `data`, and `total` is how many there are. See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

**Example**

{% tabs %}
{% tab title="Input" %}

```
GET https://api.parvenu.io/parvenu_skills_list
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": [
    {
      "id": "390d3d61-badd-81bc-9896-d4390e8bd50a",
      "title": "Onboarding",
      "description": "Guide a brand-new user through their first Parvenu session — frame what Parvenu does and run a tiny live demo."
    },
    {
      "id": "390d3d61-badd-813b-9627-c8ae08764db2",
      "title": "AI Personalization",
      "description": "Raw AI text generation via /personalize_with_ai (0.5 cr/call)."
    },
    {
      "id": "390d3d61-badd-81e8-8f11-c3dc0ddcbd53",
      "title": "Deep Personalization",
      "description": "Turn a contact list into human-sounding cold email."
    }
  ],
  "total": 3,
  "credits_used": 0,
  "success": true
}
```

{% endtab %}
{% endtabs %}