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

# List Skills From Bound Repo

> Returns skills, agents, commands, prompts, and rule files committed to the repository (or repository set) the environment is bound to. Resolved live from the repo's default branch via GitHub. Read-only: these are sourced from the user's git tree, not from `skills.sh`. When the environment is not bound to a repo, returns an empty list with no error.



## OpenAPI

````yaml /openapi.json get /v1/environments/{environmentId}/repo-skills
openapi: 3.1.0
info:
  title: Replica API
  version: 2.0.0
  description: >-
    The Replica API allows you to programmatically manage cloud workspaces for
    AI agents. Use this API to manage environments (the org-scoped primitive
    workspaces are created from — including variables, files, skills, MCPs, warm
    hooks, start hooks, and warm pools), create and manage replicas, send
    messages, manage chats, stream events, read connected repositories and
    repository sets, and configure automations.
servers:
  - url: https://api.tryreplicas.com
    description: Production API
security:
  - apiKey: []
tags:
  - name: Environments
    description: >-
      Manage environments — the primitive that workspaces are created from.
      Variables, files, skills, MCPs, warm-hooks, and warm-pools are all scoped
      to an environment. Every organization has a singleton Global environment
      whose values apply to every workspace. Personal environments are scoped to
      the authenticated user and can be standalone or source-backed by a team
      environment.
  - name: Repository
    description: >-
      Read repositories and repository sets connected to your organization.
      Repositories are the underlying GitHub-connection layer; bind them to an
      environment to use them in workspaces.
  - name: Replica
    description: Manage replicas (workspaces) for AI agents
  - name: Terminal
    description: Manage interactive terminal sessions in active workspaces
  - name: Preview
    description: Manage public preview URLs for workspace ports
  - name: Profile
    description: Read and update the authenticated user's profile
  - name: Credentials
    description: >-
      Manage coding-agent credentials for an organization or the authenticated
      user
  - name: Google Search Console
    description: >-
      Read Search Console properties, performance, sitemaps, and URL inspection
      results through a connected Google account
  - name: Slack
    description: Connect Slack identities and route threads to Replicas workspaces
  - name: Linear
    description: Connect Linear identities to Replicas accounts
  - name: Automation
    description: >-
      Create and manage automations that trigger replicas on a schedule or in
      response to events
  - name: Downloads
    description: Download Replicas applications
  - name: Media
    description: >-
      Read workspace media and obtain short-lived download or inline preview
      URLs
  - name: Analytics
    description: >-
      Read aggregated activity and usage metrics for your organization: compute
      minutes, workspaces created by source, and pull request throughput over a
      time range.
  - name: Presence
    description: >-
      Read and report ephemeral member presence: who is online, where they are
      (environment or workspace), and whether they are typing. Presence is
      backed by short-lived keys rather than the database and broadcast to other
      members over the events stream.
paths:
  /v1/environments/{environmentId}/repo-skills:
    get:
      tags:
        - Environments
      summary: List Skills From Bound Repo
      description: >-
        Returns skills, agents, commands, prompts, and rule files committed to
        the repository (or repository set) the environment is bound to. Resolved
        live from the repo's default branch via GitHub. Read-only: these are
        sourced from the user's git tree, not from `skills.sh`. When the
        environment is not bound to a repo, returns an empty list with no error.
      operationId: listRepoSkills
      parameters:
        - name: environmentId
          in: path
          required: true
          description: Environment UUID, or the literal string `global`.
          schema:
            type: string
      responses:
        '200':
          description: >-
            Successful response. `error` is populated when discovery encountered
            a partial failure (e.g. the repo has no GitHub App installation);
            the UI surfaces it inline rather than treating it as a 5xx.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListRepoSkillsResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ListRepoSkillsResponse:
      type: object
      properties:
        repo_skills:
          type: array
          items:
            $ref: '#/components/schemas/RepoSkill'
        error:
          type:
            - string
            - 'null'
          description: >-
            Populated when discovery couldn't run end-to-end (e.g. the bound
            repo has no GitHub App installation). The list may still be
            partially filled; the UI shows this as an inline banner rather than
            a 5xx.
      required:
        - repo_skills
        - error
    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
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        details:
          type:
            - string
            - 'null'
          description: Additional error details
      required:
        - error
    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'
    NotFound:
      description: Resource not found
      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: >-
        API key authentication. Obtain your API key from the Replicas dashboard
        under Organization → Settings → API Keys.

````