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

# Obtener skill

> Obtiene un único skill por su slug. De forma predeterminada, devuelve la última versión aprobada cuando existe. Se puede solicitar una versión concreta con el parámetro de consulta version. El contenido de la versión solo se incluye cuando la versión seleccionada está aprobada.



## OpenAPI

````yaml /es/api-reference/openapi.json get /skills/{slug}
openapi: 3.0.0
info:
  title: API de Corgea
  version: 1.0.0
  description: >-
    API para interactuar con las funciones de escaneo y gestión de
    vulnerabilidades de Corgea
servers:
  - url: https://www.corgea.app/api/v1
    description: Servidor de producción
security:
  - CorgeaToken: []
  - BearerAuth: []
paths:
  /skills/{slug}:
    get:
      tags:
        - Skills
      summary: Obtener skill
      description: >-
        Obtiene un único skill por su slug. De forma predeterminada, devuelve la
        última versión aprobada cuando existe. Se puede solicitar una versión
        concreta con el parámetro de consulta version. El contenido de la
        versión solo se incluye cuando la versión seleccionada está aprobada.
      operationId: getSkill
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
          description: Slug del skill
        - name: version
          in: query
          required: false
          schema:
            type: string
          description: Versión concreta del skill que se debe obtener
      responses:
        '200':
          description: Skill obtenido correctamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
                  skill:
                    $ref: '#/components/schemas/Skill'
                  version:
                    nullable: true
                    allOf:
                      - $ref: '#/components/schemas/SkillVersion'
              examples:
                approved:
                  summary: Approved skill version
                  value:
                    status: ok
                    skill:
                      id: 550e8400-e29b-41d4-a716-446655440000
                      name: secure-review
                      slug: secure-review
                      description: Review code for security issues.
                      status: approved
                      is_installable: true
                      latest_version: 1.0.0
                      latest_approved_version: 1.0.0
                      created_at: '2026-06-11T12:00:00+00:00'
                      updated_at: '2026-06-11T12:00:00+00:00'
                    version:
                      id: 8c23448e-f629-47c5-9f56-9f26f7ad3d01
                      version: 1.0.0
                      status: approved
                      is_installable: true
                      security_concerns: ''
                      created_at: '2026-06-11T12:00:00+00:00'
                      content: |-
                        ---
                        name: secure-review
                        description: Review code for security issues.
                        ---

                        # Instructions
                pending:
                  summary: Pending skill version
                  value:
                    status: ok
                    skill:
                      id: 550e8400-e29b-41d4-a716-446655440000
                      name: secure-review
                      slug: secure-review
                      description: Review code for security issues.
                      status: pending_review
                      is_installable: false
                      latest_version: 1.0.1
                      latest_approved_version: null
                      created_at: '2026-06-11T12:00:00+00:00'
                      updated_at: '2026-06-11T12:05:00+00:00'
                    version:
                      id: 8c23448e-f629-47c5-9f56-9f26f7ad3d01
                      version: 1.0.1
                      status: pending_review
                      is_installable: false
                      security_concerns: ''
                      created_at: '2026-06-11T12:05:00+00:00'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          description: Permiso denegado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Permission denied
        '404':
          description: Skill o versión no encontrados
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: not_found
                  error:
                    type: string
                    example: No skill named 'secure-review' found
components:
  schemas:
    Skill:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
          example: secure-review
        slug:
          type: string
          example: secure-review
        description:
          type: string
          example: Review code for security issues.
        status:
          type: string
          nullable: true
          enum:
            - pending_review
            - approved
            - rejected
            - failed
        is_installable:
          type: boolean
          description: Indica si el skill tiene una versión aprobada que se puede instalar
        latest_version:
          type: string
          nullable: true
          example: 1.0.1
        latest_approved_version:
          type: string
          nullable: true
          example: 1.0.0
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    SkillVersion:
      type: object
      properties:
        id:
          type: string
          format: uuid
        version:
          type: string
          example: 1.0.0
        status:
          type: string
          enum:
            - pending_review
            - approved
            - rejected
            - failed
        is_installable:
          type: boolean
        security_concerns:
          type: string
          description: Observación de la revisión cuando se rechaza una versión
        created_at:
          type: string
          format: date-time
        content:
          type: string
          description: >-
            Contenido de SKILL.md. Solo se incluye cuando la versión
            seleccionada está aprobada.
  responses:
    Unauthorized:
      description: Token no válido o ausente
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Missing or invalid authorization header
  securitySchemes:
    CorgeaToken:
      type: apiKey
      in: header
      name: CORGEA-TOKEN
      description: Clave de API para la autenticación
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token de acceso OAuth2 (JWT) en el encabezado Authorization

````