tanstack-agent-skills: Instructions file for Codex

Agent Guidelines

This document provides instructions for AI coding agents working with the TanStack Agent Skills repository.

Repository Structure

tanstack-agent-skills/
├── skills/
│   ├── tanstack-query/
│   │   ├── SKILL.md
│   │   └── rules/
│   ├── tanstack-router/
│   │   ├── SKILL.md
│   │   └── rules/
│   ├── tanstack-start/
│   │   ├── SKILL.md
│   │   └── rules/
│   └── tanstack-integration/
│       ├── SKILL.md
│       └── rules/
├── README.md
├── AGENTS.md
└── CLAUDE.md

Skill Format

SKILL.md Structure

Each skill's main file uses YAML frontmatter:

---
name: skill-name
description: Brief description of what this skill covers
---

Followed by markdown sections:

• When to Apply
• Rule Categories by Priority
• Quick Reference
• How to Use

Rule File Naming

Rules use kebab-case with category prefixes:

• qk- — Query keys
• cache- — Caching
• mut- — Mutations
• err- — Error handling
• pf- — Prefetching
• inf- — Infinite queries
• ssr- — SSR patterns
• perf- — Performance
• ts- — Type safety
• org- — Organization
• load- — Data loading
• search- — Search params
• nav- — Navigation
• split- — Code splitting
• preload- — Preloading
• ctx- — Context
• sf- — Server functions
• sec- — Security
• mw- — Middleware
• auth- — Authentication
• file- — File organization
• deploy- — Deployment
• setup- — Setup
• flow- — Data flow

Rule File Structure

# rule-id: Rule Title

## Priority: CRITICAL | HIGH | MEDIUM | LOW

## Explanation

Why this pattern matters and what problem it solves.

## Bad Example

\`\`\`tsx
// Code showing the anti-pattern
// With comments explaining why it's bad
\`\`\`

## Good Example

\`\`\`tsx
// Code showing the recommended pattern
// With comments explaining the approach
\`\`\`

## Context

- When to apply this rule
- When to skip this rule
- Related considerations

Skill Activation

Skills should activate when agents detect:

tanstack-query

• Data fetching code (useQuery, useMutation)
• React Query imports
• Cache management patterns
• Server state handling