$npx -y skills add replicas-group/skill --skill replicas-agentGuide for background coding agents running inside Replicas cloud workspaces
| 1 | # Replicas Agent |
| 2 | |
| 3 | You are a background coding agent running inside a Replicas cloud workspace (a remote VM). This skill covers capabilities and best practices specific to this environment. |
| 4 | |
| 5 | ## Capabilities |
| 6 | |
| 7 | This skill provides detailed guides for the following capabilities. **Read the relevant reference file before performing any of these actions.** |
| 8 | |
| 9 | ### Previews |
| 10 | Expose locally running services (web apps, APIs, databases) as public preview URLs so humans can interact with them directly. |
| 11 | |
| 12 | **Reference:** `references/PREVIEWS.md` |
| 13 | |
| 14 | Use this when: |
| 15 | - You need to start a service that a human should view or interact with |
| 16 | - The task involves UI work that benefits from human review |
| 17 | - You are verifying frontend/backend integrations visually |
| 18 | |
| 19 | ### Slack |
| 20 | Send messages, read threads, search conversations, and upload files via the Slack Web API. |
| 21 | |
| 22 | **Reference:** `references/SLACK.md` |
| 23 | |
| 24 | Use this when: |
| 25 | - You need to send a message to a Slack channel or thread |
| 26 | - You need to read or fetch a Slack conversation |
| 27 | - You encounter a Slack message link and need to retrieve its content |
| 28 | - The task asks you to notify, update, or communicate via Slack |
| 29 | |
| 30 | ### Linear |
| 31 | Fetch issues, update state, add comments, and search via the Linear GraphQL API. |
| 32 | |
| 33 | **Reference:** `references/LINEAR.md` |
| 34 | |
| 35 | Use this when: |
| 36 | - You encounter a Linear issue link and need to understand the task |
| 37 | - You need to update an issue's state (e.g. mark as done) |
| 38 | - You need to comment on or search for Linear issues |
| 39 | |
| 40 | ### GitHub |
| 41 | Use the pre-authenticated `gh` CLI for pull requests, issues, actions, and API calls. |
| 42 | |
| 43 | **Reference:** `references/GITHUB.md` |
| 44 | |
| 45 | Use this when: |
| 46 | - You need to create, review, or manage pull requests |
| 47 | - You need to interact with GitHub issues or actions |
| 48 | - You need to use the GitHub API for advanced operations |
| 49 | - You need to include images in PR descriptions |
| 50 | |
| 51 | ### Google Workspace (Docs, Sheets, Forms, Drive) |
| 52 | Create and edit Google Docs, Sheets, and Forms via the Replicas gateway. Files are owned by Replicas — the integration cannot access pre-existing Google content created outside of it. |
| 53 | |
| 54 | **Reference:** `references/GOOGLE.md` |
| 55 | |
| 56 | Use this when: |
| 57 | - You need to create or edit a Google Doc, Sheet, or Form |
| 58 | - You need to share, rename, move, or delete a Replicas-created Google file |
| 59 | - You need to read responses from a Replicas-created Google Form |
| 60 | |
| 61 | ### Docker |
| 62 | Start and use the Docker daemon in Replicas workspaces. Docker is pre-installed but the daemon does not auto-start. |
| 63 | |
| 64 | **Reference:** `references/DOCKER.md` |
| 65 | |
| 66 | Use this when: |
| 67 | - You need to run `docker` or `docker compose` commands |
| 68 | - You need to build or run Docker containers |
| 69 | - Your task involves containerized services or Docker-based workflows |
| 70 | |
| 71 | ### Media |
| 72 | Share screenshots, screen recordings, generated diagrams, and audio clips inline in the Replicas chat (and as references in external messages). |
| 73 | |
| 74 | **Reference:** `references/MEDIA.md` |
| 75 | |
| 76 | Use this when: |
| 77 | - You produce a screenshot, recording, generated image, or audio clip the user should see |
| 78 | - You record video output (browser automation, screen capture) — including the recommended aspect ratio and FPS |
| 79 | - You need to embed media in a Slack/Linear/GitHub message AND keep a referenceable copy in the Replicas dashboard |
| 80 | |
| 81 | ### Replicas (in-workspace CLI) |
| 82 | Take action *with* Replicas itself — manage automations, environments (variables, files), repos, and `replicas.json` config — using the pre-installed, pre-authenticated `replicas` CLI. |
| 83 | |
| 84 | **Reference:** `references/REPLICAS.md` |
| 85 | |
| 86 | Use this when: |
| 87 | - The user asks you to create, edit, run, or delete an automation |
| 88 | - The user asks you to manage environments, environment variables, or environment files |
| 89 | - The user asks "what envs / repos / automations do I have?" |
| 90 | - The user asks you to scaffold a `replicas.json` / `replicas.yaml` in a repo |
| 91 | |
| 92 | For *questions about how Replicas works* (concepts, pricing, what a feature does), check https://docs.replicas.dev first and only fall back to this skill when the user is asking you to take an action. |