> ## Documentation Index
> Fetch the complete documentation index at: https://docs.biomni.phylo.bio/llms.txt
> Use this file to discover all available pages before exploring further.

# List skills

> List the reusable Skills you can attach to a Task.

A **Skill** is a reusable capability from the Biomni catalog — a packaged
workflow (a grounded literature review, a genome-editing design routine, …) the
agent loads when you attach it. This lists both built-in skills and your own.

Each entry's `id` (or `name`) is what you pass as `skill` on `POST /messages` to
run it; `owner_type` is `system` (built-in) or `user` (yours). Use this endpoint
to discover the id, then start a Task that explicitly runs the skill.


## OpenAPI

````yaml api-reference/openapi.json GET /skills
openapi: 3.1.0
info:
  title: Biomni Public API — V0
  description: >-
    The public API for **Biomni** — the AI agent platform for clinical genomics
    (variant annotation, ClinVar lookups, PMID-cited literature, and project
    file drives). Create projects and Tasks, send messages to the agent, stream
    its replies, manage files, and check your usage — all from your own code.


    **Authentication**: send `Authorization: Bearer <your-api-key>`. The adapter
    forwards your key straight to Biomni; it never stores it.


    **Safe retries**: send `Idempotency-Key: <token>` on POST endpoints
    (`/projects`, `/tasks`, `/messages`, `/files/uploads`) so a retried request
    won't create a duplicate.
  version: 0.1.0
servers:
  - url: https://api.phylo.bio/api/v1
security: []
paths:
  /skills:
    get:
      tags:
        - skills
      summary: List skills
      description: List the reusable Skills you can attach to a Task.
      operationId: list_skills_skills_get
      responses:
        '200':
          description: The skills available to the caller.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SkillList'
              example:
                object: list
                data:
                  - id: literature-deep-review
                    object: skill
                    name: literature-deep-review
                    description: Grounded evidence review over the literature.
                    category: literature
                    owner_type: system
      security:
        - bearerAuth: []
components:
  schemas:
    SkillList:
      properties:
        object:
          type: string
          const: list
          title: Object
          default: list
        data:
          items:
            $ref: '#/components/schemas/Skill'
          type: array
          title: Data
      type: object
      required:
        - data
      title: SkillList
    Skill:
      properties:
        id:
          type: string
          title: Id
          description: Skill id — pass this as `skill` when starting a task.
        object:
          type: string
          const: skill
          title: Object
          default: skill
        name:
          type: string
          title: Name
          description: Display name; also accepted as `skill` when starting a task.
        description:
          type: string
          title: Description
          default: ''
        category:
          type: string
          title: Category
          default: ''
        owner_type:
          type: string
          title: Owner Type
          description: >-
            Where the skill comes from: 'system' (built-in) or 'user' (your
            own).
          default: system
      type: object
      required:
        - id
        - name
      title: Skill
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Requires an API key. See the Authentication guide.

````