# Modules

> >

- **Type:** Skill
- **Install:** `agentstack add skill-coder-skills-modules`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [coder](https://agentstack.voostack.com/s/coder)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [coder](https://github.com/coder)
- **Source:** https://github.com/coder/skills/tree/main/skills/modules

## Install

```sh
agentstack add skill-coder-skills-modules
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Modules

Add or update Coder modules inside an existing Coder template.
Modules are Terraform snippets published at registry.coder.com that
extend a workspace with IDEs, AI agents, secrets, login flows, cloud
regions, and other tools.

## Source of Truth

Read current upstream docs before applying anything topic-specific:

-  for the docs index.
-  only when the index is not
  enough.
- Each module's page on registry.coder.com has the canonical Terraform
  snippet and version. Prefer that over a memorized version.

This skill keeps only the integration workflow, user interaction
rules, and a few module-specific gotchas.

## User Interaction

The user wants a working module integration, not a Terraform lesson.

- Confirm which template you are editing when the user has more than
  one.
- Show the proposed snippet before writing it. Ask for one yes/no.
- Never bump a module version silently. Call out version changes.
- Do not lecture the user on Coder concepts unless they ask.

## Workflow

### 1. Identify the module

Search for what the user described. Try these in order and stop at
the first hit:

1. The registry MCP server at `https://registry.coder.com/mcp` with
   the `search_modules` tool.
2. The website at .
3. `find registry/coder/modules -maxdepth 1 -type d` against a local
   clone of `coder/registry`.

If the request is ambiguous, list two or three matching options with
one-line descriptions and ask the user to pick one.

### 2. Locate the target template

Coder modules go inside a Coder template, which is Terraform code on
disk. Confirm:

- A directory with `main.tf`.
- A `coder_agent` resource. Most modules need an `agent_id`.
- A `data "coder_workspace" "me"` data source. Most modules gate on
  `data.coder_workspace.me.start_count`.

If no template directory exists, stop and offer the templates skill.

### 3. Read the module page

Fetch the canonical snippet:

- From the module's README on registry.coder.com.
- Or from `registry/coder/modules//README.md` in a local clone
  of `coder/registry`.

Always pin the version shown on the page. Never use `latest`. Never
fabricate a version that is not listed.

### 4. Insert the module

Add the snippet to `main.tf`. Common rules:

- Set `agent_id` to the existing `coder_agent` resource. Templates
  usually have exactly one.
- Keep `count = data.coder_workspace.me.start_count` for modules that
  should only run while the workspace is started.
- Match the surrounding indentation and quoting style.
- Modules with extra inputs (JetBrains IDE selection, Vault auth,
  JFrog instance URL, MCP config) take additional arguments. Read the
  module README's Examples section before guessing.

### 5. Validate

In the template directory:

```sh
terraform init
terraform fmt
terraform validate
```

`terraform fmt` may reformat unrelated parts of the file the user has
not touched. If that happens, ask before committing.

### 6. Push

If the user wants the change live on a Coder deployment:

```sh
coder templates push "$TEMPLATE_NAME" -d "$TEMPLATE_DIR" --yes
coder templates versions list "$TEMPLATE_NAME"
```

The `versions list` output confirms the new version is registered.
If the user wants the new version to become active automatically,
add `--activate` to `push`; otherwise leave the existing active
version alone.

## Common Modules

Curated shortlist of the most-requested categories. Full catalogue at
.

- IDEs: `cursor`, `jetbrains`, `code-server`, `vscode-desktop`,
  `vscode-web`, `windsurf`, `zed`, `kiro`.
- AI agents: `claude-code`, `aider`, `goose`, `amazon-q`, `agentapi`.
- Dev environment: `dotfiles`, `git-clone`, `git-config`,
  `personalize`, `coder-login`.
- Secrets: `hcp-vault-secrets`, `vault-cli`, `vault-github`,
  `vault-jwt`, `vault-token`.
- Apps: `filebrowser`, `jupyterlab`, `jupyter-notebook`,
  `rstudio-server`, `kasmvnc`.
- Cloud regions: `aws-region`, `azure-region`, `gcp-region`,
  `fly-region`.

## Safeguards

- Do not add a module to a template that has no `coder_agent`. The
  module will not function and the workspace will silently miss the
  integration.
- Do not add a module that needs admin-level configuration (Vault
  backend, JFrog instance, external auth providers) without
  confirming the deployment has that side configured.
- Do not run `coder templates push` without telling the user which
  template version they will get.
- Do not edit `main.tf` if the user has uncommitted changes; offer to
  stash or commit first.
- Do not invent module names or versions. If you cannot find the
  module on registry.coder.com, say so.

## Bundled Resources

No per-module recipes ship with this skill. Defer to each module's
README on registry.coder.com and to upstream Coder docs.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [coder](https://github.com/coder)
- **Source:** [coder/skills](https://github.com/coder/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-coder-skills-modules
- Seller: https://agentstack.voostack.com/s/coder
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.