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.

Stars 0
Forks 0

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

  1. Identify your performance issue (database, frontend, AI, or N+1)
  2. Read the appropriate reference file above
  3. Run SQL scripts or code patterns from scripts/ if needed
  4. Check references/learnings.md if results seem unexpected

Key Tools

  • Database analysis: Read references/sql-queries.md then run scripts/analyze-queries.sql
  • N+1 detection: See references/n+1-detection.md and scripts/detect-n+1.js
  • Cache optimization: See references/react-query-patterns.md for staleTime/gcTime strategy
  • AI monitoring: See references/ai-monitoring.md for latency and cost tracking

Context Files

For codebase structure reference:

  • Docs/context/db-schema-short.md - Database tables and indexes
  • Docs/context/supabase-map.md - Edge functions to monitor

Expand your agent's capabilities with these related and highly-rated skills.

Spectaculous-Code/raamattu-nyt

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.

0 0
Explore
Spectaculous-Code/raamattu-nyt

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.

0 0
Explore
Spectaculous-Code/raamattu-nyt

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.

0 0
Explore
Spectaculous-Code/raamattu-nyt

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.

0 0
Explore
Spectaculous-Code/raamattu-nyt

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.

0 0
Explore
Spectaculous-Code/raamattu-nyt

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.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results