CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plugin-development

Create and run NetAlertX plugins. Use this when asked to create a plugin, run a plugin, test a plugin, or develop plugin functionality.

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 strong, information-dense skill body: every section carries non-obvious project-specific gotchas rather than general knowledge, with concrete commands, precedent examples, and deferred deep-dive docs. The main improvement opportunities are tightening repeated doc references, making the data-contract snippet fully executable, and moving the specialized caching section into a referenced doc.

DimensionReasoningScore

Conciseness

Dense and repo-specific throughout — RUN_TIMEOUT kill semantics, dataType/default_value JSON-literal requirement, Python id-reuse cache gotcha — with zero conceptual padding; only minor redundancy (docs/PLUGINS_DEV.md referenced three times) keeps it below the leanest anchor.

4 / 5

Actionability

Concrete run command, result-file path, structure tree, named precedent plugins (arp_scan, rest_import, pihole_api_scan) and a mechanical test to run; the data-contract snippet's 'add_object(...)' ellipsis is pseudocode, deferring to the full spec doc — a minor gap versus copy-paste-ready.

4 / 5

Workflow Clarity

A five-step Expected Workflow with a result-retrieval checkpoint, plus PR-time validation (run test/plugins/test_plugin_conventions.py after touching a plugin) and a conventions checklist; it lacks an explicit fix-and-retry feedback loop in the main workflow, so it sits at 'clear sequence with most checkpoints' rather than the top anchor.

4 / 5

Progressive Disclosure

No bundle files exist; bulk detail is deferred to one-level-deep, clearly signaled docs (PLUGINS_DEV_DATA_CONTRACT.md, PLUGINS_IMPORT_BEHAVIOR.md, field-sanitization anchor) with a well-sectioned overview body. Minor gaps: the all_plugins caching deep-dive is inlined rather than referenced, and relative links like ../../../docs/PLUGINS_DEV.md are awkward.

4 / 5

Total

16

/

20

Passed

Description

83%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 concise, well-formed description that clearly states both capability and explicit trigger conditions in the style of the reference good examples. Scoring high across all dimensions, with only minor gaps: trigger synonyms are thin and the unqualified 'plugin' trigger phrases carry slight conflict risk with generic plugin-dev skills.

DimensionReasoningScore

Specificity

Names the domain ('NetAlertX plugins') and several concrete actions — 'Create', 'run', plus 'test' and 'develop' in the trigger clause — matching the anchor for several specific actions with minor gaps in coverage (e.g., modifying an existing plugin is only implied by 'develop plugin functionality').

4 / 5

Completeness

Explicitly answers both what ('Create and run NetAlertX plugins') and when ('Use this when asked to create a plugin, run a plugin, test a plugin, or develop plugin functionality') with concrete trigger phrases, matching the top anchor and the good-overall example pattern.

5 / 5

Trigger Term Quality

Natural phrases users would say — 'create a plugin', 'run a plugin', 'test a plugin' — give good keyword coverage, but common variations like 'build/write a plugin' or 'extension' are missing, so it falls short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'NetAlertX' pins a clear niche with distinct product-scoped triggers, but the when-clause phrases ('asked to create a plugin') are unqualified and generically 'plugin', leaving minor overlap risk with other plugin-development skills.

4 / 5

Total

17

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

netalertx/NetAlertX

Path

.claude/skills/plugin-development/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.