# factory-mcp

factory-mcp is a Claude Code skill that links local workspaces to the Warp Factory software service via MCP. It packages local code for the cloud and pulls down tasks from Linear or Slack.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 720 repo stars
- Author: dominikmartn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dominikmartn/harp/tree/HEAD/resources/bundled/skills/factory-mcp/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/factory-mcp

## What it does

The skill coordinates task handoffs between a developer workspace and a remote software factory. It locates assignments through descriptions, Slack discussions, or Linear tickets, pulls them down for local execution, and transfers completed progress back up.

Operational instructions synchronize with schema definitions exposed by the `warp-factory` server. Both connection and active authentication with `warp-factory` are required before any tool call executes. If `skill://warp/factory-mcp/SKILL.md` cannot be loaded, the agent falls back to live schema definitions from the running server.

## Requirements
- Works with: Linear, Slack

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill factory-mcp -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill factory-mcp -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill factory-mcp -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp resources/bundled/skills/factory-mcp
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill factory-mcp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/skills/factory-mcp
```

### Windsurf (Devin Desktop)

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

### 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/dominikmartn/harp/tree/HEAD/resources/bundled/skills/factory-mcp/SKILL.md

## When to use it
- package local edits and push them to Warp Factory
- retrieve tasks using Linear tickets or Slack threads
- pull remote work down for local testing and iteration
- align agent instructions with active `warp-factory` schemas

## Example prompts
- Locate the Linear ticket from this link and pull it down locally
- Package my local modifications and hand them over to the cloud factory
- Fetch the task discussed in the Slack thread for local debugging

## Similar
- [cyrus-setup](https://affpapa.org/en/nevibecode/skills/cyrus-setup.md) — skill · 1300 installs
- [customer-support-tooling-wasp-drone](https://affpapa.org/en/nevibecode/agents/customer-support-tooling-wasp-drone.md) — subagent · ★ 96 repo stars
- [chat-sdk](https://affpapa.org/en/nevibecode/skills/vercel-chat-sdk.md) — skill · 5500 installs
- [n8n-agents-official](https://affpapa.org/en/nevibecode/skills/n8n-agents-official.md) — skill · 2500 installs
- [setup](https://affpapa.org/en/nevibecode/skills/lifecycle-innovations-limited-setup.md) — skill · ★ 3785 repo stars
- [authoring-error-tracking-alerts](https://affpapa.org/en/nevibecode/skills/authoring-error-tracking-alerts.md) — skill · 209 installs

From the same set: [dominikmartn/harp](https://affpapa.org/en/nevibecode/by/dominikmartn/harp.md) — 62 cards

---
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
