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

# List skill registries

> Lists GitHub repositories used as skill registries, with the skills found in each.



## OpenAPI

````yaml /openapi.json get /v1/environments/{environment_id}/skills-registries
openapi: 3.1.0
info:
  title: Replicas API
  version: 2.0.0
  description: >-
    Create and control workspaces, and manage the environments, automations, and
    learnings they run with.
servers:
  - url: https://api.replicas.dev
    description: Production API
security:
  - apiKey: []
tags:
  - name: Replica
    description: >-
      A replica is a Replicas workspace: a cloud sandbox where a coding agent
      works on your repositories.
  - name: Chats
    description: Manage the agent chats inside a replica.
  - name: Message queue
    description: Messages waiting for the agent to finish its turn.
  - name: Commands and terminals
    description: Run commands and open shells in a replica.
  - name: Pull requests
    description: Inspect and act on pull requests a replica opened.
  - name: Previews
    description: Public URLs for ports in a replica.
  - name: Canvas
    description: Plans, reports, and other files agents produce.
  - name: Sharing
    description: Add replicas to members' Shared view.
  - name: Environments
    description: >-
      Environments define what a workspace starts with. The `global` environment
      applies to every workspace.
  - name: Environment variables
    description: Variables injected into workspaces.
  - name: Environment files
    description: Files written into workspaces.
  - name: Environment skills
    description: Agent skills installed into workspaces.
  - name: Environment MCPs
    description: MCP servers available to workspace agents.
  - name: Hooks
    description: Scripts that run when warm pool snapshots build and when workspaces start.
  - name: Warm pools
    description: Pre-built workspaces that start faster.
  - name: Automations
    description: Run agents on schedules and events.
  - name: Repositories
    description: Repositories and repository sets connected to the organization.
  - name: Learnings
    description: Organization skills every workspace agent loads.
  - name: Agent credentials
    description: >-
      API keys and endpoints that coding agents use. Connect Claude, Codex, and
      Muse subscriptions with the CLI.
  - name: Plugins
    description: Connect integrations that workspace agents can use.
  - name: Organization
    description: Who you are and who is in your organization.
  - name: Media
    description: Screenshots, recordings, and other files workspaces produce.
  - name: Slack
    description: Route Slack threads to workspaces.
  - name: Workspace identity
    description: OIDC keys for verifying workspace identity tokens.
paths:
  /v1/environments/{environment_id}/skills-registries:
    get:
      tags:
        - Environment skills
      summary: List skill registries
      description: >-
        Lists GitHub repositories used as skill registries, with the skills
        found in each.
      operationId: listEnvironmentSkillsRegistries
      parameters:
        - name: environment_id
          in: path
          required: true
          description: Environment UUID, or the literal string `global`.
          schema:
            type: string
        - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListEnvironmentSkillsRegistriesResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    ApiVersion:
      name: X-Replicas-Api-Version
      in: header
      description: >-
        API version. `2026-10-07` returns `snake_case` responses. See
        [versioning](/features/api#versioning).
      required: false
      schema:
        type: string
        enum:
          - '2026-10-07'
  schemas:
    ListEnvironmentSkillsRegistriesResponse:
      type: object
      properties:
        registries:
          type: array
          items:
            $ref: '#/components/schemas/EnvironmentSkillsRegistryWithContents'
      required:
        - registries
    EnvironmentSkillsRegistryWithContents:
      type: object
      description: A skill registry with its discovered skills.
      allOf:
        - $ref: '#/components/schemas/EnvironmentSkillsRegistry'
        - type: object
          properties:
            repo_skills:
              type: array
              items:
                $ref: '#/components/schemas/RepoSkill'
            error:
              type:
                - string
                - 'null'
          required:
            - repo_skills
            - error
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        details:
          type:
            - string
            - 'null'
          description: Additional error details
        code:
          type: string
          description: Machine-readable error code when available
      required:
        - error
    EnvironmentSkillsRegistry:
      type: object
      description: A GitHub repository registered as a skill registry on an environment.
      properties:
        id:
          type: string
          format: uuid
        organization_id:
          type: string
          format: uuid
        environment_id:
          type: string
          format: uuid
        name:
          type: string
        url:
          type: string
          format: uri
        repository_full_name:
          type: string
        default_branch:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - organization_id
        - environment_id
        - name
        - url
        - repository_full_name
        - default_branch
        - created_at
        - updated_at
    RepoSkill:
      type: object
      description: >-
        A skill/agent/command/prompt file discovered inside the environment's
        bound repo. Distinct from `EnvironmentSkill`: these are inferred live
        from the repo's git tree, are read-only, and have no DB row.
      properties:
        id:
          type: string
          description: Stable id, formed from the repository UUID and the in-repo path.
        repository_id:
          type: string
          format: uuid
        repository_full_name:
          type: string
          description: Repo's `owner/name` (denormalized for the UI).
        branch:
          type: string
          description: Default branch the file was resolved against.
        path:
          type: string
          description: Repo-relative path of the discovered file or skill directory.
        name:
          type: string
          description: >-
            Human-friendly name (from YAML frontmatter when present, otherwise
            the filename or directory).
        description:
          type:
            - string
            - 'null'
          description: Single-line description, populated from frontmatter when available.
        framework:
          $ref: '#/components/schemas/RepoSkillFramework'
        kind:
          type: string
          description: Sub-kind within the framework.
          enum:
            - skill
            - agent
            - command
            - prompt
            - plugin
        html_url:
          type: string
          format: uri
          description: Direct GitHub blob link.
      required:
        - id
        - repository_id
        - repository_full_name
        - branch
        - path
        - name
        - description
        - framework
        - kind
        - html_url
    RepoSkillFramework:
      type: string
      description: Which AI tool owns the discovered file's on-disk convention.
      enum:
        - claude
        - codex
        - cursor
        - agents
  responses:
    BadRequest:
      description: Bad request - Missing or invalid parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Unauthorized - Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Organization or personal API key from **Settings → API Keys**.

````

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