# matterjs

Помогает агенту собрать сцену на Matter.js: движок, рендер, тела, ограничения и перетаскивание мышью. Пригодится, когда нужна физика на canvas.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1500 установок · ★ 7001
- Автор: MengTo
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/MengTo/Skills/tree/HEAD/agent-skills/web-design/matterjs/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/matterjs

## Что делает

Скилл включается, когда в проекте появляется 2D-физика на Matter.js. Агент сначала уточняет окружение: чистый HTML, React или только canvas, и как выводить картинку — через `Matter.Render` для отладки или своим рендерером. Дальше он выдаёт минимальную связку `Engine`, `World`, `Render` и `Runner` и добавляет тела.

Внутри описан рабочий порядок: создать движок, поднять рендер с нужными размерами, запустить цикл, положить тела через `Composite.add(engine.world, [...])`. Для сплошной отрисовки советует выставить `render.options.wireframes = false`. Если нужен свой тайминг, вместо `Runner.run` можно звать `Engine.update` в собственном цикле. Перетаскивание мышью добавляется отдельно — через `Mouse` и `MouseConstraint`.

Для одностраничных приложений есть чек-лист уборки: остановить раннер, убрать canvas из DOM, очистить движок и мир. Без этого при переходах между экранами останутся лишние циклы и висящие слушатели — это повод проверить разметку перед тем, как оставлять скилл в проекте.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MengTo/Skills --skill matterjs -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/matterjs/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/matterjs/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MengTo/Skills --skill matterjs -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/matterjs/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MengTo/Skills --skill matterjs -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/matterjs/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MengTo/Skills matterjs
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/matterjs/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MengTo/Skills --skill matterjs -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/MengTo/Skills --path agent-skills/web-design/matterjs
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/matterjs/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add MengTo/Skills --skill matterjs -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/MengTo/Skills/tree/HEAD/agent-skills/web-design/matterjs/SKILL.md

## Когда брать
- поднять движок и мир Matter.js с нуля
- добавить тела и статические опоры в сцену
- включить перетаскивание объектов мышью
- настроить отрисовку без каркасных линий
- корректно остановить симуляцию при уходе со страницы

## Примеры запросов агенту
- собери сцену на Matter.js: земля и падающий квадрат
- добавь перетаскивание тел мышью в этой сцене
- останови раннер и убери canvas, когда компонент размонтируется

## Похожие
- [game-assets](https://affpapa.org/nevibecode/skills/game-assets.md) — скилл · 1600 установок
- [graphics-and-shapes](https://affpapa.org/nevibecode/skills/graphics-and-shapes.md) — скилл · 827 установок
- [physics-matter](https://affpapa.org/nevibecode/skills/physics-matter.md) — скилл · 758 установок
- [game-engine](https://affpapa.org/nevibecode/skills/game-engine.md) — скилл · 13140 установок
- [phaser](https://affpapa.org/nevibecode/skills/phaser.md) — скилл · 1400 установок
- [canvas-generative](https://affpapa.org/nevibecode/skills/canvas-generative.md) — скилл · 995 установок

Из того же набора: [mengto/skills](https://affpapa.org/nevibecode/by/mengto/skills.md) — 148 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md