particles-router
Decision framework for particle system projects. Routes to specialized particle skills (gpu, physics, lifecycle) based on task requirements. Use when building particle effects or needing guidance on which particle techniques to combine.
- Installs
- 66
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/bbeierle12/skill-mcp-claude --skill particles-router- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads particles-router automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Particles Router
Routes to 3 specialized particle system skills based on task requirements.
Routing Protocol
- Classify — Identify particle effect type and scale
- Match — Find skill(s) with highest signal match
- Combine — Most particle systems need 2-3 skills together
- Load — Read matched SKILL.md files before implementation
Quick Route
Tier 1: Core (Always Consider)
| Task Type | Skill | Primary Signal Words |
|---|---|---|
| Rendering | particles-gpu | points, instanced, buffer, shader, thousands, performance |
| Motion | particles-physics | gravity, wind, attract, force, velocity, turbulence, collision |
| Spawning | particles-lifecycle | emit, spawn, fade, trail, pool, birth, death, age |
Signal Matching Rules
Priority Order
When multiple signals present, resolve by priority:
- Performance concern — "millions of particles" →
particles-gpufirst - Motion type — "swirling", "attracted to" →
particles-physics - Emission pattern — "burst", "continuous", "trails" →
particles-lifecycle - Default — All three skills usually needed together
Confidence Scoring
- High (3+ signals) — Route immediately
- Medium (1-2 signals) — Include all three skills (typical)
- Low (0 signals) — Ask: "Describe the particle effect you want"
Common Combinations
Basic Particle System (All 3 skills)
particles-gpu → Buffer setup, shader rendering
particles-physics → Gravity, basic motion
particles-lifecycle → Emission, fade out
Wiring: GPU provides rendering foundation, lifecycle handles spawning/death, physics adds motion.
Snow/Rain Effect (3 skills)
particles-gpu → Points with texture
particles-physics → Gravity, wind, turbulence
particles-lifecycle → Continuous emission, recycling
Wiring: Lifecycle emits continuously, physics handles falling + drift, GPU renders efficiently.
Explosion (3 skills)
particles-gpu → Instanced or points rendering
particles-physics → Radial velocity, drag
particles-lifecycle → Burst emission, fade + shrink
Wiring: Lifecycle bursts particles, physics applies outward force + slowdown, GPU handles scale.
Fire/Smoke (3 skills)
particles-gpu → Custom shader with noise
particles-physics → Upward force, turbulence
particles-lifecycle → Continuous emit, color gradient, size over life
Wiring: Lifecycle manages color/size curves, physics adds flicker motion, GPU renders with blend modes.
Swarm/Flock (2-3 skills)
particles-gpu → Instanced mesh (if 3D shapes)
particles-physics → Attractors, flow fields, separation
particles-lifecycle → (Optional) Population management
Wiring: Physics dominates with behavioral forces, GPU handles rendering.
Magic Trail (3 skills)
particles-gpu → Points with glow shader
particles-physics → Follow path, slight randomness
particles-lifecycle → Trail history, fade along length
Wiring: Lifecycle stores position history, GPU renders with alpha gradient.
Confetti (3 skills)
particles-gpu → Instanced flat planes
particles-physics → Gravity, tumbling rotation, air resistance
particles-lifecycle → Burst emission, ground collision death
Wiring: Physics handles realistic falling, lifecycle manages burst and cleanup.
Decision Table
| Effect Type | GPU Focus | Physics Focus | Lifecycle Focus |
|---|---|---|---|
| Stars/sparkle | Points, static | Minimal | Twinkle (alpha) |
| Snow/rain | Points, texture | Gravity, wind | Continuous, recycle |
| Fire | Shader, blend | Upward, turbulence | Color/size curves |
| Explosion | High count | Radial, drag | Burst, fade |
| Smoke | Soft shader | Rise, curl | Slow fade, grow |
| Swarm | Instanced | Attractors, fields | Spawn/death |
| Trail | Line or points | Path following | Position history |
| Dust | Small points | Brownian | Random spawn |
Particle Count Guidelines
| Count | Approach | Skills Priority |
|---|---|---|
| < 100 | Simple, any approach | lifecycle > physics > gpu |
| 100 - 1,000 | Points or instanced | All equal |
| 1,000 - 10,000 | GPU-focused | gpu > physics > lifecycle |
| 10,000 - 100,000 | GPU essential | gpu >> physics (shader) > lifecycle |
| > 100,000 | Full GPU/compute | gpu only, physics in shader |
Skill Dependencies
particles-gpu (rendering foundation)
├── particles-physics (motion layer)
└── particles-lifecycle (management layer)
particles-gpuis always needed for renderingparticles-physicsandparticles-lifecycleare independent but complementary- For simple effects, you might skip physics OR lifecycle, rarely both
Fallback Behavior
- Unknown effect → Start with all three skills
- Performance issues → Focus on
particles-gpuoptimization - Motion problems → Deep-dive
particles-physics - Spawning/timing issues → Focus on
particles-lifecycle
Quick Decision Flowchart
User Request
│
▼
┌─────────────────────────┐
│ Rendering particles? │──Yes──▶ particles-gpu (always)
└─────────────────────────┘
│
▼
┌─────────────────────────┐
│ Movement/forces needed? │──Yes──▶ + particles-physics
└─────────────────────────┘
│
▼
┌─────────────────────────┐
│ Birth/death/emission? │──Yes──▶ + particles-lifecycle
└─────────────────────────┘
│
▼
Most effects need all 3 skills
Effect Recipes
Quick Start Templates
| Effect | Start With |
|---|---|
| Ambient dust | gpu (points) + lifecycle (continuous) |
| Button sparkle | gpu (points) + lifecycle (burst, fade) |
| Character trail | gpu + lifecycle (trail) |
| Weather | All three |
| Magic spell | All three |
| Data visualization | gpu + lifecycle |
Integration with Other Domains
| Combined With | Use Case |
|---|---|
shader-noise | Turbulent motion, organic shapes |
shader-effects | Glow, chromatic aberration on particles |
r3f-performance | Optimization, culling, LOD |
gsap-fundamentals | Scripted particle animations |
audio-reactive | Music-driven particle effects |
Reference
See individual skill files for detailed patterns:
/mnt/skills/user/particles-gpu/SKILL.md/mnt/skills/user/particles-physics/SKILL.md/mnt/skills/user/particles-lifecycle/SKILL.md
FAQ
What does the particles-router skill do?
Decision framework for particle system projects. Routes to specialized particle skills (gpu, physics, lifecycle) based on task requirements. Use when building particle effects or needing guidance on which particle techniques to combine.
How do I install particles-router?
Run npx skills add https://github.com/bbeierle12/skill-mcp-claude --skill particles-router in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/particles-router/ (personal) or .claude/skills/particles-router/ (project).
Which AI agents can use particles-router?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is particles-router safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains particles-router?
It is published by bbeierle12 in bbeierle12/skill-mcp-claude. It has 66 recorded installs.
More from bbeierle12/skill-mcp-claude
gsap-react
bbeierle12/skill-mcp-claude
GSAP integration with React including useGSAP hook, ref handling, cleanup patterns, and context management. Use when implementing GSAP animations in React components, handling component lifecycle, or building reusable animation hooks.
gsap-scrolltrigger
bbeierle12/skill-mcp-claude
Scroll-based animations using GSAP ScrollTrigger plugin including pinning, scrubbing, snap points, and parallax effects. Use when creating scroll-driven animations, sticky sections, progress indicators, or parallax scrolling experiences.
gsap-fundamentals
bbeierle12/skill-mcp-claude
Core GSAP animation concepts including tweens, timelines, easing functions, and animation properties. Use when implementing basic animations, transitions, or learning GSAP foundations. Essential starting point for any GSAP-based animation work.
shader-effects
bbeierle12/skill-mcp-claude
Visual shader effects—glow/bloom, chromatic aberration, distortion, vignette, film grain, scanlines, glitch, dissolve, outline, and fresnel. Use when adding visual polish, post-processing effects, or stylized rendering to shaders.
d3js-visualization
bbeierle12/skill-mcp-claude
Create D3.js charts and interactive data visualizations. Use when building bar charts, line charts, scatter plots, pie charts, force-directed graphs, geographic maps, or any custom data visualization.
particles-gpu
bbeierle12/skill-mcp-claude
GPU-based particle systems using instanced rendering, buffer attributes, Points geometry, and custom shaders. Use when rendering thousands to millions of particles efficiently, creating particle effects like snow, rain, stars, or abstract visualizations.
Popular ai & agents skills
google-agents-cli-publish
google/agents-cli
This skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini", "publish to Gemini" (formerly Gemini Enterprise), or needs guidance on the agents-cli publish gemini command. Also use when the user wants to "manage agents in Agent Registry", "list/update/delete registered agents", or "register an MCP server". Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, Agent Registry fleet management, and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment (use google-agents-cli-deploy).
google-agents-cli-eval
google/agents-cli
This skill should be used when the user wants to "run an evaluation", "evaluate my agent", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Gemini platform eval methodology and the Quality Flywheel. Covers eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Applies to any agents-cli project, whatever framework the agent is written in. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use google-agents-cli-scaffold).
skill-creator
anthropics/skills
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
codex-pet
prime-skills/runcomfy-agent-skills
Codex Pet generator on RunComfy. Build a Codex-compatible Codex Pet spritesheet.webp + pet.json from a single reference image, drop it into ${CODEXHOME:-$HOME/.codex}/pets/ / and Codex picks it up as a custom Codex Pet next to the 8 built-ins. This skill produces the exact Codex Pet atlas Codex expects (1536x1872 PNG/WebP, 8 cols x 9 rows, 192x208 cells, 9 animation states — idle, running-right, running-left, waving, jumping, failed, waiting, running, review). Calls OpenAI GPT Image 2 edit ONCE via the local RunComfy CLI as runcomfy run openai/gpt-image-2/edit to produce a canonical Codex Pet pose, then assembles all 9 animation rows programmatically with ImageMagick micro-transforms — no Codex Pro, no $imagegen, no OPENAIAPIKEY required, only RUNCOMFYTOKEN. Triggers on "codex pet", "create codex pet", "make codex pet", "hatch codex pet", "/hatch image", "desktop pet codex", "codex pets", "spritesheet.webp", or any explicit ask to build a custom pet for OpenAI Codex.
full-output-enforcement
leonxlnx/taste-skill
Overrides default LLM truncation behavior. Enforces complete code generation, bans placeholder patterns, and handles token-limit splits cleanly. Apply to any task requiring exhaustive, unabridged output.
executing-plans
obra/superpowers
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available