An agentic skills framework & software development methodology that works.
Motion skill and React component library for product interfaces
Motion Lexicon combines a versioned agent skill with a React library of motion components, page blocks, and primitives. The skill helps with page planning, component selection, implementation, and motion and accessibility review, while the registry delivers copy-ready UI pieces you can install into a project.
Builders who want their agent to plan, review, and implement motion-heavy product UI consistently.
You can move from motion idea to installed component and implementation guidance without rebuilding the pattern from scratch.
What it does
Versioned motion skill
`skills/motion-lexicon/` packages guidance for page plans, component selection, implementation, and review.
Shadcn registry components
`src/registry/components/` exposes 100 React components with live previews and installable registry entries.
Page blocks and primitives
`src/registry/blocks/` and `src/registry/primitives/` provide 10 page blocks and 44 motion primitives for reusable patterns.
Motion and accessibility checks
`scripts/check-motion.ts`, `scripts/check-a11y.ts`, and related scripts enforce motion, accessibility, and catalog quality.
Registry and release generation
`scripts/generate-registry.ts`, `scripts/generate-public-artifacts.ts`, and `scripts/prerender.ts` build the public catalog and registry JSON.
How to get it
- 1Every Component and Page Block follows one source chain
implementation → direct-import demo → preview and code view → /r/:id.json
- 2Run
npx shadcn@latest add https://motion-lexicon.pages.dev/r/cinematic-hero.json npx shadcn@latest add https://motion-lexicon.pages.dev/r/focus-gallery.json npx shadcn@latest add https://motion-lexicon.pages.dev/r/onboarding-flow.json
- 3Run
npx shadcn@latest add @motion-lexicon/cinematic-hero
README
Motion Lexicon
Copy-ready React motion components for memorable products.
100 components · 10 Page Blocks · live previews · shadcn Registry · reduced motion.
Website · Components · Page Blocks · Primitives · Motion Lexicon Skill · Guides
Start with Components
Motion Lexicon is a React component library for product interactions with a clear resting frame, a recognizable motion signature, real content, and an installation path. Components lead discovery; Page Blocks, Primitives, and the Skill extend the same system.
| Collection | Use it for | Delivery |
|---|---|---|
| Components | One complete product interaction | Live preview, source, typed API, and shadcn Registry install |
| Page Blocks | One responsive product page assembled from Components | Self-contained React page, viewport preview, source, and Registry install |
| Primitives | A reusable motion rule or timing decision | 44 canonical workbenches covering all 91 source terms |
| Motion Lexicon Skill | Product-aware composition and implementation guidance | Component selection, page plan, implementation, and review workflow |
The 100 Components span 11 categories: Agent UI, Actions, Overlays & Surfaces, Forms & Input, Navigation, Data & Commerce, Feedback, Cards & Media, Visual & Ambient, Hero & Story, and Text & Type.
Three scene families
- Product Mono — precise product states, data, forms, navigation, and feedback.
- Editorial Warm — image-led stories, material detail, generous type, and cultural character.
- Spatial Dark — dimensional product worlds, technical depth, and restrained light.
Each scene begins with an intentional static frame. Motion explains a user action or meaningful state change; reduced motion preserves the same outcome.
Install
Every Component and Page Block follows one source chain:
implementation → direct-import demo → preview and code view → /r/:id.json
npx shadcn@latest add https://motion-lexicon.pages.dev/r/cinematic-hero.json
npx shadcn@latest add https://motion-lexicon.pages.dev/r/focus-gallery.json
npx shadcn@latest add https://motion-lexicon.pages.dev/r/onboarding-flow.json
Add the registry once to components.json for shorter commands:
{
"registries": {
"@motion-lexicon": "https://motion-lexicon.pages.dev/r/{name}.json"
}
}
npx shadcn@latest add @motion-lexicon/cinematic-hero
Registry items declare their runtime dependencies. The library uses React, Motion, GSAP, Three.js, WebGL, SVG, and CSS where they suit the component job. Heavy scenes gate work to the viewport and release graphics resources on unmount.
Motion Lexicon Skill 4.2.0
The Skill is versioned independently from the website package. Install it when an agent needs a page plan, exact Registry component selection, implementation guidance, or motion and accessibility review.
# Install for the current project
npx skills add Ryan-yang125/motion-lexicon --skill motion-lexicon
# Install at user scope
npx skills add Ryan-yang125/motion-lexicon --skill motion-lexicon --global
# Install only for Codex; replace codex with another supported agent ID when needed
npx skills add Ryan-yang125/motion-lexicon --skill motion-lexicon --agent codex
Use npx skills list for a project install and npx skills list --global for
a user-scope install.
Development
src/registry/components/ 100 React Component implementations
src/registry/demos/ Direct-import, real-product Component demos
src/registry/blocks/ 10 React Page Block implementations
src/registry/block-demos/ Direct-import, responsive Block demos
src/registry/primitives/ 44 canonical motion primitives
src/data/ Catalog, routing, i18n, and SEO source
skills/motion-lexicon/ Independently versioned Skill 4.2.0
scripts/ Registry, prerender, and quality checks
Motion Lexicon is a static React + TypeScript application. npm run build
generates the application, localized prerendered pages, sitemap, public catalog,
and the shadcn-compatible registry under /r/.
npm ci
npm run dev
npm run build
Quality gates
npm run lint
npm run typecheck
npm run test
npm run i18n:check
npm run vocabulary:check
npm run motion-grammar:check
npm run skill:check
npm run artifacts:check
npm run seo:check
npm run motion:check
npm run a11y:check
npm run build
npm run bundle:check
npm run crawl:dist
npm run test:visual
Release assets
V6 screenshots, social images, machine-readable catalog output, and public Registry JSON are regenerated during release acceptance after catalog and visual review are complete.
License and attribution
- Application and component code: MIT
- Project-authored content: CC BY 4.0
- Interior-derived interaction work: MIT attribution
The collection builds on interaction principles and MIT-licensed implementations from Interior.
Files in the repo
- .github
- docs
- prototype
- public
- scripts
- skills
- src
- tests
- .env.example
- .gitignore
- .npmrc
- AGENTS.md
- CODE_OF_CONDUCT.md
- components.json
- CONTENT-LICENSE
- CONTRIBUTING.md
- DESIGN.md
- eslint.config.js
- index.html
- LICENSE
- NOTICE
- package-lock.json
- package.json
- playwright.config.ts
- playwright.lab.config.ts
- PRODUCT.md
- README.md
- README.zh-CN.md
- registry.json
- SECURITY.md
- SPEC-V6.md
- tsconfig.app.json
- tsconfig.json
- tsconfig.node.json
- vite.config.ts
- vitest.config.ts
Discussion (0)
Ask about usage, or say what you built with itSign in to join the discussion.
No comments yet. Be the first to say what this is good for.
More skills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.
Public repository for Agent Skills
Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

Production-grade engineering skills for AI coding agents.