CtrlK
BlogDocsLog inGet started
Tessl Logo

plugin-validator

Validate automatically validates AI assistant code plugin structure, schemas, and compliance when user mentions validate plugin, check plugin, or plugin errors. runs comprehensive validation specific to AI assistant-code-plugins repository standards. Use when validating configurations or code. Trigger with phrases like 'validate', 'check', or 'verify'.

70

Quality

64%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/examples/jeremy-plugin-tool/skills/plugin-validator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description covers both what the skill does and when to use it, which is good for completeness. However, it suffers from overly generic trigger terms ('validate', 'check', 'verify') that could conflict with other validation skills, and the specific capabilities could be more concretely enumerated. The description is also somewhat redundant, stating the validation purpose multiple times in slightly different ways.

Suggestions

Narrow the generic trigger terms—instead of broad 'validate', 'check', or 'verify', use more specific phrases like 'validate plugin schema', 'check plugin compliance', or 'plugin structure errors' to reduce conflict risk with other validation skills.

Replace 'runs comprehensive validation' with specific checks performed, e.g., 'checks YAML schema conformance, verifies required fields, validates plugin manifest structure' to increase specificity.

Remove the overly broad 'Use when validating configurations or code' clause, which could match almost any validation task, and replace with more targeted guidance like 'Use when working with AI assistant code plugin repositories or plugin manifest files'.

DimensionReasoningScore

Specificity

It names the domain (AI assistant code plugin) and some actions (validate structure, schemas, compliance), but the specific actions are somewhat vague—'comprehensive validation' and 'validating configurations or code' are broad rather than listing concrete checks performed.

2 / 3

Completeness

The description answers both 'what' (validates plugin structure, schemas, and compliance against repository standards) and 'when' (explicit 'Use when' clause and trigger phrases are provided). Both components are present and explicit.

3 / 3

Trigger Term Quality

Includes some relevant trigger terms like 'validate plugin', 'check plugin', 'plugin errors', 'validate', 'check', 'verify', but these are fairly generic terms that could apply to many validation tasks. Missing more specific natural phrases like 'schema validation', 'plugin compliance', or 'plugin structure check'.

2 / 3

Distinctiveness Conflict Risk

While 'AI assistant-code-plugins repository standards' is fairly specific, the broad trigger terms like 'validate', 'check', and 'verify' combined with 'validating configurations or code' could easily conflict with other validation-related skills. The generic triggers undermine the specificity of the domain.

2 / 3

Total

9

/

12

Passed

Implementation

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured validation skill with a clear 11-step workflow, good error handling patterns, and appropriate use of reference files for progressive disclosure. Its main weaknesses are the lack of executable commands/code for individual validation steps (relying on narrative descriptions instead) and some redundancy between the instructions, error table, and examples sections. The skill would benefit from more concrete, copy-paste-ready commands and verification of referenced bundle files.

Suggestions

Add executable command examples for key validation steps (e.g., show the exact `jq` command for schema validation, `grep` patterns for security scanning, `find` command for script permissions) rather than describing them narratively.

In the Examples section, show actual command invocations and sample output snippets rather than describing the process in prose—e.g., show what the validation report looks like for a failing plugin.

Consider moving the error handling table to the referenced `errors.md` file to reduce the main skill's length and avoid duplicating information already in the instructions.

DimensionReasoningScore

Conciseness

The content is mostly efficient but includes some redundancy—the error handling table partially duplicates information already covered in the instructions (e.g., script permissions, disallowed fields). The examples section describes processes narratively rather than showing concrete outputs, adding bulk without proportional value. However, it generally avoids explaining concepts Claude already knows.

2 / 3

Actionability

The 11-step workflow provides specific checks and criteria (kebab-case, semver, required fields), which is good. However, it lacks executable code/commands for most steps—validation logic is described rather than provided as runnable scripts or concrete command sequences. The reference to `validate-all-plugins.sh` is mentioned but never shown how to invoke with arguments. Examples describe processes narratively rather than showing actual commands and outputs.

2 / 3

Workflow Clarity

The 11-step sequence is clearly ordered and logically progresses from file existence checks through schema validation, security scanning, and marketplace compliance to a final report. The output section defines a structured validation report format with pass/fail verdicts, and the error handling table provides explicit fix commands for each failure type, creating effective feedback loops.

3 / 3

Progressive Disclosure

The skill references four external files in `${CLAUDE_SKILL_DIR}/references/` which is good progressive disclosure structure, but no bundle files were provided to verify these references exist or contain meaningful content. The main SKILL.md itself is fairly long (~80 lines of instructions) and some detail (like the full error handling table and examples) could potentially be offloaded to reference files. The references are clearly signaled and one-level deep, which is positive.

2 / 3

Total

9

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.