app-renderer-systems — Claude Code skill: organize frontend by domain
The app-renderer-systems skill structures frontend modules in systems/ directories with clear layers: adapters, Query hooks, local state, and public exports.
no license 299 installs ★ 655 updated 2026-10-20
npx skills add pedronauck/skills --skill app-renderer-systems -a claude-codeWhat app-renderer-systems does
The skill outlines how to build frontend code within a domain system. Each system in systems/<domain>/ manages its slice of UI: adapters for API calls, Query hooks for data caching, local state via XState Store or context, and a public barrel for exports. Extend an existing system or add layers only when the feature requires them—a component edit does not scaffold adapters, stores, or a test suite.
Three core rules apply: dependencies flow downward (components consume hooks, hooks consume Query and adapters, adapters ignore UI); Query keys remain canonical across loaders, mutations, and stream writers; server state lives in Query, event-driven local data uses XState Store. Optimistic mutations require an explicit contract: snapshot state, restore on failure, cancel conflicting reads.
The skill references references/directory-layout.md for placement and references/patterns.md for API patterns. Related skills load conditionally: React for component and hook behavior, TanStack for Query and Router, XState for Store. Debugging guidance applies to specific failures, not routine edits.
What it helps with
- organize frontend modules by domain with distinct adapter and hook layers
- extend a system with a new feature while preserving dependency direction
- keep Query keys canonical across loaders, mutations, and cache invalidation
- add local state without unnecessary context providers
- debug a broken adapter or hook in an existing system
Example prompts for the agent
- Create a new system under
systems/payments/with adapters for payment API calls and Query hooks for caching - Extend
systems/auth/with a refresh-token hook and update the public barrel export - Fix Query key sync in
systems/orders/hooks.ts— mutation is not invalidating the orders list cache
How to install app-renderer-systems
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill app-renderer-systems -a claude-code2Manually: put the files in place
~/.claude/skills/app-renderer-systems/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/app-renderer-systems/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill app-renderer-systems -a codex2Manually: put the files in place
.agents/skills/app-renderer-systems/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill app-renderer-systems -a cursor2Manually: put the files in place
.cursor/skills/app-renderer-systems/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/mine/app-renderer-systems2Manually: put the files in place
.github/skills/app-renderer-systems/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill app-renderer-systems -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/mine/app-renderer-systemsManually: put the files in place
.devin/skills/app-renderer-systems/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill app-renderer-systems -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about app-renderer-systems
How do I install app-renderer-systems in Claude Code?
Run npx skills add pedronauck/skills --skill app-renderer-systems -a claude-code, then open ~/.claude/skills/app-renderer-systems/SKILL.md. For other platforms, replace -a with codex, cursor, gemini-cli, or opencode.
What does app-renderer-systems do?
The skill guides architecture for frontend modules organized by domain in systems/. It helps structure adapters, Query hooks, local state, and exports so dependencies flow downward and no unnecessary layers exist.
Do I need React and TanStack Query to use this skill?
The skill assumes a React project with TanStack Query for caching. If your project uses a different state manager or framework, the guidance may not apply directly.