common-pitfalls
Orchestrates pitfall prevention skills for common development issues. Auto-triggered during code review to check for TanStack Query, Drizzle ORM, Express API, React, WebSocket, blockchain RPC, and security pitfalls.
Best use case
common-pitfalls is best used when you need a repeatable AI agent workflow instead of a one-off prompt. It is especially useful for teams working in multi. Orchestrates pitfall prevention skills for common development issues. Auto-triggered during code review to check for TanStack Query, Drizzle ORM, Express API, React, WebSocket, blockchain RPC, and security pitfalls.
Orchestrates pitfall prevention skills for common development issues. Auto-triggered during code review to check for TanStack Query, Drizzle ORM, Express API, React, WebSocket, blockchain RPC, and security pitfalls.
Users should expect a more consistent workflow output, faster repeated execution, and less time spent rewriting prompts from scratch.
Practical example
Example input
Use the "common-pitfalls" skill to help with this workflow task. Context: Orchestrates pitfall prevention skills for common development issues. Auto-triggered during code review to check for TanStack Query, Drizzle ORM, Express API, React, WebSocket, blockchain RPC, and security pitfalls.
Example output
A structured workflow result with clearer steps, more consistent formatting, and an output that is easier to reuse in the next run.
When to use this skill
- Use this skill when you want a reusable workflow rather than writing the same prompt again and again.
When not to use this skill
- Do not use this when you only need a one-off answer and do not need a reusable workflow.
- Do not use it if you cannot install or maintain the related files, repository context, or supporting tools.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/common-pitfalls/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How common-pitfalls Compares
| Feature / Agent | common-pitfalls | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Orchestrates pitfall prevention skills for common development issues. Auto-triggered during code review to check for TanStack Query, Drizzle ORM, Express API, React, WebSocket, blockchain RPC, and security pitfalls.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
Cursor vs Codex for AI Workflows
Compare Cursor and Codex for AI coding workflows, repository assistance, debugging, refactoring, and reusable developer skills.
SKILL.md Source
# Common Pitfalls Prevention Orchestrates specialized pitfall prevention skills learned from production issues. Use during code review to automatically check for common mistakes. ## When to Use - During code review (auto-triggered by full-review skill) - Before committing changes - When debugging production issues - Reviewing unfamiliar code patterns ## Workflow ### Step 1: Identify Code Categories Based on changed files, determine which sub-skills to invoke: | File Pattern | Sub-Skill | |-------------|-----------| | `**/hooks/**`, `useQuery`, `useMutation` | pitfalls-tanstack-query | | `**/db/**`, `schema.ts`, `drizzle` | pitfalls-drizzle-orm | | `**/routes/**`, `router.`, `app.` | pitfalls-express-api | | `**/components/**`, `**/pages/**`, `.tsx` | pitfalls-react | | `websocket`, `wss`, `ws.` | pitfalls-websocket | | `contract`, `rpc`, `multicall`, `gas` | pitfalls-blockchain | | `session`, `key`, `cache`, `log` | pitfalls-security | ### Step 2: Invoke Relevant Sub-Skills For each category found, invoke the corresponding skill for detailed patterns. ### Step 3: Generate Combined Report Aggregate findings from all invoked sub-skills. ## Sub-Skills Reference | Skill | Focus Area | |-------|------------| | **pitfalls-tanstack-query** | Query keys, invalidation, v5 patterns | | **pitfalls-drizzle-orm** | Schema types, migrations, array columns | | **pitfalls-express-api** | Routes, status codes, storage patterns | | **pitfalls-react** | Components, forms, a11y, responsive | | **pitfalls-websocket** | Server setup, heartbeat, reconnection | | **pitfalls-blockchain** | RPC errors, gas, multicall, nonces | | **pitfalls-security** | Session keys, caching, logging, secrets | ## Quick Reference Checklist ### Core - [ ] TanStack Query keys use full URL paths - [ ] Mutations invalidate relevant queries - [ ] Drizzle types exported for all models - [ ] API routes return correct status codes - [ ] All RPC calls wrapped in try/catch - [ ] WebSocket has heartbeat/reconnection - [ ] React components handle loading/error states - [ ] No secrets in logs or frontend code ### Type Safety - [ ] No `any` types - use `unknown` and narrow - [ ] Types inferred from schema ($inferSelect, z.infer) - [ ] Type guards for runtime validation ### Financial - [ ] BigInt for all token amounts - [ ] Decimal.js for price calculations - [ ] Proper rounding (floor/ceil) ### Blockchain - [ ] Gas estimation with buffer - [ ] EIP-1559 gas pricing - [ ] Transaction simulation before send - [ ] Multicall uses `allowFailure: true` ### Security - [ ] Session keys have expiry and limits - [ ] AES-256-GCM for stored credentials - [ ] Audit logging for sensitive operations - [ ] Rate limiting with exponential backoff
Related Skills
azure-communication-common-java
Azure Communication Services common utilities for Java. Use when working with CommunicationTokenCredential, user identifiers, token refresh, or shared authentication across ACS services.
datacommons-client
Work with Data Commons, a platform providing programmatic access to public statistical data from global sources. Use this skill when working with demographic data, economic indicators, health statistics, environmental data, or any public datasets available through Data Commons. Applicable for querying population statistics, GDP figures, unemployment rates, disease prevalence, geographic entity resolution, and exploring relationships between statistical entities.
pitfalls-websocket
WebSocket server and client patterns with heartbeat and reconnection. Use when implementing real-time features, debugging connection issues, or reviewing WebSocket code. Triggers on: WebSocket, wss, heartbeat, reconnect, real-time.
pitfalls-tanstack-query
TanStack Query v5 patterns and common pitfalls. Use when implementing data fetching, cache invalidation, or debugging stale data issues. Triggers on: useQuery, useMutation, queryKey, invalidate, TanStack, React Query.
pitfalls-security
Security patterns for session keys, caching, logging, and environment variables. Use when implementing authentication, caching sensitive data, or setting up logging. Triggers on: session key, private key, cache, logging, secrets, environment variable.
pitfalls-react
React component patterns, forms, accessibility, and responsive design. Use when building React components, handling forms, or ensuring accessibility. Triggers on: React component, useEffect, form validation, a11y, responsive, Error Boundary.
pitfalls-blockchain
Blockchain RPC error handling, gas estimation, multi-chain config, and transaction management. Use when interacting with smart contracts, estimating gas, or managing transactions. Triggers on: RPC, contract call, gas, multicall, nonce, transaction, revert.
pitfalls-express-api
Express API conventions and storage patterns. Use when building REST APIs, defining routes, or implementing storage interfaces. Triggers on: Express, router, API route, status code, storage interface.
pitfalls-drizzle-orm
Drizzle ORM patterns and migration safety rules. Use when defining schemas, running migrations, or debugging database issues. Triggers on: Drizzle, schema, migration, db:push, $inferSelect, array column.
azure-quotas
Check/manage Azure quotas and usage across providers. For deployment planning, capacity validation, region selection. WHEN: "check quotas", "service limits", "current usage", "request quota increase", "quota exceeded", "validate capacity", "regional availability", "provisioning limits", "vCPU limit", "how many vCPUs available in my subscription".
raindrop-io
Manage Raindrop.io bookmarks with AI assistance. Save and organize bookmarks, search your collection, manage reading lists, and organize research materials. Use when working with bookmarks, web research, reading lists, or when user mentions Raindrop.io.
zlibrary-to-notebooklm
自动从 Z-Library 下载书籍并上传到 Google NotebookLM。支持 PDF/EPUB 格式，自动转换，一键创建知识库。