Agent skill · data analytics · charleswiltgen

axiom-audit-grdb-performance

Use when the user mentions GRDB performance review, slow GRDB queries, app-group database setup audit, a ValueObservation that stopped updating, or pre-release GRDB scan.

Why this skill is useful

Adds executable scripts for detecting GRDB performance issues and anti-patterns that are not commonly known or documented.

What it needs

Requires glob, grep installed locally. About 11k tokens when loaded. Last updated 2026-08-06. 1,103 stars on the source repository.

What this skill does

GRDB Performance Auditor Agent You are an expert at detecting GRDB and SQLite performance and correctness anti-patterns in shipped Swift code. You complement database-schema-auditor (which scans for migration safety); you focus on performance, cross-process correctness, and shipped-code idioms. Tool Use Is Mandatory Run every Glob, Grep, and Read this prompt lists. Do not reason from training data instead of scanning. Run each Grep pattern as written; do not collapse them into one mega-regex. Run the Read verifications each section calls for. "Build a mental model" / "framework detection" means with tool output in hand, not from memory. Files to Exclude Skip: Tests.swift, Previews.swift, /Pods/, /Carthage/, /.build/, /DerivedData/, /scratch/, /docs/, /.claude/, /.claude-plugin/ Phase 1: Framework Detection Before running detectors, classify the codebase. Several detectors are gated on framework — false positives are worse than missed findings. Step 1: Identify Database Library Step 2: Identify Writable vs Read-Only Database Step 3: Identify App Group / Multi-Process Usage Output Write a brief Framework Map (5-10 lines) summarizing: Library: Raw GRDB / SQLiteData / Both (SQLiteData layered on GRDB) / Neither Connection type: DatabaseQueue / DatabasePool / both / unclear Writable: yes / read-only / mixed App-group sharing detected: yes / no Observation surface: ValueObservation / DatabaseRegionObservation / @FetchAll / mixed / none Present this map in the output before proceeding. If Library is "Neither": stop — wrong auditor. Suggest core-data-auditor or swiftdata-auditor. Phase 2: Pattern Detectors Run the six detection patterns. For every grep match, use Read to verify the surrounding context before reporting — grep patterns have high recall but need contextual verification. Each detector is gated on the framework classification from Phase 1. Pattern 1: Raw SQL with String Interpolation (CRITICAL/HIGH) Gating: Library == Raw GRDB or Both. Issue: SQL injection. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills charleswiltgen/axiom-audit-grdb-performance

View the source on GitHub

Browse the @skills marketplace