CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

netalertx-scan-pipeline

NetAlertX scan pipeline internals — process_scan() call order and why it's load-bearing, CurrentScan/Events/Sessions/DevicesView relationships, the Events-to-Sessions pairing mechanism, and the FIELD_SPECS field-write authority system. Use this when modifying server/scan/session_events.py or server/scan/device_handling.py, or reasoning about device presence, connect/disconnect events, or session timelines.

69

Quality

87%

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 scan-pipeline 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 dense, expert-level architecture skill with near-perfect information density and fully actionable do/don't directives tied to named functions and files. Its weaknesses are minor: a duplicated/misordered gotcha number, one passage re-teaching generic SQL scoping, and missing fix-and-retry loops around the existing validation advice.

Suggestions

Fix the Gotchas list numbering: item 8 (LatestEventsPerMAC) is followed by a second item numbered 7 (MAC-keyed tables), then 9 — renumber so the list is strictly ordered.

Trim the generic SQL scoping explanation in Gotcha 8 (innermost-scope resolution) to a one-line reminder and keep only the codebase-specific binding behavior and fix.

Consider moving the longest gotchas (6 and 8) into a references/ file linked from the Gotchas section, keeping one-line summaries inline to reduce SKILL.md body length.

DimensionReasoningScore

Conciseness

Nearly every sentence carries non-obvious, codebase-specific load ("Treat it as a materialized query result, not a live connection state machine"), with no concept-introduction padding. Not 5: Gotcha 8 re-explains generic SQL name-resolution scoping Claude already knows, and Gotchas 6 and 8 are run-on paragraphs that could be tightened.

4 / 5

Actionability

As an instruction-only skill it is fully actionable: exact directives with named functions and files ("To close a session, insert the right Events row — never mutate Sessions directly", "reject a bare mac_column outright", "don't design around these tables ever becoming devGUID-keyed"). Per the code-vs-instruction scoring note, absence of code is not penalized when guidance is this concrete.

5 / 5

Workflow Clarity

The 14-step process_scan() call order is explicitly sequenced with per-step rationale and ordering constraints ("step 2 reads this as 'previous' on the next cycle"), plus validation directives ("Check any new query here with EXPLAIN QUERY PLAN at a realistic row count", CI drift-guard test). Not 5: no fix-and-retry feedback loop ties the checkpoints into an error-recovery path.

4 / 5

Progressive Disclosure

Good structure: a Scope section, well-labeled sections, and explicit cross-navigation to sibling skills ("database-patterns", "plugin-development") one level deep. Not 5: the body exceeds 50 lines with some gotcha detail (6 and 8) that could live in a reference file, and the Gotchas list has a numbering defect — two items numbered "7", the second appearing out of order after "8".

4 / 5

Total

17

/

20

Passed

Description

88%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: concrete what-list, explicit file-level and reasoning-level trigger clauses, and a clearly delimited niche. Its only weaknesses are incomplete natural-term coverage and minor overlap with the sibling database-patterns skill on field-authority and presence triggers.

DimensionReasoningScore

Specificity

The description lists four concrete, named coverage areas: "process_scan() call order and why it's load-bearing, CurrentScan/Events/Sessions/DevicesView relationships, the Events-to-Sessions pairing mechanism, and the FIELD_SPECS field-write authority system" — comprehensive and specific. Anchor 4 ("minor gaps in coverage") fits less well since no listed area is vague or missing.

5 / 5

Completeness

Both what and when are explicit and concrete: the four-part what list plus "Use this when modifying server/scan/session_events.py or server/scan/device_handling.py, or reasoning about device presence..." matches the anchor-5 pattern exactly. Not 4, since the when-clause is neither implicit nor underspecified.

5 / 5

Trigger Term Quality

Good keyword coverage including the two concrete file paths ("server/scan/session_events.py", "server/scan/device_handling.py") and natural phrases ("device presence, connect/disconnect events, or session timelines"). Not 5: common variations a user might say — "device down", "online/offline", "NIC", or bare table names like `Devices` — are absent.

4 / 5

Distinctiveness Conflict Risk

The niche is clearly delimited (named app, two named source files), but "FIELD_SPECS field-write authority system" and "reasoning about device presence" overlap the companion `database-patterns` skill's domain — the body itself calls FIELD_SPECS "the scan-pipeline-local half" of that system. Minor overlap risk with a closely related skill → anchor 4, not 5.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

netalertx/NetAlertX

Path

.github/skills/scan-pipeline/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.