# composing-grid-canvases

The composing-grid-canvases Claude Code skill arranges PostHog grids from reusable widgets. It activates for requests to add, resize, move, or remove a placement, or assemble a whole canvas.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 149 installs · ★ 101 repo stars
- Author: PostHog
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/composing-grid-canvases/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/composing-grid-canvases

## What it does

The skill helps build PostHog grid canvases from reusable widgets and edit their placements. If a stored component cannot express the requested setup, the agent can adapt an existing component or create one. For a canvas-wide request, it plans the widgets first and lays them out without overlaps.

Grid edits follow a read-and-patch cycle; after a version conflict, the agent reloads the layout and applies the change again. A placement moves through creation and build states before it is live or marked as failed. Building a component also calls for `building-react-quill-canvases` or `building-html-canvases`, plus `querying-canvas-data` and `validating-and-publishing-canvases`. A component needs a ready build before it can go live on a grid.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill composing-grid-canvases -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill composing-grid-canvases -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill composing-grid-canvases -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/composing-grid-canvases
```

2. **Manually: put the files in place**
- File: `.github/skills/composing-grid-canvases/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill composing-grid-canvases -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/composing-grid-canvases
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill composing-grid-canvases -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/PostHog/ai-plugin/tree/HEAD/skills/composing-grid-canvases/SKILL.md

## When to use it
- add a weather widget to a PostHog home canvas
- resize or move a grid placement
- compose a full canvas from a single request
- create a reusable component when stored options do not fit

## Example prompts
- Add a weather widget for Lisbon to my home canvas.
- Move the task widget and resize its placement.
- Build a canvas that summarizes my work in progress.

## Similar
- [layout-grid](https://affpapa.org/en/nevibecode/skills/layout-grid.md) — skill · 2900 installs
- [image-first-grid-layout](https://affpapa.org/en/nevibecode/skills/image-first-grid-layout.md) — skill · 1800 installs
- [framed-grid-layout](https://affpapa.org/en/nevibecode/skills/framed-grid-layout.md) — skill · 1800 installs
- [img-grid](https://affpapa.org/en/nevibecode/skills/img-grid.md) — skill · 46 installs
- [css](https://affpapa.org/en/nevibecode/skills/css.md) — skill · 1300 installs
- [lists-grids](https://affpapa.org/en/nevibecode/skills/lists-grids.md) — skill · 569 installs

From the same set: [posthog/ai-plugin](https://affpapa.org/en/nevibecode/by/posthog/ai-plugin.md) — 82 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
