r3f-best-practices SKILL.md skillA

r3f-best-practices from zebbern/claude-code-guide is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add zebbern/claude-code-guide/r3f-best-practices@v1.1.0

Pins v1.1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
zebbern/claude-code-guide
Path
skills/r3f-best-practices/SKILL.md
Versions recorded
2
Latest version
v1.1.0, committed Oct 30, 2026
First version recorded
May 31, 2026
Size
8,128 bytes
Repository stars
4,700
License
MIT

React Three Fiber (R3F) and Poimandres ecosystem best practices. Use when writing, reviewing, or optimizing R3F code. Triggers on tasks involving @react-three/fiber, @react-three/drei, zustand, @react-three/postprocessing, @react-three/rapier, or leva.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# React Three Fiber Best Practices

Comprehensive guide for React Three Fiber and the Poimandres ecosystem. Contains 70+ rules across 12 categories, prioritized by impact.

## Sources & Credits

> Additional tips from [100 Three.js Tips](https://www.utsubo.com/blog/threejs-best-practices-100-tips) by [Utsubo](https://www.utsubo.com)

## When to Apply

Reference these guidelines when:
- Writing new R3F components
- Optimizing R3F performance (re-renders are the #1 issue)
- Using Drei helpers correctly
- Managing state with Zustand
- Implementing post-processing or physics

## Ecosystem Coverage

- **@react-three/fiber** - React renderer for Three.js
- **@react-three/drei** - Useful helpers and abstractions
- **@react-three/postprocessing** - Post-processing effects
- **@react-three/rapier** - Physics engine
- **zustand** - State management
- **leva** - Debug GUI

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Performance & Re-renders | CRITICAL | `perf-` |
| 2 | useFrame & Animation | CRITICAL | `frame-` |
| 3 | Component Patterns | HIGH | `component-` |
| 4 | Canvas & Setup | HIGH | `canvas-` |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zebbern/claude-code-guide/r3f-best-practices@sha256:14dba97580413308

The line at the top of this page pins the label v1.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jwiswnmmsw7ao54v.svg)](https://markdownregistry.com/a/art_jwiswnmmsw7ao54v)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between May 31, 2026 and Oct 30, 2026, about one every 151 days.

versioncommittedcommitsizeaudit
v1.1.0 latest2026-10-30 b4ce602 8,128 BA view · diff
v1.1.02026-05-31 164971d 8,028 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8128 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

zebbern/claude-code-guide · 4,700 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jwiswnmmsw7ao54v
GET https://markdownregistry.com/api/v1/resolve?ref=zebbern/claude-code-guide/r3f-best-practices
GET https://markdownregistry.com/api/v1/blob/14dba975804133081237f92de6afe32baa9bed95d8f1a015f842a526ef659155

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from zebbern/claude-code-guide

academic-paper-reviewer SKILL.md skill
zebbern/claude-code-guide · skills/academic-paper-reviewer/SKILL.md · Simulates academic peer review, evaluating papers across Originality, Methodology, Results, and Writing to provide…
git:20260531.164971d · audit A · 4,700 stars
active-directory-attacks SKILL.md skill
zebbern/claude-code-guide · skills/active-directory-attacks/SKILL.md · This skill should be used when the user asks to "attack Active Directory", "exploit AD", "Kerberoasting", "DCSync"…
v1.1 · audit A · 4,700 stars
api-fuzzing-bug-bounty SKILL.md skill
zebbern/claude-code-guide · skills/api-fuzzing-bug-bounty/SKILL.md · This skill should be used when the user asks to "test API security", "fuzz APIs", "find IDOR vulnerabilities", "test…
v1.1 · audit C · 4,700 stars
api-shape-explorer SKILL.md skill
zebbern/claude-code-guide · skills/api-shape-explorer/SKILL.md · Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to…
git:20260531.164971d · audit A · 4,700 stars
audit-flow SKILL.md skill
zebbern/claude-code-guide · skills/audit-flow/SKILL.md · Interactive system flow tracing across CODE, API, AUTH, DATA, NETWORK layers with SQLite persistence and Mermaid…
v1.0.0 · audit A · 4,700 stars
authentication-patterns SKILL.md skill
zebbern/claude-code-guide · skills/authentication-patterns/SKILL.md · Authentication patterns: session vs JWT vs OAuth comparison, provider selection (NextAuth, Clerk, Supabase Auth)…
git:20260531.164971d · audit A · 4,700 stars
aws-penetration-testing SKILL.md skill
zebbern/claude-code-guide · skills/aws-penetration-testing/SKILL.md · This skill should be used when the user asks to "pentest AWS", "test AWS security", "enumerate IAM", "exploit cloud…
v1.1 · audit B · 4,700 stars
broken-authentication SKILL.md skill
zebbern/claude-code-guide · skills/broken-authentication/SKILL.md · This skill should be used when the user asks to "test for broken authentication vulnerabilities", "assess session…
v1.1 · audit A · 4,700 stars
burp-suite-testing SKILL.md skill
zebbern/claude-code-guide · skills/burp-suite-testing/SKILL.md · This skill should be used when the user asks to "intercept HTTP traffic", "modify web requests", "use Burp Suite for…
v1.1 · audit B · 4,700 stars
caching SKILL.md skill
zebbern/claude-code-guide · skills/caching/SKILL.md · Caching strategies — invalidation, TTL guidelines, cache keys, cache layers, and when not to cache. Use when…
git:20260531.164971d · audit A · 4,700 stars
chart-image SKILL.md skill
zebbern/claude-code-guide · skills/chart-image/SKILL.md · Generate publication-quality PNG chart images from data, supporting line, bar, area, candlestick, pie, and heatmap…
v2.5.1 · audit A · 4,700 stars
cloud-penetration-testing SKILL.md skill
zebbern/claude-code-guide · skills/cloud-penetration-testing/SKILL.md · This skill should be used when the user asks to "perform cloud penetration testing", "assess Azure or AWS or GCP…
v1.1 · audit C · 4,700 stars

Every file in zebbern/claude-code-guide

Browse by kind, by grade A, or by owner.