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

# List skills

> List the skills of a space, ordered by most recently updated first. Results are paginated via the `limit` and `offset` query parameters; the response wraps the skills in `data` alongside `total`, `limit`, `offset`, and `hasMore`. Only user-created skills are returned; built-in nuwacom skills are not exposed through this API. Use [Get a skill](/api-reference/skills/get-a-skill) to also read the skill's `instructions`.



## OpenAPI

````yaml /openapi.yaml get /api/v1/spaces/{spaceId}/skills
openapi: 3.1.0
info:
  title: Nuwacom API
  description: API for Nuwacom application
  version: 1.0.0
servers:
  - url: https://{customer-tenant}.nuwacom.ai
    description: Nuwacom API
security:
  - bearerAuth: []
paths:
  /api/v1/spaces/{spaceId}/skills:
    get:
      tags:
        - Skills
      summary: List skills
      description: >-
        List the skills of a space, ordered by most recently updated first.
        Results are paginated via the `limit` and `offset` query parameters; the
        response wraps the skills in `data` alongside `total`, `limit`,
        `offset`, and `hasMore`. Only user-created skills are returned; built-in
        nuwacom skills are not exposed through this API. Use [Get a
        skill](/api-reference/skills/get-a-skill) to also read the skill's
        `instructions`.
      operationId: getApiV1SpacesBySpaceIdSkills
      parameters:
        - in: path
          name: spaceId
          schema:
            anyOf:
              - type: string
                minLength: 2
                maxLength: 6
              - type: string
                minLength: 21
                maxLength: 21
            description: ID of the space the skills belong to.
          required: true
        - in: query
          name: limit
          schema:
            anyOf:
              - type: string
              - type: number
            type: integer
            minimum: 1
            maximum: 100
            description: Maximum number of skills to return (1–100). Defaults to 50.
            default: 50
          required: false
        - in: query
          name: offset
          schema:
            anyOf:
              - type: string
              - type: number
            type: integer
            minimum: 0
            description: >-
              Number of skills to skip from the start of the list. Defaults to
              0.
            default: 0
          required: false
      responses:
        '200':
          description: Skills returned successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: >-
                            Unique ID of the skill. Use it to attach the skill
                            to agents.
                        spaceId:
                          anyOf:
                            - type: string
                              minLength: 2
                              maxLength: 6
                            - type: string
                              minLength: 21
                              maxLength: 21
                          description: ID of the space the skill belongs to.
                        name:
                          type: string
                        description:
                          type: string
                        slug:
                          type: string
                          description: >-
                            URL-safe, immutable identifier generated from the
                            initial name.
                        source:
                          enum:
                            - manual
                            - upload
                            - github
                            - ai_generated
                          description: >-
                            How the skill was created. Skills created via this
                            API have source "manual".
                        sourceUrl:
                          anyOf:
                            - type: string
                              nullable: true
                          description: >-
                            Source URL for skills imported from GitHub, null
                            otherwise.
                        createdAt:
                          type: string
                        updatedAt:
                          type: string
                      required:
                        - id
                        - spaceId
                        - name
                        - description
                        - slug
                        - source
                        - sourceUrl
                        - createdAt
                        - updatedAt
                    description: >-
                      The skills on this page, ordered by most recently updated
                      first.
                  total:
                    type: number
                    description: Total number of skills in the space visible to the caller.
                  limit:
                    type: number
                    description: The page size that was applied.
                  offset:
                    type: number
                    description: The offset that was applied.
                  hasMore:
                    type: boolean
                    description: >-
                      Whether more skills exist beyond this page (`offset +
                      limit < total`).
                required:
                  - data
                  - total
                  - limit
                  - offset
                  - hasMore
        '403':
          description: >-
            The caller lacks permission to view skills in this space, or the
            skills feature is disabled.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````