CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./axiom-codex/skills/axiom-audit-grdb-performance/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally actionable, well-sequenced auditor prompt — every detector is executable, gated, and verified, with strong false-positive discipline and an explicit output contract. Its weaknesses are length (trimmable Invocation/Related/Scope sections, time-sensitive GRDB version pins that will rot) and a monolithic structure that inlines reference-grade detail instead of splitting it across files.

Suggestions

Move per-pattern detail (especially Pattern 11's GRDB version table and Phase 3's completeness questions) into a reference file such as references/patterns.md, keeping SKILL.md as the phase overview plus a compact pattern index.

Trim the Invocation Examples section to 2–3 representative prompts and fold the Related and Scope sections into a brief pointer list — they restate content already covered by the body.

Isolate the time-sensitive GRDB version information (7.11.0/7.11.1 fix status, "latest", unmerged-fix notes) into a versioned, dated reference section so staleness is detectable without rereading the detector.

DimensionReasoningScore

Conciseness

The bulk is high-value operational content (grep patterns, gating, verification steps) rather than explanation of known concepts, but there is noticeable trimmable material: the five Invocation Examples, the Related and Scope sections, and per-pattern repetition of gating rules. Pattern 11 also pins time-sensitive version numbers ("7.11.0 – 7.11.1 (latest)", "still unfixed in 7.11.1") inline rather than in an old-patterns/deprecated section, which the guidelines penalize. Mostly efficient but could be tightened — anchor 3, not the lean anchor 5 nor the padded anchor 2.

3 / 5

Actionability

Every detector gives an exact search regex (e.g. `INSERT\s+OR\s+REPLACE`, `static\s+let\s+databaseSelection`), a concrete Read-verification procedure, and a copy-paste-ready fix (`execute(sql: "WHERE id = ?", arguments: [id])`, `PRAGMA journal_mode = WAL`, `config.observesSuspensionNotifications = true`). Pattern 11 even includes a version-gated decision table with the exact GRDB versions and symptom string. Fully executable guidance covering the common cases — anchor 5.

5 / 5

Workflow Clarity

The five phases (Framework Detection → Pattern Detectors → Completeness Reasoning → Cross-Reference → Health Score) are clearly sequenced, with explicit validation checkpoints throughout: "use Read to verify the surrounding context before reporting — grep patterns have high recall but need contextual verification", "Require evidence from the Phase 1 map — don't speculate", gating to suppress false positives, and an error-recovery path ("report an unresolvable GRDB version as a LOW-confidence finding with the reason, not as a clean pass"). A defined output format with output limits completes the loop — anchor 5.

5 / 5

Progressive Disclosure

There is good internal section structure and the external `axiom-data (skills/grdb-performance.md)` references are clearly signaled with section numbers one level deep, but no bundle files exist and the 26KB body is monolithic — content that would serve better in separate reference files (Pattern 11's version table, Phase 3's twelve-row completeness table, the per-pattern detail) is inlined. Anchor 3: some structure, references present, but content that should be separate is inline.

3 / 5

Total

16

/

20

Passed

Description

65%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A trigger-first description with excellent, distinctive 'when' phrasing that reads like real user utterances. Its weakness is that the skill's actual capabilities are never stated, so a user (or Claude) must infer what happens from the trigger nouns alone.

Suggestions

Lead with an explicit 'what' clause, e.g. "Detects GRDB and SQLite performance and correctness anti-patterns (raw SQL interpolation, missing FK indexes, WAL misconfiguration, observation staleness) in Swift codebases and produces a severity-scored audit report. Use when…".

Add natural trigger synonyms users might say instead of internal terms — e.g. "SQLite queries are slow", "widget shows stale data", "database locked / SQLITE_BUSY" — alongside the existing GRDB-specific phrases.

State the output explicitly (a Framework Map, severity-ranked findings, and a SAFE/FRAGILE/DANGEROUS health score) so the 'what' is concrete rather than implied.

DimensionReasoningScore

Specificity

The description names the domain ("GRDB performance review", "app-group database setup audit") and embeds action nouns like "review", "audit", and "scan", but it never explicitly states what the skill does — the capability side is inferred entirely from trigger phrasing. It sits between anchor 2 (only 'when', no 'what') and anchor 4: more concrete than anchor 2's vague example, but without the several specific actions anchor 4 requires.

3 / 5

Completeness

The 'when' is explicit and rich ("Use when the user mentions…" with five concrete triggers), but the 'what' — that the skill detects performance and correctness anti-patterns and produces a health score — is only implied by nouns inside the trigger list, never stated. This sits between anchors 2 and 4: above anchor 2 (whose 'when'-only example is vague) but below anchor 4, which requires an explicit 'what' alongside the 'when'.

3 / 5

Trigger Term Quality

Phrases like "slow GRDB queries", "a ValueObservation that stopped updating", and "pre-release GRDB scan" are natural things a user would say, giving good coverage. A few natural variations are missing — "SQLite performance", "widget database sharing", "database locked" — and "app-group database setup audit" leans toward internal jargon, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Triggers like "GRDB performance review" and "a ValueObservation that stopped updating" occupy a clear niche with distinct, technology-specific keywords; virtually no other skill would fire on them. Minimal conflict risk, matching anchor 5.

5 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

CharlesWiltgen/Axiom

Path

axiom-codex/skills/axiom-audit-grdb-performance/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.