agent-skills

Opinionated agent skills for Claude Code, Cursor, Codex, OpenCode, and any other agent that speaks the skills.sh format. Each skill captures conventions distilled from shipping a real production codebase — not theory, not blog posts.

Available skills

Skill What it does
tanstack-query-best-practices Production conventions for TanStack Query v5: per-feature folder split, queryOptions() key factories with a "Constants" prefix for broad invalidation, shared QueryConfig / MutationConfig type helpers, optimistic-update lifecycle. Bundles the rule-by-rule tanstack-query-best-practices skill by @DeckardGer.
react-native-unistyles-conventions Production conventions for react-native-unistyles v3: Tailwind-style theme scales, dynamic-function styling, gap-over-margin, RTL handling, borderCurve pairing, gradients via experimental_backgroundImage. Bundles the upstream v3 skill by @jpudysz.
implementing-legend-state Implement Legend-State v3 as the primary state layer in React / React Native: useValue over observer, function computeds, mutate-don't-clone, fine-grained For/Show/Memo, local persistence (MMKV/AsyncStorage/localStorage/IndexedDB), and remote sync (synced/syncedCrud/Supabase). Includes a deprecated-pattern auditor and migration guides from v2 / Zustand / Redux.
expo-ui-full-reference Complete reference for @expo/ui — real SwiftUI on iOS and Jetpack Compose on Android from React. The Host island mental model (no Yoga inside a Host), universal vs platform-specific vs drop-in layer decision tree, full SwiftUI/Compose modifier catalogs, copy-paste screen templates, and tooling to enumerate installed components and audit flexbox-on-Host mistakes. Keyed to SDK 56.

Install

# Interactive — pick one or many
npx skills add AlshehriAli0/agent-skills

# Specific skill, globally
npx skills add AlshehriAli0/agent-skills@<skill-name> -g

The CLI auto-detects your agent (Claude Code, Cursor, Codex, OpenCode, …). See the skills CLI docs for all flags.

Repository layout

.
├── README.md                                       # this file
├── LICENSE
└── skills/
    ├── tanstack-query-best-practices/
    │   ├── SKILL.md
    │   ├── README.md
    │   ├── references/                             # deep dives + bundled upstream
    │   └── examples/                               # real-world TS files
    ├── react-native-unistyles-conventions/
    │   ├── SKILL.md
    │   ├── README.md
    │   └── references/                             # deep dives + bundled upstream
    ├── implementing-legend-state/
    │   ├── SKILL.md
    │   ├── README.md
    │   ├── references/                             # per-task deep dives
    │   ├── assets/                                 # copy-paste templates
    │   └── scripts/                                # deprecated-pattern auditor
    └── expo-ui-full-reference/
        ├── SKILL.md
        ├── README.md
        ├── references/                             # per-layer deep dives + modifier catalogs
        ├── assets/                                 # copy-paste screen templates
        └── scripts/                                # list-components + flexbox/import auditor

Each skill stands on its own — read its own README for skill-specific install commands, what it triggers on, and the conventions it teaches.

Contributing

Issues and PRs welcome. Keep changes focused on production-tested patterns rather than personal preference — if a rule has bitten you in real code, document the incident in the convention's "Why" rationale.

License

MIT — see LICENSE. Each skill's references/upstream/ directory bundles material from external authors with attribution; see the per-skill references/upstream/README.md files for credits.