# postplus-workspace

Keeps one project folder holding approved product facts, campaign context and finished results, so repeated PostPlus work does not start from zero.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 354 installs · ★ 27
- Author: PostPlusAI
- License: LicenseRef-Unknown · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostPlusAI/postplus-skills/tree/HEAD/skills/00-shared/postplus-workspace/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/postplus-workspace

## What it does

This skill turns a single resolved project folder into the durable context for ongoing PostPlus work. It reads only the facts a stage needs and keeps confirmed data apart from approved claims, research findings, hypotheses and forbidden content. Inventing prices, offers, identities or results is off the table by contract.

Inside you get `scripts/workspace.py` with `init`, `new-campaign` and `check`, templates under `assets/project-template/`, plus reference files for stage gates and the uncertainty policy. Setup starts with `postplus doctor --skill postplus-workspace --json`: when Python 3 is missing the skill follows the concrete action it returns, and if there is none it reports the dependency and stops rather than guessing a package manager. No Python 3 means none of the commands run, so check that first.

Stages run in order: onboarding, research, strategy, test, production, launch, learning. A `BLOCKED` result halts the affected stage, and a local `READY` does not stand in for CLI validation, credit checks or launch approval. Changing approved truth, publishing or touching live ads all need explicit approval. One-off tasks do not need a workspace at all.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill postplus-workspace -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill postplus-workspace -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill postplus-workspace -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostPlusAI/postplus-skills postplus-workspace
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill postplus-workspace -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostPlusAI/postplus-skills --path skills/00-shared/postplus-workspace
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill postplus-workspace -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/PostPlusAI/postplus-skills/tree/HEAD/skills/00-shared/postplus-workspace/SKILL.md

## When to use it
- set up a project folder with approved brand and product facts
- pick up from recorded state instead of redoing earlier work
- check whether the context for a given stage is complete
- keep approved claims separate from hypotheses and drafts
- write results and decisions back into the project

## Example prompts
- Initialize the workspace in `my-project` for the Spring Launch project
- Run the stage check for `production` on campaign `spring-2025`
- Resume from the last recorded state

## Similar
- [nx-workspace](https://affpapa.org/en/nevibecode/skills/nx-workspace.md) — skill · 75900 installs
- [cargo-workspace-management](https://affpapa.org/en/nevibecode/skills/cargo-workspace-management.md) — skill · 10000 installs
- [matter-workspace](https://affpapa.org/en/nevibecode/skills/matter-workspace.md) — skill · 595 installs
- [google-drive](https://affpapa.org/en/nevibecode/skills/sanjay3290-google-drive.md) — skill · 867 installs
- [Mailchimp Automation](https://affpapa.org/en/nevibecode/skills/mailchimp-automation.md) — skill · 4600 installs
- [marketing-os-starter](https://affpapa.org/en/nevibecode/skills/marketing-os-starter.md) — skill · 887 installs

From the same set: [postplusai/postplus-skills](https://affpapa.org/en/nevibecode/by/postplusai/postplus-skills.md) — 19 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
