CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-navigation

Reference for the NetAlertX codebase structure, key file paths, and configuration locations. Use this when exploring the codebase or looking for specific components like the backend entry point, frontend files, or database location.

76

Quality

95%

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

100%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 exemplary lean reference skill: compact lookup tables, concrete paths and env vars, no filler or re-explanation of known concepts, and pointers to existing project docs instead of duplicating them. Nothing in the body is vague or padded. No changes needed.

DimensionReasoningScore

Conciseness

The body is pure lookup tables with zero padding — every row is a path, env var, or doc pointer that Claude cannot know without this file. The single prose line (the architecture summary) is project-specific knowledge, not a concept Claude already knows. This matches anchor 5 (lean, every token earns its place) and is well above anchor 4.

5 / 5

Actionability

Every entry is a concrete, copy-paste-usable path or environment variable name, covering the common lookup cases (backend entry, frontend files, database, logs, config, plugin locations, docs). Per the scoring notes, an instruction-only skill without code is not penalized when the guidance is actionable — here the paths are directly actionable for navigation. Matches anchor 5; anchor 4 would require missing key details, and none are evident.

5 / 5

Workflow Clarity

This is a simple, single-purpose skill (path/config lookup) with an unambiguous single action, and it involves no destructive or batch operations, so the simple-skill exception applies and workflow clarity can score 5. The single action — consult the tables — is unambiguous, and grouping is logically organized (source paths, runtime paths, env vars, docs).

5 / 5

Progressive Disclosure

The skill is under 50 content lines, needs no external reference files (none exist in references/, scripts/, or assets/), and is organized into well-labeled sections. It also points to existing project documentation (docs/PLUGINS_DEV.md, docs/SETTINGS_SYSTEM.md) rather than inlining it — one-level-deep, clearly signaled pointers. This matches anchor 5 under the simple-skill exception.

5 / 5

Total

20

/

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 what the skill references, when to use it, and is tightly scoped to a named project, making false triggers unlikely. The what/when clauses are explicit and concrete. Minor room for improvement in natural-language synonym coverage and mentioning the full breadth of the body's coverage (plugins, docs).

Suggestions

Add a few more natural trigger synonyms users would actually say, e.g. "navigating the project", "where is X", or "find the config/database/logs".

Mention additional high-value lookups the body actually covers (plugins, workflows, documentation) so the description's coverage matches the content.

DimensionReasoningScore

Specificity

The description lists several specific content areas ("codebase structure, key file paths, and configuration locations") and concrete examples ("backend entry point, frontend files, or database location"), but coverage has minor gaps — plugins, workflows, and docs (covered in the body) are not mentioned. It fits anchor 4 (several specifics, minor gaps) rather than 5 (comprehensive) and is well above anchor 3 (only 1-2 concrete actions).

4 / 5

Completeness

It explicitly answers both: "what" ("Reference for the NetAlertX codebase structure, key file paths, and configuration locations") and "when" ("Use this when exploring the codebase or looking for specific components like...") with concrete trigger phrases. This is a direct match for anchor 5; anchor 4 would require the when-clause to be less explicit.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present ("exploring the codebase", "looking for specific components", "backend entry point", "database location"), but a few common variations are missing (e.g., "navigate the project", "where is the config", "project structure"). This matches anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's synonym-and-extension completeness.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to the named project "NetAlertX" with project-specific triggers (backend entry point, database location), giving it a clear niche and minimal conflict risk with generic skills. It matches anchor 5; third-person voice is used consistently, so no voice penalty applies.

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/project-navigation/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.