Agent skill
performance-auditor
Expert assistant for monitoring and optimizing performance in the KR92 Bible Voice project. Use when analyzing query performance, optimizing database indexes, reviewing React Query caching, monitoring AI call costs, or identifying N+1 queries. Helps diagnose slow operations across database, frontend, and AI systems.
Install this agent skill to your Project
npx add-skill https://github.com/Spectaculous-Code/raamattu-nyt/tree/main/.claude/skills/performance-auditor
SKILL.md
Performance Auditor
Expert performance optimization for the Raamattu Nyt application across database, frontend, and AI systems.
Quick Start
Choose your performance concern:
- Database performance: Slow queries, missing indexes, sequential scans → See
references/sql-queries.md - React Query optimization: Caching strategy, stale times, unnecessary refetches → See
references/react-query-patterns.md - AI performance: Latency, costs, cache effectiveness → See
references/ai-monitoring.md - N+1 query detection: Finding and fixing N+1 patterns → See
references/n+1-detection.md - Optimization checklist: Complete performance audit → See
references/checklist.md - Common gotchas: Known issues and pitfalls → See
references/learnings.md
Performance Targets
Reference targets for healthy performance:
| Operation | Target |
|---|---|
| Single verse lookup | <20ms |
| Chapter load | <50ms |
| Text search | <100ms |
| AI translation | <500ms |
| Page load (FCP) | <1.5s |
| API response | <200ms |
How to Use This Skill
- Identify your performance issue (database, frontend, AI, or N+1)
- Read the appropriate reference file above
- Run SQL scripts or code patterns from
scripts/if needed - Check
references/learnings.mdif results seem unexpected
Key Tools
- Database analysis: Read
references/sql-queries.mdthen runscripts/analyze-queries.sql - N+1 detection: See
references/n+1-detection.mdandscripts/detect-n+1.js - Cache optimization: See
references/react-query-patterns.mdfor staleTime/gcTime strategy - AI monitoring: See
references/ai-monitoring.mdfor latency and cost tracking
Context Files
For codebase structure reference:
Docs/context/db-schema-short.md- Database tables and indexesDocs/context/supabase-map.md- Edge functions to monitor
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
docs-updater
Expert assistant for keeping documentation synchronized with code changes in the KR92 Bible Voice project. Use when updating API docs, maintaining architecture diagrams, syncing README, updating CLAUDE.MD, or generating documentation from code.
ai-prompt-manager
Expert assistant for managing AI prompts, features, and configuration in the KR92 Bible Voice AI system. Use when creating AI prompts, configuring AI features, managing prompt versions, setting up AI bindings, or working with AI pricing and models.
performance-auditor
Expert assistant for monitoring and optimizing performance in the KR92 Bible Voice project. Use when analyzing query performance, optimizing database indexes, reviewing React Query caching, monitoring AI call costs, or identifying N+1 queries.
edge-function-generator
Expert assistant for creating and maintaining Supabase Edge Functions for the KR92 Bible Voice project. Use when creating Edge Functions, setting up CORS, integrating shared modules, adding JWT validation, or configuring environment variables.
admin-panel-builder
Expert assistant for creating and maintaining admin panel pages in the KR92 Bible Voice project. Use when creating admin pages, building admin components, integrating with admin navigation, or adding admin features.
lint-fixer
Expert assistant for analyzing and fixing linting and formatting issues in the KR92 Bible Voice project using Biome and TypeScript. Use when fixing lint errors, resolving TypeScript issues, applying code formatting, or reviewing code quality.
Didn't find tool you were looking for?