Skip to content
Back to search

motion-lab

Motion Lab v2.0 — Zero-dependency UI motion playground (12 studies + 8 tactile components), ready as a library, Agent Skill, llms.txt, or MCP server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hmkkaii--motion-lab/badge.svg)](/listings/hmkkaii--motion-lab)

HTML

<a href="/listings/hmkkaii--motion-lab"><img src="/api/listings/hmkkaii--motion-lab/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 122 lines
  1. # Motion Lab v2.0
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![Zero Dependency](https://img.shields.io/badge/Dependencies-0-brightgreen.svg)](#) [![MCP Ready](https://img.shields.io/badge/MCP%20%26%20Skill-Ready-7c6cff.svg)](https://hmkkaii.github.io/motion-lab/ai.html)
  3. **Building blocks for interactive UI, ready to use as a library, Agent Skill, or MCP server with Claude Code, Cursor, Codex, and Antigravity.**
  4. Zero-dependency semantic HTML, CSS custom properties, and Vanilla JavaScript — with live clickable previews, real-time parameter tuning, and machine-readable AI endpoints.
  5. - **Live Website**: https://hmkkaii.github.io/motion-lab/
  6. - **Interactive UI Components**: https://hmkkaii.github.io/motion-lab/components.html
  7. - **Skill & MCP Setup Hub**: https://hmkkaii.github.io/motion-lab/ai.html
  8. - **Machine Registry (`registry.json`)**: https://hmkkaii.github.io/motion-lab/registry.json
  9. - **LLM Index (`llms.txt`)**: https://hmkkaii.github.io/motion-lab/llms.txt
  10. - **Repository**: https://github.com/hmkkaii/motion-lab
  11. [![Motion Lab v2.0 — 12 Interactive Motion Studies & Parameter Workbench](assets/preview.png)](https://hmkkaii.github.io/motion-lab/)
  12. [![Motion Lab v2.0 — 8 Interactive Tactile UI Components](assets/preview-components.png)](https://hmkkaii.github.io/motion-lab/components.html)
  13. ---
  14. ## What's Included (20 Live Interactive Blocks)
  15. ### 12 Interactive Motion Studies (`index.html` + `study.html`)
  16. - **Surfaces**: `adaptive-card`, `origin-menu`, `scale-dialog`
  17. - **Navigation**: `sliding-tabs`, `accordion-disclosure`, `page-transition`
  18. - **Feedback**: `toast-stack`, `validation-shake`, `confirm-check`
  19. - **Micro-Motion**: `spring-like`, `drum-counter`, `hover-cluster`
  20. - Every study opens in a dedicated **Workbench** with live CSS sliders, cubic-bezier SVG plot, slow-motion (`1×`, `0.5×`, `0.25×`), `prefers-reduced-motion` simulator, and one-click **Copy CSS** / **Copy for AI**.
  21. ### 8 Interactive UI Showcase Components (`components.html`)
  22. - **Pulse Climate Dial** (`pulse-climate`): 36-tick radial thermostat, glowing arc, stepper buttons, and Eco / Comfort / Warm Glow pill.
  23. - **Orbit Live Flight Pass** (`orbit-flight`): Cobalt great-circle Bezier route tracker with tangent aircraft icon and live gate tabs.
  24. - **Tempo Spatial Audio Deck** (`tempo-audio`): Vinyl player with 18-bar animated equalizer and Studio / Warm / Spatial presets.
  25. - **Chroma Palette Studio** (`chroma-mesh`): Crossfading radial mesh studio with live OKLCH readout and one-click CSS copy.
  26. - **Focus Deep Work Timer** (`focus-timer`): SVG countdown ring with tabular digits and ambient sound toggles.
  27. - **Forge Edge Deploy Pipeline** (`forge-deploy`): 4-stage staggered release cascade with spring checkmarks.
  28. - **Design Shelf 3D Deck** (`shelf-books`): Perspective book cover-flow with reading progress bar and bookmark toggle.
  29. - **Relay Issue Triage Card** (`relay-triage`): Priority escalation, Ship PR morph, QA progress bar, and reaction counters.
  30. ### Easing Curve Lab (`tokens.html`)
  31. - Synchronized 6-curve race track (`--ease-smooth-out`, `--ease-bounce`, `--ease-pop`, `--ease-bounce-strong`, `--ease-in-out`, `--ease-out`) + one-click **Copy `:root` Tokens**.
  32. ---
  33. ## Use with AI Coding Agents (Claude Code, Cursor, Codex, Antigravity)
  34. ### Option A: Zero-Install via `llms.txt` / `registry.json`
  35. Paste into any AI coding agent with web fetch:
  36. > Read `https://hmkkaii.github.io/motion-lab/llms.txt` and `https://hmkkaii.github.io/motion-lab/registry.json`, then implement `"origin-menu"` and `"pulse-climate"` in my project using Motion Lab's exact cubic-bezier curves and reduced-motion guards.
  37. ### Option B: Install the Agent Skill (`SKILL.md`)
  38. ```bash
  39. git clone https://github.com/hmkkaii/motion-lab.git ~/motion-lab
  40. # Claude Code
  41. mkdir -p ~/.claude/skills/motion-lab
  42. cp ~/motion-lab/skills/motion-lab/SKILL.md ~/.claude/skills/motion-lab/SKILL.md
  43. # Codex CLI
  44. mkdir -p ~/.codex/skills/motion-lab
  45. cp ~/motion-lab/skills/motion-lab/SKILL.md ~/.codex/skills/motion-lab/SKILL.md
  46. ```
  47. ### Option C: Connect the Zero-Dependency MCP Server
  48. Two identical zero-dependency stdio MCP servers are included:
  49. - **Python 3** (no `pip install` needed): `mcp/motion-lab-mcp.py`
  50. - **Node.js ≥ 18** (no `npm install` needed): `mcp/motion-lab-mcp.mjs`
  51. **Claude Code:**
  52. ```bash
  53. claude mcp add motion-lab -- python3 ~/motion-lab/mcp/motion-lab-mcp.py
  54. # or with Node.js >= 18:
  55. # claude mcp add motion-lab -- node ~/motion-lab/mcp/motion-lab-mcp.mjs
  56. ```
  57. **Cursor (`.cursor/mcp.json`):**
  58. ```json
  59. {
  60. "mcpServers": {
  61. "motion-lab": {
  62. "command": "python3",
  63. "args": ["/ABSOLUTE/PATH/TO/motion-lab/mcp/motion-lab-mcp.py"]
  64. }
  65. }
  66. }
  67. ```
  68. **Codex CLI (`~/.codex/config.toml`):**
  69. ```toml
  70. [mcp_servers.motion-lab]
  71. command = "python3"
  72. args = ["/ABSOLUTE/PATH/TO/motion-lab/mcp/motion-lab-mcp.py"]
  73. ```
  74. **Exposed MCP Tools (5) & Resources (3):**
  75. - `list_motions(category?)`
  76. - `get_motion_spec(id)`
  77. - `list_components(category?)`
  78. - `get_component_code(id)`
  79. - `get_easing_tokens()`
  80. - Resources: `motion-lab://registry`, `motion-lab://tokens`, `motion-lab://llms`
  81. ---
  82. ## Local Development
  83. No build step or package install is required:
  84. ```bash
  85. python3 -m http.server 8780 --bind 127.0.0.1
  86. ```
  87. To verify GitHub Pages subpath behavior (`/motion-lab/`), serve from the parent directory and open `http://127.0.0.1:8780/motion-lab/`.
  88. ---
  89. ## License & Third-Party Attribution
  90. - Original Motion Lab source code is licensed under the [MIT License](LICENSE).
  91. - Third-party open-source attributions (including Transitions.dev motion principles and SIL OFL 1.1 fonts `Inter` & `Roboto Mono`) are documented in [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md) and `about.html`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.