CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-tester

Validates all interactive skills in this repo against the Agent Skills spec, project conventions, and structural requirements. Runs quick_validate.py, checks line limits, verifies cross-references, and tests hook scripts. Use when skills have been added or modified and you want to verify everything passes before committing or submitting.

Quality

84%

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 well-structured, largely actionable validation skill with concrete commands, explicit pass criteria, and honest coverage notes about what the script does not automate. All dimensions sit at 4 due to minor gaps: repeated caveats, method-less semantic checks, no explicit re-run loop, and repo-relative paths.

Suggestions

For the agent-performed semantic checks (Checks 2, 3, 5), add a short concrete procedure or example comparison so the agent knows how to verify 'content alignment' and 'durable principles', not just what to verify.

Add an explicit feedback loop: after producing the results report, instruct the agent to have failures fixed and re-run the checks until passing or the user aborts.

Deduplicate the 'agent-performed — not covered by run-tests.sh' caveat between the checks table and the coverage note, and clarify that script paths are repo-root-relative to avoid confusion with the bundle's own scripts/ directory.

DimensionReasoningScore

Conciseness

Mostly lean with compact tables and copy-paste command blocks, but the "agent-performed — not covered by run-tests.sh" caveat is repeated in both the checks table and the coverage note, and the Check 3 prose could be tightened.

4 / 5

Actionability

Mostly executable guidance (quick_validate.py loop, bash -n, head -1 grep -qE, test -x, sync-plugin/validate-agent-plugin commands, and a verified run-tests.sh script), but Checks 2, 3, and 5 state what to verify without giving a method or command (e.g., "Content alignment" has no comparison procedure).

4 / 5

Workflow Clarity

Six clearly sequenced checks each with explicit pass criteria and a structured output template with Passed/Failed/Warnings; however, this batch operation lacks an explicit fix-and-re-run feedback loop after failures are reported.

4 / 5

Progressive Disclosure

Well-sectioned body with a real, appropriately-used bundle script (scripts/run-tests.sh) and no nested references, but at ~149 lines it exceeds the simple-skill exception, and script paths are repo-root-relative rather than bundle-relative, leaving minor navigation gaps.

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 with explicit what/when structure, concrete enumerated actions, and natural trigger phrases. Its only weakness is minor coverage gaps (instruction-file and plugin checks unmentioned) and a few missing synonyms for its trigger terms.

DimensionReasoningScore

Specificity

Lists several concrete named actions ("Runs quick_validate.py, checks line limits, verifies cross-references, and tests hook scripts") with only minor gaps — instruction-file validation and plugin validation from the body are not mentioned, so coverage is not comprehensive.

4 / 5

Completeness

Explicitly answers both: what ("Validates all interactive skills... against the Agent Skills spec, project conventions, and structural requirements" plus enumerated checks) and when ("Use when skills have been added or modified and you want to verify everything passes before committing or submitting") with concrete triggers.

5 / 5

Trigger Term Quality

Natural trigger phrases like "skills have been added or modified", "verify everything passes", and "before committing or submitting" match what a user would say, though common synonyms such as "test", "check", or "lint" are missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche — repo-specific skill validation against the Agent Skills spec — with triggers scoped to skill changes, keeping it distinct from CI variants and general test/eval tooling; minimal conflict risk.

5 / 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: 2 possibly missing (scripts/test-sync-plugin.py, scripts/validate-agent-plugin.py)

Warning

Total

15

/

16

Passed

Repository

pskoett/pskoett-ai-skills

Path

skills/skill-tester/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.