Performance Auditor
by Spectaculous-Code
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.
Skill Details
Repository Files
9 files in this skill directory
name: performance-auditor description: 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.
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
Related Skills
Xlsx
Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas
Clickhouse Io
ClickHouse database patterns, query optimization, analytics, and data engineering best practices for high-performance analytical workloads.
Clickhouse Io
ClickHouse database patterns, query optimization, analytics, and data engineering best practices for high-performance analytical workloads.
Analyzing Financial Statements
This skill calculates key financial ratios and metrics from financial statement data for investment analysis
Data Storytelling
Transform data into compelling narratives using visualization, context, and persuasive structure. Use when presenting analytics to stakeholders, creating data reports, or building executive presentations.
Kpi Dashboard Design
Design effective KPI dashboards with metrics selection, visualization best practices, and real-time monitoring patterns. Use when building business dashboards, selecting metrics, or designing data visualization layouts.
Dbt Transformation Patterns
Master dbt (data build tool) for analytics engineering with model organization, testing, documentation, and incremental strategies. Use when building data transformations, creating data models, or implementing analytics engineering best practices.
Sql Optimization Patterns
Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries. Use when debugging slow queries, designing database schemas, or optimizing application performance.
Anndata
This skill should be used when working with annotated data matrices in Python, particularly for single-cell genomics analysis, managing experimental measurements with metadata, or handling large-scale biological datasets. Use when tasks involve AnnData objects, h5ad files, single-cell RNA-seq data, or integration with scanpy/scverse tools.
Xlsx
Spreadsheet toolkit (.xlsx/.csv). Create/edit with formulas/formatting, analyze data, visualization, recalculate formulas, for spreadsheet processing and analysis.