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

# Get categorized skill set for a manifest

> Used by the Credible VS Code extension; not part of the external integration surface. Returns the skills referenced by a manifest in the agent-skills repo, categorized into auto_discovered and supporting groups. If version is omitted, the server resolves it via a Flagsmith flag (`agent_skills_version_<manifest_slug>`) and falls back to the latest repo tag.



## OpenAPI

````yaml /code-assist-public-api.yaml get /agent_skills
openapi: 3.0.0
info:
  title: Coding API
  description: >-
    Public API for Credible's Code Assist service. Its externally-facing
    capability is a Malloy documentation search (`POST /search_malloy_docs`)
    that any authenticated caller — including a customer's own MCP server — can
    invoke directly with a Group Access Token. The remaining endpoints back the
    Credible VS Code extension and are not part of the external integration
    surface.
  version: 1.0.0
servers:
  - url: https://{organization}.coding.credibledata.com
    description: Production API server
    variables:
      organization:
        default: demo
        description: Your organization subdomain
security:
  - bearerAuth: []
  - apiKeyAuth: []
tags:
  - name: codeAssist
    description: Code Assist API endpoints
paths:
  /agent_skills:
    get:
      tags:
        - codeAssist
      summary: Get categorized skill set for a manifest
      description: >-
        Used by the Credible VS Code extension; not part of the external
        integration surface. Returns the skills referenced by a manifest in the
        agent-skills repo, categorized into auto_discovered and supporting
        groups. If version is omitted, the server resolves it via a Flagsmith
        flag (`agent_skills_version_<manifest_slug>`) and falls back to the
        latest repo tag.
      operationId: getAgentSkills
      parameters:
        - name: manifest
          in: query
          required: true
          description: Manifest name (e.g. "modeling-agent").
          schema:
            type: string
        - name: version
          in: query
          required: false
          description: Version tag. If omitted, server resolves it via Flagsmith or latest.
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSkillsResponse'
        '400':
          description: >-
            The request was malformed or can not be performed given the state of
            the system.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: The specified resource was not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: An internal server error occurred.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    AgentSkillsResponse:
      type: object
      required:
        - manifest
        - version
        - auto_discovered
        - supporting
      properties:
        manifest:
          type: string
          description: Manifest name that was requested
        version:
          type: string
          description: Resolved version tag served
        description:
          type: string
          description: Human-readable description from the manifest
        trigger_hint:
          type: string
          description: Trigger hint from the manifest for rule-file generation
        auto_discovered:
          type: array
          items:
            $ref: '#/components/schemas/AgentSkill'
          description: Skills intended for auto-discovered placement (e.g. .claude/skills/)
        supporting:
          type: array
          items:
            $ref: '#/components/schemas/AgentSkill'
          description: Skills intended for on-demand placement (e.g. .credible/skills/)
    ErrorResponse:
      description: Standard error response body.
      type: object
      required:
        - error_code
        - message
      properties:
        error_code:
          type: string
          description: A code identifying the type of error
          enum:
            - INVALID_INPUT
            - UNAUTHORIZED
            - FORBIDDEN
            - NOT_FOUND
            - CONFLICT
            - INTERNAL_ERROR
            - BAD_GATEWAY
            - GATEWAY_TIMEOUT
        message:
          type: string
          description: A human-readable error message
        details:
          type: string
          description: Additional error details, if available
          nullable: true
    AgentSkill:
      type: object
      required:
        - name
        - files
      properties:
        name:
          type: string
          description: Skill name (folder name under skills/)
        files:
          type: array
          items:
            $ref: '#/components/schemas/SkillFile'
          description: Files belonging to the skill
    SkillFile:
      type: object
      required:
        - relative_filepath
        - file_contents
      properties:
        relative_filepath:
          type: string
          description: Relative path of the file within the skill folder
        file_contents:
          type: string
          description: Contents of the file
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |
        Auth0-issued user JWT. Provide as `Authorization: Bearer <token>`.
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: |
        HMAC-signed API key JWT (Group Access Token) issued by Credible. Provide
        as `Authorization: ApiKey <token>` (note the `ApiKey ` prefix in place
        of the usual `Bearer `). Include the full string — prefix and token —
        in this field.

````