CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

alethia

Use when the user asks to run E2E tests, verify a web page, generate tests for an app, prove destructive actions are blocked, check if a UI element is visible, fill out a form, or drive a browser with natural language. Returns per-step results with safety classifications, policy decisions, DOM diffs, structured page context, and a signed audit trail.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 highly actionable, well-sequenced skill body with concrete NLP syntax, validation checkpoints, and self-repair loops for failures and blocked destructive actions. Its main weakness is organization across files: it is a single long inline document whose only external links are broken, and detail such as the grants policy belongs in a separate reference file.

Suggestions

Move the detailed grants authorization policy and the reason-code table into a reference file inside the skill bundle (e.g. references/grants.md) and link to it, keeping SKILL.md as a concise overview.

Fix or remove the dangling links to ../../docs/index.md and ../../rules/alethia.md — these files do not exist relative to the skill directory.

Trim editorial lines that do not change agent behavior, such as 'This is the primitive that makes Alethia a verifiable-safety framework, not just a test runner'.

DimensionReasoningScore

Conciseness

The body is dense and nearly all content is novel (tool calls, NLP syntax, response schemas, reason codes) with no explanation of concepts Claude already knows. A few lines are editorial padding, e.g. "This is the primitive that makes Alethia a verifiable-safety framework, not just a test runner" and "that's the compliance proof the user asked for". Fits 'Efficient; minor instances of over-explanation that could be trimmed' — well above anchor 3 but short of anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Guidance is fully executable: exact MCP config JSON, an install command (`npm install -g @vitronai/alethia`), concrete per-workflow tool-call sequences, and copy-paste-ready NLP examples covering the common cases (navigate, assert, click with text:/css: prefixes, type, wait, expect block). This matches anchor 5, 'Fully executable; copy-paste ready... specific examples cover the common cases'.

5 / 5

Workflow Clarity

All three workflows are numbered with explicit validation checkpoints (alethia_status liveness check, check run.ok, inspect stepRuns) and an explicit error-recovery feedback loop ("Use suggestedFix to retry the step" from nearMatches/suggestedFix/pageContext). Destructive operations are handled with their own verification primitives (expect block:, alethia_assert_safety, DENY_WRITE_HIGH reason codes), satisfying the destructive-operation validation requirement. Matches anchor 5's 'explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

Section structure is clear, but the 164-line body is monolithic: everything including the detailed grants authorization policy, reason-code table, and PlanRun schema is inlined rather than split into reference files. The only references ("[Tile Overview](../../docs/index.md)", "[Rules](../../rules/alethia.md)") point two levels outside the skill directory and do not exist in the bundle, so they are dangling. This fits anchor 3 ('Some structure but could be better organized') rather than 4, where references would be mostly clear and content appropriately placed across files.

3 / 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 that explicitly covers both what the skill returns and when to use it, with concrete trigger scenarios and specific output artifacts. The only weakness is moderate overlap risk from generic form/visibility triggers and a few missing natural synonyms such as 'browser test' or 'UI test'.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions ("run E2E tests", "generate tests for an app", "prove destructive actions are blocked", "check if a UI element is visible", "fill out a form", "drive a browser with natural language") plus concrete output artifacts ("per-step results with safety classifications, policy decisions, DOM diffs, structured page context, and a signed audit trail"). This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' — not 4, since coverage of the skill's capabilities is comprehensive rather than having minor gaps.

5 / 5

Completeness

Both questions are explicitly answered: a "Use when the user asks to..." clause with seven concrete trigger scenarios, and a clear 'what' via "Returns per-step results with safety classifications, policy decisions, DOM diffs, structured page context, and a signed audit trail". This matches anchor 5 (clear and explicit what AND when with concrete trigger phrases); score 4 would apply only if the 'when' were less explicit.

5 / 5

Trigger Term Quality

Good natural phrases users would say ("run E2E tests", "check if a UI element is visible", "fill out a form", "drive a browser with natural language"), but common variations like "browser test", "UI test", "test my app", or "assert visible" are absent. This fits 'Good keyword coverage; a few natural terms missing' — clearly above 3 (coverage is strong) but short of 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The verifiable-safety/browser-automation niche is mostly distinct, but generic triggers like "fill out a form", "verify a web page", and "check if a UI element is visible" overlap with general web-testing and form-automation skills. Fits 'Mostly distinct; minor overlap risk with closely related skills' — more specific than anchor 3's 'could still overlap with similar skills', but not the minimal-conflict niche of anchor 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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

vitron-ai/alethia-mcp

Path

tessl/skills/alethia/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.