# app-renderer-systems

The app-renderer-systems skill structures frontend modules in systems/ directories with clear layers: adapters, Query hooks, local state, and public exports.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 299 installs · ★ 655 repo stars
- Author: Pedro Nauck
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/app-renderer-systems/SKILL.md
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/app-renderer-systems

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill app-renderer-systems -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/app-renderer-systems/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/app-renderer-systems/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill app-renderer-systems -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/app-renderer-systems/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill app-renderer-systems -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/app-renderer-systems/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedronauck/skills skills/mine/app-renderer-systems
```

2. **Manually: put the files in place**
- File: `.github/skills/app-renderer-systems/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill app-renderer-systems -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pedronauck/skills --path skills/mine/app-renderer-systems
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/app-renderer-systems/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill app-renderer-systems -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/app-renderer-systems/SKILL.md

## When to use it
- 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
- 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

## Similar
- [vite-react-best-practices](https://affpapa.org/en/nevibecode/skills/vite-react-best-practices.md) — skill · 670 installs
- [tanstack-query](https://affpapa.org/en/nevibecode/skills/tanstack-query-2.md) — skill · 587 installs
- [xstate-v5](https://affpapa.org/en/nevibecode/skills/xstate-v5.md) — skill · 546 installs
- [frontend-app-builder](https://affpapa.org/en/nevibecode/skills/frontend-app-builder.md) — skill · 252 installs
- [nextjs-app-router-expert](https://affpapa.org/en/nevibecode/skills/nextjs-app-router-expert.md) — skill · 176 installs
- [correctness-and-error-handling](https://affpapa.org/en/nevibecode/skills/correctness-and-error-handling.md) — skill · 1900 installs

From the same set: [pedronauck/skills](https://affpapa.org/en/nevibecode/by/pedronauck/skills.md) — 52 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
