# authoring-motion-diagrams

Adopt this skill: https://proskills.md/skills/other/2389-research-claude-plugins-claude-skills-authoring-motion-diagrams

Page: https://proskills.md/skills/other/2389-research-claude-plugins-claude-skills-authoring-motion-diagrams
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: .claude/skills/authoring-motion-diagrams/SKILL.md
size: 3936
upstream: https://github.com/2389-research/claude-plugins/blob/main/.claude/skills/authoring-motion-diagrams/SKILL.md

```text
---
name: authoring-motion-diagrams
description: Use when adding a plugin to the marketplace, or when authoring, editing, or re-rendering a scene under scripts/animations/scenes/ — including when a scene fails the render contract, the contrast gate, or the grid baseline.
---

# Authoring motion diagrams

Every marketplace entry has one authored scene at `scripts/animations/scenes/<plugin>.svg`,
shown on that plugin's detail page. `docs/plugins/<plugin>/anim.mp4` and `anim-poster.png`
are derived from it. Never patch the video — change the scene and re-render.

A scene must **say what the plugin does**: what moves, in what order, and what is different
at the end. A scene where things merely move is decoration.

## Flow

1. Read the plugin's category from `.claude-plugin/marketplace.json`, then take that
   category's `mark` and `ink` from `scripts/animations/palette.js`. One accent per scene.
2. Copy `references/scene-template.svg` to `scripts/animations/scenes/<plugin>.svg`.
3. Compose the beats. `references/binding.md` has the tokens, the beat pattern, and the
   scene mechanics already in use — reuse one rather than inventing a shape.
4. `node scripts/animations/render.js --check` — validates the contract in about a second,
   no Chrome. Run it constantly, not once at the end.
5. `node scripts/animations/preview.js <plugin>` — one frame, ~1s. `AT=0.3` for another
   moment. This catches what no checker can: a label sitting on a connector, a box crossing
   its frame, a path ending in mid-air.
6. `node scripts/animations/render.js <plugin>` — mp4 + poster, ~75s.
7. `npm run generate && npm test`.
8. Commit the scene, the mp4 and the poster together. They drift the moment they don't.

## What `--check` enforces

| Gate | Rule |
|---|---|
| Cycle | every `dur` is `8s`, `repeatCount="indefinite"`, events placed in `keyTimes` |
| Counts | `keySplines` = n−1, `values` = n, `keyPoints` = n. A mismatch disables the animation *silently* |
| Ground | a `#faf9f6` rect is the first element |
| Type | every text fill is a legal ink token — 4.5:1 on paper, computed not judged |
| Blocks | solid rects use a category `ink`, so white type on them clears 4.5:1 |
| Grid | placement on 20px; existing scenes carry a frozen debt in `grid-baseline.json` and may only improve |

`palette.js` re-derives its own contrast claims before any scene is checked, so a token
edited below its floor fails the build rather than shipping quietly.

## What no gate can check

- **Two beats per change.** Transit says something arrived; settlement says the thing is now
  different. One beat alone reads as decoration.
- **The changed state holds** until 0.95 of the cycle. A transition with no hold shows motion
  and communicates no outcome.
- **Routes avoid what they don't address.** A path to C that crosses B reads as having entered B.
- **Position is pre-allocated.** Draw routes as faint dashed guides from frame one, so the
  layout never reflows as parts land — reflow reads as rewriting, not extending.
- **The poster carries the whole diagram** for a reduced-motion reader. Check it, not just the video.

## Common mistakes

| Mistake | What happens |
|---|---|
| Chaining with `begin="other.end"` | can't scrub to a frame; export breaks |
| A lighter grey "because the label is secondary" | fails the floor; there is no legal grey above `muted` |
| Recolouring a travelling dot to `ink` | dots are marks at the 3:1 floor — leave them `mark` |
| Editing `anim.mp4` or shipping a scene without re-rendering | video and source drift, and nothing reports it |
| Nudging geometry off-grid in an existing scene | ratchet fails the build; the baseline only goes down |

## References

- `references/binding.md` — this marketplace's tokens, treatments, and scene mechanics
- `references/mechanic.md` — the portable declarative-SVG-motion doc
- `references/scene-template.svg` — a conforming skeleton
```

## File: README.md
upstream: https://github.com/2389-research/claude-plugins/blob/main/README.md

````text
<!-- ABOUTME: README for the 2389 Research Claude Code plugin marketplace -->
<!-- ABOUTME: Public-facing documentation with install instructions and plugin catalog -->

# 2389 Research Claude Code Plugin Marketplace

28 plugins and MCP servers for Claude Code — parallel exploration, iterative refinement, binary reverse engineering, structured decision-making, and more.

Built by the team at [2389](https://2389.ai). These are the tools we use every day.

**Browse the marketplace:** https://skills.2389.ai

## Quick Start

Install any plugin in **any agent** (Claude Code, Cursor, Codex, …) with [vercel-labs/skills](https://github.com/vercel-labs/skills):

```bash
npx skills add 2389-research/simmer
```

Or natively in Claude Code:

```bash
# Add the marketplace, then install any plugin
/plugin marketplace add 2389-research/claude-plugins
/plugin install simmer@2389-research
```

> The 4 MCP servers (journal, socialmedia, slack-mcp, agent-drugs) install via Claude Code only — they ship no skills for npx.

## Available Plugins

### Meta Plugins

| Plugin | Description |
|--------|-------------|
| [botboard-biz](https://github.com/2389-research/botboard-biz) | Social media and journaling capabilities for AI agents |
| [better-dev](https://github.com/2389-research/better-dev) | CSS, Firebase, code quality, testing, parallel exploration, docs verification, codegen |
| [sysadmin](https://github.com/2389-research/sysadmin) | Structured Linux maintenance and diagnostics |

### Development

| Plugin | Description |
|--------|-------------|
| [css-development](https://github.com/2389-research/css-development) | CSS workflows with Tailwind, semantic naming, dark mode by default |
| [firebase-development](https://github.com/2389-research/firebase-development) | Firebase project workflows: setup, features, debugging, validation |
| [landing-page-design](https://github.com/2389-research/landing-page-design) | High-converting landing pages with anti-AI-slop principles |
| [xtool](https://github.com/2389-research/xtool) | Xcode-free iOS development with xtool via SwiftPM |
| [building-multiagent-systems](https://github.com/2389-research/building-multiagent-systems) | Architecture patterns for multi-agent systems |
| [speed-run](https://github.com/2389-research/speed-run) | Token-efficient code generation with hosted LLM (Cerebras) |
| [thrifty](https://github.com/2389-research/thrifty) | Tiered-delegation execution: Sonnet plans a spec into sprints, cheap Haiku executes + self-verifies; ~64% cheaper than Opus |
| [binary-re](https://github.com/2389-research/binary-re) | Agentic binary reverse engineering for ELF binaries |

### Testing and Quality

| Plugin | Description |
|--------|-------------|
| [test-kitchen](https://github.com/2389-research/test-kitchen) | Parallel exploration of implementation approaches |
| [simmer](https://github.com/2389-research/simmer) | Iterative artifact refinement with investigation-first judges |
| [scenario-testing](https://github.com/2389-research/scenario-testing) | End-to-end testing with real dependencies, no mocks |
| [fresh-eyes-review](https://github.com/2389-research/fresh-eyes-review) | Final sanity check before commits/PRs |
| [documentation-audit](https://github.com/2389-research/documentation-audit) | Verify documentation against codebase reality |
| [review-squad](https://github.com/2389-research/review-squad) | Dispatch panels of specialized subagents for project review |
| [prbuddy](https://github.com/2389-research/prbuddy) | PR health assistant: CI monitoring, review triage, fixes |
| [git-repo-prep](https://github.com/2389-research/git-repo-prep) | Prepare codebases for public/open-source release |

### Business and Strategy

| Plugin | Description |
|--------|-------------|
| [ceo-personal-os](https://github.com/2389-research/ceo-personal-os) | Personal operating system for executives |
| [worldview-synthesis](https://github.com/2389-research/worldview-synthesis) | Systematic worldview articulation |
| [deliberation](https://github.com/2389-research/deliberation) | Decision-making through deliberation and discernment |
| [summarize-meetings](https://github.com/2389-research/summarize-meetings) | Batch-process meeting transcripts into structured summaries |

### Utilities

| Plugin | Description |
|--------|-------------|
| [terminal-title](https://github.com/2389-research/terminal-title) | Auto-update terminal title with emoji + project + topic |
| [remote-system-maintenance](https://github.com/2389-research/remote-system-maintenance) | Linux system diagnostics and maintenance via SSH/tmux |

### MCP Servers

| Server | Description |
|--------|-------------|
| [agent-drugs](https://github.com/2389-research/agent-drugs) | Digital drugs that modify AI behavior through prompt injection |
| [socialmedia](https://github.com/2389-research/mcp-socialmedia) | Social media functionality for AI agents |
| [journal](https://github.com/2389-research/journal-mcp) | Private journaling capability for Claude |
| [slack-mcp](https://github.com/2389-research/slack-mcp) | Slack workspace integration MCP server |

## Adding a Plugin

1. Create a GitHub repo under `2389-research/` with standard plugin structure
2. Add an entry to `.claude-plugin/marketplace.json`
3. Run `npm run generate` to update the marketplace site
4. Commit and push

See [CLAUDE.md](CLAUDE.md) for the full marketplace.json format and detailed instructions.

## Like this?

If these plugins save you time, a ⭐ helps us know what's landing. We build what people use.

## Contact

**Email:** [hello@2389.ai](mailto:hello@2389.ai) — we'd love to hear what you're building with these.

## License

MIT
````
