# replicas-agent

Tells a background agent what the Replicas cloud workspace gives it: service previews, Slack, Linear, GitHub, Google Docs, Docker and the replicas CLI.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 36700 installs · ★ 1
- Author: replicas-group
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/replicas-group/skill/tree/HEAD/SKILL.md
- Updated: 2026-09-08
- HTML: https://affpapa.org/en/nevibecode/skills/replicas-agent

## What it does

Inside a Replicas VM the agent needs to know its own toolbox, and this skill is the map. A locally running service can be published behind a public URL, so a person clicks through the UI or calls the API while the agent keeps going. Slack threads, Linear issues, pull requests through the pre-authenticated `gh` CLI, Google Docs and Sheets, Docker containers, screenshots and recordings each get a section of their own. Every section lives in a file under `references/` (`PREVIEWS.md`, `SLACK.md`, `LINEAR.md`, `GITHUB.md`, `GOOGLE.md`, `DOCKER.md`, `MEDIA.md`, `REPLICAS.md`), and the agent is meant to read the matching file before touching anything.

Some of it depends on the machine. Docker is installed, yet the daemon does not come up on its own, so `docker` and `docker compose` fail until somebody starts it. Google files stay inside Replicas: the gateway owns what it creates, and documents made outside the integration remain out of reach. `gh` arrives already logged in, so no token setup is needed.

One more part covers the `replicas` CLI for automations, environment variables and files, repos and `replicas.json`. When the question is how Replicas itself works, the skill sends the agent to the docs first and saves the CLI for actual changes.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add replicas-group/skill --skill replicas-agent -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/replicas-agent/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/replicas-agent/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add replicas-group/skill --skill replicas-agent -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/replicas-agent/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add replicas-group/skill --skill replicas-agent -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/replicas-agent/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install replicas-group/skill replicas-agent
```

2. **Manually: put the files in place**
- File: `.github/skills/replicas-agent/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add replicas-group/skill --skill replicas-agent -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/replicas-group/skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/replicas-agent/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add replicas-group/skill --skill replicas-agent -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/replicas-group/skill/tree/HEAD/SKILL.md

## When to use it
- hand a reviewer a public URL for a local service
- post a task summary into a Slack channel
- mark a Linear issue done with a comment
- open a pull request without setting up `gh` auth
- start the Docker daemon before running compose

## Example prompts
- Start the dev server and give me a preview URL I can open
- Post the summary to `#dev` on Slack and attach the screenshot
- Read the Linear issue from this link, set it to done and leave a note

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md