CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

database-patterns

Read before designing a feature that writes to the Devices table, adding audit/history logging, or choosing between a SQLite trigger and a Python hook. Covers the full Devices write-path inventory, the FIELD_SOURCE_MAP *Source attribution system, and event-sourced vs snapshot audit logging tradeoffs.

72

Quality

90%

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

The canonical home for this skill is netalertx-database-patterns in netalertx/NetAlertX

SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

A high-quality, information-dense patterns skill: everything is non-obvious maintainer knowledge delivered as executable tables, code, and decision criteria, with zero padding about concepts Claude already knows. The remaining headroom is tightening the identity-migration prose and adding explicit validation steps (e.g., testing a new trigger against bulk executemany writes).

Suggestions

Tighten the devMac-vs-devGUID section: collapse the re-emphasis about permanently MAC-keyed columns into a single sentence so the section reads as facts rather than argument.

Add a brief validation step for new triggers, e.g., 'after adding a trigger, verify it fires on executemany bulk updates by running one scan-cycle update and checking the audit table'.

Consider moving the write-path inventory table to a one-level-deep reference file (e.g., references/write-paths.md) to keep SKILL.md a leaner overview while preserving the audit checklist.

DimensionReasoningScore

Conciseness

Nearly every token carries repo-specific, non-derivable knowledge (write-path table, FIELD_SOURCE_MAP, attribution rules, storage math) with no boilerplate explanation of concepts Claude already knows. Not 5: the devMac-vs-devGUID section spends extra prose re-emphasizing its point ("This isn't a migration gap to eventually close; it's a structural ceiling...") that could be tightened to one sentence.

4 / 5

Actionability

Fully executable artifacts: a 17-row write-path inventory with file/function/fields, the literal FIELD_SOURCE_MAP dict, concrete attribution SQL ("COALESCE(NULLIF(NEW.<field>Source, ''), 'system')"), a copy-paste AFTER UPDATE trigger with WHEN guard, and ready-to-use DevicesHistory DDL with indexes. Not 4: the code is complete and directly usable, not hint-level.

5 / 5

Workflow Clarity

A clear decision flow is present: audit ALL write paths first (with the inventory to do it), then the trigger-vs-Python-hook criteria list, then the attribution rules and pattern. Not 5: there are no explicit validation checkpoints (e.g., how to verify the write-path audit is complete or how to test a new trigger against the executemany paths). Not 3: the 'audit ALL write paths before implementing' step plus explicit when-triggers/when-hooks criteria form a coherent, well-sequenced decision process.

4 / 5

Progressive Disclosure

As a single-file skill (no references/, scripts/, or assets/ exist), it is cleanly sectioned with headers, each section scoped to one concern, and no nested-reference indirection. Not 5: the ~17-row write-path inventory table is the kind of repo-derived lookup data that could live in a one-level-deep reference file, keeping SKILL.md as a leaner overview; inline it makes the core file longer than an overview needs to be.

4 / 5

Total

17

/

20

Passed

Description

92%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 strong description: it uses third-person/declarative voice, gives an explicit 'Read before...' trigger clause with concrete conditions, and enumerates what it covers without padding. The only gap is a handful of natural synonym phrases users might use instead of the exact terms given.

DimensionReasoningScore

Specificity

"designing a feature that writes to the Devices table, adding audit/history logging, or choosing between a SQLite trigger and a Python hook" plus "Covers the full Devices write-path inventory, the FIELD_SOURCE_MAP *Source attribution system, and event-sourced vs snapshot audit logging tradeoffs" names multiple concrete capabilities that map one-to-one onto the skill's sections, with no vague filler. Not 4: coverage is comprehensive, matching the skill's actual contents rather than leaving minor gaps.

5 / 5

Completeness

Both halves are explicit: "Read before designing a feature that writes to the Devices table..." answers 'when' with concrete trigger phrases, and "Covers the full Devices write-path inventory, the FIELD_SOURCE_MAP *Source attribution system, and... tradeoffs" answers 'what'. Not 4: neither half needs more explicitness; both use concrete, specific phrasing.

5 / 5

Trigger Term Quality

Natural, likely-spoken terms are present: "Devices table", "audit/history logging", "SQLite trigger", "Python hook", "event-sourced vs snapshot". Not 5: a few natural entry phrases users might say are absent (e.g., "device history", "change log", "database schema/migration"). Not 3: keyword coverage is strong and domain-appropriate, not merely 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a specific repo artifact ("Devices table", "FIELD_SOURCE_MAP") and specific mechanisms (SQLite trigger vs Python hook), forming a clear niche with minimal overlap risk against generic database skills. Not 4: the repo-specific naming makes conflict with any other skill's triggers very unlikely.

5 / 5

Total

19

/

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

netalertx/NetAlertX

Path

.claude/skills/database-patterns/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.