relay-best-practices
Best practices for writing idiomatic Relay code. ALWAYS use this skill when writing or modifying React components that use Relay for data fetching. Covers fragments, queries, mutations, pagination, and common anti-patterns. Use when you see `useFragment`, `useLazyLoadQuery`, `usePreloadedQuery`, `useMutation`, `usePaginationFragment`, `graphql` template literals, `react-relay` imports, or `__generated__/*.graphql` files. Also use when asked to explain Relay concepts, debug Relay issues, or review Relay code.
Install
With your agent
Install OMGSkills skill "facebook/relay:relay-best-practices" into this agent's normal skills directory: use the OMGSkills MCP get_skill tool, install only the pinned_install commit and path, verify SKILL.md against pinned_install.skill_md_sha, and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/facebook/relay /tmp/relay && ln -s /tmp/relay/skills/relay-best-practices ~/.claude/skills/relay-best-practicesFrom README
Relay Best Practices Relay is a GraphQL client for React that enforces colocated, composable, and type-safe data fetching. Its core insight is that each component should declare exactly what data it needs via GraphQL fragments, and Relay handles the rest — fetching, caching, consistency, and updates. This skill provides opinionated guidance on which patterns to prefer. For detailed API documentation, read the relevant page from the doc map below. Documentation Relay ships LLM-friendly docs in nodemodules/relay-runtime/llm-docs/ (available after v20.1.1). For older versions, fetch the same files from https://raw.githubusercontent.com/facebook/relay/main/website/docs/. Paths below are relative to this directory ( /). Read the relevant page before writing Relay code.
More skills
feature-flags
Used when feature flag tests fail, flags need updating, understanding @gate pragmas, debugging channel-specific test...
fix
Used when you have lint errors, formatting issues, or before committing code to ensure it passes CI.
flags
Used when you need to check feature flag states, compare channels, or debug why a feature behaves differently across...