CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

database-patterns

NetAlertX database architecture patterns. Use this when designing features that write to the Devices table, implementing audit/history logging, or choosing between trigger-based vs Python-hook approaches.

68

Quality

85%

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

76%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 reference skill: every section delivers non-obvious, app-specific knowledge with executable SQL and exact file/function pointers, and there is no padding. Its main gap is the absence of validation/verification steps for the database features it guides (capping workflow clarity at 3), and a couple of prose passages could be trimmed.

Suggestions

Add a short verification step for implemented features, e.g. test the trigger against an executemany() bulk update and confirm DevicesHistory rows carry correct changedBy attribution before considering the change done.

Tighten the devMac/devGUID section by stating the MAC limitation once (e.g. merging the "One thing that will never migrate" paragraph's reasoning into the initial rationale) to cut repeated argumentation.

Consider moving the write-path inventory table and DevicesHistory reference DDL into a references/ file (e.g. references/write-paths.md) to keep SKILL.md as a leaner overview.

DimensionReasoningScore

Conciseness

The body is dense and information-rich with no boilerplate or explanation of concepts Claude already knows — tables carry the write-path inventory and comparison efficiently. A few passages could still be tightened, e.g. the devMac/devGUID rationale ("per the maintainer it's the intended long-term durable identity, since MAC has known limits as an identifier...") and the twice-stated argument that Plugins_Objects/CurrentScan/Events are permanently MAC-keyed, so it is not quite the lean 5.

4 / 5

Actionability

Guidance is fully executable: a copy-paste-ready SQLite AFTER UPDATE trigger with WHEN guard and per-field conditional inserts, the complete DevicesHistory DDL with indexes, exact attribution expressions like COALESCE(NULLIF(NEW.devNameSource, ''), 'system'), and a concrete file/function inventory of all write paths. This covers the common implementation cases directly.

5 / 5

Workflow Clarity

Decision guidance is clear ("audit ALL write paths" up front, explicit criteria for triggers vs Python hooks, a comparison table for event-sourced vs snapshot), but the content contains no validation or verification steps — nothing about testing a trigger against executemany, verifying audit rows, or confirming attribution after implementation. Per the rubric's scoring note, database-operation guidance without validate/fix/retry feedback loops is capped at 3.

3 / 5

Progressive Disclosure

A single-file skill with clear section headers (write-path inventory, identity, attribution, trigger pattern, audit strategy, reference schema) that is easy to navigate, one level deep with no nested references. It stops short of 5 because the ~150-line body includes a write-path inventory and reference DDL that could optionally live in a references/ file to keep SKILL.md as a leaner overview.

4 / 5

Total

16

/

20

Passed

Description

87%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 states a clear capability domain, provides an explicit "Use this when" clause with three concrete triggers, and is tightly scoped to NetAlertX's database layer. The only improvement would be acknowledging the identity-migration and attribution topics, and adding a few more natural synonyms.

Suggestions

Add a brief mention of the devMac/devGUID identity and *Source attribution patterns (e.g., "or resolving device identity and field attribution") so the description covers the full skill body.

Include a couple of natural synonyms such as "change history", "SQLite triggers", or "database schema" to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists three concrete capabilities — "designing features that write to the Devices table", "implementing audit/history logging", and "choosing between trigger-based vs Python-hook approaches" — but omits the devMac/devGUID identity migration and *Source attribution topics that make up half the skill body, so coverage has minor gaps. It is above a 3 because the actions named are specific and executable rather than generic.

4 / 5

Completeness

It explicitly answers "what" ("NetAlertX database architecture patterns") and "when" ("Use this when designing features that write to the Devices table, implementing audit/history logging, or choosing between trigger-based vs Python-hook approaches") with concrete trigger phrases. Both halves are explicit and specific, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Terms like "Devices table", "audit/history logging", and "trigger-based vs Python-hook" are phrases a NetAlertX contributor would naturally say when needing this skill. It falls short of 5 because common variations such as "schema", "change history", "database triggers", or "SQLite" are absent.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a named application (NetAlertX) and its specific database internals (Devices table, audit logging, trigger vs Python-hook), giving it a clear niche with distinct triggers and minimal risk of firing for the wrong skill.

5 / 5

Total

18

/

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

.gemini/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.