CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plugin-auditor

Audit automatically audits AI assistant code plugins for security vulnerabilities, best practices, AI assistant.md compliance, and quality standards when user mentions audit plugin, security review, or best practices check. specific to AI assistant-code-plugins repositor... Use when assessing security or running audits. Trigger with phrases like 'security scan', 'audit', or 'vulnerability'.

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/examples/jeremy-plugin-tool/skills/plugin-auditor/SKILL.md
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.

The body is a well-structured, actionable audit procedure with concrete patterns, commands, error-recovery guidance, and a properly disclosed one-level reference bundle that all resolves to real files. It sits just below top marks due to minor redundancy, thin in-step validation checkpoints, and a couple of leftover unreferenced files in the bundle.

Suggestions

Fix the 'TODO/TODO' duplication in step 3 (should read TODO/FIXME) and drop the Resources section entries that repeat links already given inline, or keep the inline links and let Resources carry only the files not cited in steps.

Inline one or two representative grep commands in the step 2 security scan (the full list is already in references/audit-categories.md) so the primary scan step is self-sufficiently executable.

Remove or link the unreferenced ARD.md and PRD.md from references/ (and the boilerplate references/README.md) so the bundle structure matches what SKILL.md navigates to.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence, with no explanation of known concepts. Minor trimmable instances remain: step 3 lists 'TODO/TODO' (a duplicated typo where TODO/FIXME was meant), and the Resources section repeats links already given inline in steps 2, 3, and 8 — anchor 4, not the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Concrete guidance throughout: specific patterns ('AKIA...', 'rm -rf /', 'eval()', base64/hex), executable commands ('jq empty .claude-plugin/plugin.json', 'pnpm run sync-marketplace'), an error table with fix commands, and references containing runnable grep/jq/find recipes. The main scan steps describe what to look for rather than giving the commands inline (delegated to references), leaving minor gaps versus anchor 5.

4 / 5

Workflow Clarity

A clear 8-step sequence covers all eight audit categories, with step 1 confirming the target exists and an error-cause-solution table for recovery. Auditing is read-only so the destructive/batch validation cap does not apply, but explicit validation checkpoints within the steps are implicit rather than stated, matching anchor 4 rather than 5.

4 / 5

Progressive Disclosure

References are well-signaled inline and indexed in a Resources section, all one level deep, and every cited file (audit-categories.md, audit-process.md, audit-report-format.md, examples.md, errors.md) exists with content matching its description. Minor organization gaps: ARD.md and PRD.md sit unreferenced in references/, and references/README.md is generic boilerplate — anchor 4 rather than the fully clean anchor 5.

4 / 5

Total

16

/

20

Passed

Description

66%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.

The description answers both what and when with genuine natural trigger phrases, but it is grammatically malformed and internally redundant (two separate trigger clauses plus a 'Trigger with phrases like' tail), with truncated text and terminology that does not match the skill body. Distinctiveness is weakened because the trigger words are generic relative to the narrow plugin-audit niche.

Suggestions

Rewrite the opening so it reads as a clean third-person sentence, e.g., 'Audits Claude Code plugins for security vulnerabilities, best-practices compliance, CLAUDE.md standards, and marketplace readiness', and remove the truncated 'repositor...' fragment.

Consolidate the three separate trigger clauses ('when user mentions...', 'Use when assessing...', 'Trigger with phrases like...') into one 'Use when' sentence, and align terminology with the body (CLAUDE.md, not 'AI assistant.md').

Add plugin-specific triggers such as 'audit plugin', 'plugin security review', or 'publish readiness check' to reduce overlap with generic security/code-review skills.

DimensionReasoningScore

Specificity

The only concrete verb is 'audits'; the phrases 'security vulnerabilities, best practices, AI assistant.md compliance, and quality standards' name audit focus areas rather than several distinct actions (extract/fill/merge style). This matches anchor 3 (domain plus limited concrete actions), not anchor 4 which expects several specific listed actions.

3 / 5

Completeness

Both 'what' (audits plugins for security, best practices, compliance, quality) and 'when' (explicit 'Use when' plus trigger phrases) are present, but the 'what' is garbled ('Audit automatically audits', truncated 'repositor...', and 'AI assistant.md' inconsistent with the body's CLAUDE.md). Anchor 4 (both present, one could be more explicit/cleaner) fits better than 5.

4 / 5

Trigger Term Quality

Natural user phrases are present: 'security scan', 'audit', 'vulnerability', 'security review', 'best practices check'. Coverage is good but misses common variations like 'plugin check' or 'code review', matching anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The domain is scoped to 'AI assistant-code-plugins' repositories, but the triggers 'audit', 'vulnerability', and 'security scan' are generic and would also fire for general security-review or code-review skills. This is 'somewhat specific but could still overlap with similar skills' (anchor 3), not the mostly-distinct anchor 4.

3 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 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

14

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/examples/jeremy-plugin-tool/skills/plugin-auditor/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.