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

# List My Skills

> Skills the current user created or installed (skill_users membership).



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/skills/list
openapi: 3.0.0
info:
  title: Flowra API (API Key Endpoints)
  description: >-
    **Flowra** is an AI-powered platform for building agents, workflows, and
    integrations.


    ### Capabilities

    - **Tools & Toolkits** – Define and group tools for agents and workflows.

    - **Workflows** – Orchestrate steps and automate processes.

    - **Triggers** – Schedule or event-based execution.

    - **Auth & Connections** – OAuth, API keys, and connected accounts.

    - **MCP** – Model Context Protocol server integration.

    - **Knowledge / RAG** – Add files and URLs for retrieval-augmented
    generation.


    ### Authentication

    Use the **x-api-key** header with a project API key to access endpoints that
    support API Key auth. Create and manage API keys in the dashboard under your
    project settings.


    Only endpoints that support API Key authentication via the @ApiKeyEnabled()
    decorator.


    Send x-api-key (required). On multi-tenant endpoints, optionally send
    x-username to act as an external user.
  version: '1.0'
  contact:
    name: Flowra
    url: https://flowra.dev
servers:
  - url: https://flowra.dev
    description: Flowra API
security: []
tags:
  - name: Users
    description: User profile
  - name: External Users
    description: End-user identities inside a project (x-username)
  - name: Auth Configs
    description: OAuth and API key configs for toolkits
  - name: Connected Accounts
    description: OAuth connected accounts and link creation
  - name: Toolkits
    description: List and search toolkits
  - name: Tools
    description: List, execute, and manage tools
  - name: Skills
    description: Browse, create, import, and install skills
  - name: Workflow & Agent
    description: Create, run, and inspect workflows and agents
  - name: Triggers
    description: Schedule and event-based trigger instances
  - name: Chat
    description: Threads and streaming agent runs
  - name: File
    description: Upload, list, and download files
  - name: Knowledge
    description: RAG knowledge collections
  - name: Table
    description: Collections and documents
  - name: Sandbox
    description: Ephemeral and durable code sandboxes
  - name: Browser
    description: Live browser sessions and view
  - name: LLM
    description: List AI models and generate completions
  - name: MCP
    description: MCP server management
  - name: usage
    description: Credit balance and usage ledger for the project API key
paths:
  /api/v1/skills/list:
    get:
      tags:
        - Skills
      summary: List My Skills
      description: Skills the current user created or installed (skill_users membership).
      operationId: SkillsController_list
      parameters:
        - name: q
          required: false
          in: query
          description: Case-insensitive search over name, slug, and description
          schema:
            example: invoice
            type: string
        - name: source
          required: false
          in: query
          description: >-
            Filter by origin: user-created, installed from registry, or platform
            catalog
          schema:
            example: custom
            enum:
              - custom
              - registry
              - platform
            type: string
        - name: category
          required: false
          in: query
          description: Filter by category
          schema:
            example: finance
            type: string
        - name: page
          required: false
          in: query
          description: Page number (1-based)
          schema:
            default: 1
            example: 1
            type: number
        - name: limit
          required: false
          in: query
          description: Page size
          schema:
            default: 20
            example: 20
            type: number
      responses:
        '200':
          description: Operation completed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SkillResponseDtoPaginatedResponse'
              example:
                success: true
                message: Data retrieved successfully
                data:
                  - id: ''
                    slug: ''
                    name: ''
                    description: ''
                    instructions: ''
                    category: ''
                    tags:
                      - ''
                    source: custom
                    registryMeta: {}
                    presets: {}
                    isPublic: true
                    version: ''
                    activeStatus: true
                    files:
                      - path: ''
                        sizeBytes: 0
                        contentType: ''
                    packageFileCount: 0
                    sourceUrl: ''
                    skillsShUrl: ''
                    isCreator: true
                    installCount: 0
                    changed: true
                total: 100
                totalTools: 5000
                page: 1
                limit: 20
                totalPages: 5
                hasNextPage: true
                hasPreviousPage: false
      security:
        - x-api-key: []
components:
  schemas:
    SkillResponseDtoPaginatedResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Success status
          example: true
        message:
          type: string
          description: Response message
          example: Data retrieved successfully
        data:
          description: Array of items
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              slug:
                type: string
              name:
                type: string
              description:
                type: string
              instructions:
                type: string
              category:
                type: string
                nullable: true
              tags:
                nullable: true
                type: array
                items:
                  type: string
              source:
                type: string
                enum:
                  - custom
                  - registry
                  - platform
              registryMeta:
                type: object
                nullable: true
              presets:
                type: object
                nullable: true
              isPublic:
                type: boolean
              version:
                type: string
              activeStatus:
                type: boolean
              files:
                type: array
                items:
                  type: object
                  properties:
                    path:
                      type: string
                      description: Path relative to skill root, e.g. scripts/run.py
                    sizeBytes:
                      type: number
                    contentType:
                      type: string
                  required:
                    - path
                    - sizeBytes
                    - contentType
              packageFileCount:
                type: number
                description: >-
                  Companion package file count (excludes SKILL.md, which lives
                  on the skill row).
              sourceUrl:
                type: string
              skillsShUrl:
                type: string
              isCreator:
                type: boolean
                description: True when the current user authored this skill.
              installCount:
                type: number
                description: Total memberships (installs) across all users.
              changed:
                type: boolean
                description: True when a registry sync overwrote the shared catalog copy.
            required:
              - id
              - slug
              - name
              - description
              - instructions
              - source
              - isPublic
              - version
          example:
            - id: ''
              slug: ''
              name: ''
              description: ''
              instructions: ''
              category: ''
              tags:
                - ''
              source: custom
              registryMeta: {}
              presets: {}
              isPublic: true
              version: ''
              activeStatus: true
              files:
                - path: ''
                  sizeBytes: 0
                  contentType: ''
              packageFileCount: 0
              sourceUrl: ''
              skillsShUrl: ''
              isCreator: true
              installCount: 0
              changed: true
        total:
          type: number
          description: Total number of items across all pages
          example: 100
        totalTools:
          type: number
          description: >-
            Optional secondary total (e.g. nested tools across all matching
            toolkits)
          example: 5000
        page:
          type: number
          description: Current page number (1-based)
          example: 1
        limit:
          type: number
          description: Number of items per page
          example: 20
        totalPages:
          type: number
          description: Total number of pages
          example: 5
        hasNextPage:
          type: boolean
          description: Whether there is a next page
          example: true
        hasPreviousPage:
          type: boolean
          description: Whether there is a previous page
          example: false
      required:
        - success
        - message
        - data
        - total
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Project API key. Create and manage keys in the dashboard under Project →
        API Keys. Send as header: x-api-key: <your-key>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.