SkillResponseDtoPaginatedResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/flowra-dev/json-schema/flowra-dev-skill-response-dto-paginated-response-schema.json",
  "title": "SkillResponseDtoPaginatedResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/flowra-dev-skills-api-openapi.yml#/components/schemas/SkillResponseDtoPaginatedResponse",
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Success status"
    },
    "message": {
      "type": "string",
      "description": "Response message"
    },
    "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",
              "null"
            ]
          },
          "tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "source": {
            "type": "string",
            "enum": [
              "custom",
              "registry",
              "platform"
            ]
          },
          "registryMeta": {
            "type": [
              "object",
              "null"
            ]
          },
          "presets": {
            "type": [
              "object",
              "null"
            ]
          },
          "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"
        ]
      }
    },
    "total": {
      "type": "number",
      "description": "Total number of items across all pages"
    },
    "totalTools": {
      "type": "number",
      "description": "Optional secondary total (e.g. nested tools across all matching toolkits)"
    },
    "page": {
      "type": "number",
      "description": "Current page number (1-based)"
    },
    "limit": {
      "type": "number",
      "description": "Number of items per page"
    },
    "totalPages": {
      "type": "number",
      "description": "Total number of pages"
    },
    "hasNextPage": {
      "type": "boolean",
      "description": "Whether there is a next page"
    },
    "hasPreviousPage": {
      "type": "boolean",
      "description": "Whether there is a previous page"
    }
  },
  "required": [
    "success",
    "message",
    "data",
    "total"
  ]
}