CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-auditor

A comprehensive auditor for any agent skill — including Manus, OpenClaw/ClawHub, Claude, LobeHub, or custom SKILL.md-based skills. Use this skill whenever a user wants to evaluate, audit, review, score, or quality-check an agent skill before publishing, updating, or deploying. Covers two hard veto gates (structural redlines + research integrity redlines), static quality scoring across 25 criteria (ISO 25010 + OpenSSF + Agent), dynamic test input generation, multi-mode execution testing, multi-layer output evaluation with five specialized category rubrics (Evidence Insight / Protocol Design / Data Analysis / Academic Writing / Other), a Research Veto that applies to all four research categories, human eval viewer generation, actionable P0/P1/P2 optimization recommendations, and automatic skill improvement that outputs a polished, production-ready SKILL.md. Also use whenever a user says "audit my skill", "evaluate my skill", "improve my skill", or wants a corrected version after evaluation.

71

Quality

88%

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

77%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 content is a well-structured orchestration skill with an explicit gated workflow and clean progressive disclosure into real reference files. Its main weakness is redundancy — gate criteria and rationale are restated across the step summaries, report template, and changelog, which inflates token cost.

Suggestions

Deduplicate the T1–T4 and M1–M4 dimension tables: summarize once in Steps 1 and 6 and reference the file from the final report template instead of repeating the full criteria.

Tighten the changelog: keep the per-file modification list and drop the multi-paragraph rationale, or move it into a CHANGELOG reference file.

Specify the evaluate_skill.py CLI invocation and arguments inline in Step 1 so the command is fully copy-paste ready without opening the script.

DimensionReasoningScore

Conciseness

Mostly efficient but redundant in places — the T1–T4 and M1–M4 veto dimensions are restated in Step 1/Step 6 summaries and again in the final report template, and the changelog reiterates rationale at length. It is tight enough to stay above a 2 but not lean enough for a 4.

3 / 5

Actionability

Provides concrete commands ('python scripts/evaluate_skill.py'), copy-paste report templates, exact JSON key names, and a strict pre-emit checklist; minor gaps (e.g., the script's CLI args are not enumerated inline) keep it just short of fully copy-paste ready.

4 / 5

Workflow Clarity

The 8-step pipeline is clearly sequenced with explicit hard gates at Steps 1 and 6, validation feedback loops ('fix all FAIL dimensions before resubmitting'), fallback paths, and a destructive-overwrite pre-emit checklist — matching the validate→fix→retry anchor.

5 / 5

Progressive Disclosure

The body is an overview pointing to 11 one-level-deep reference files, all of which exist on disk and are clearly signaled via a reference table with 'Used In' and 'Gate?' columns, giving clean navigation.

5 / 5

Total

17

/

20

Passed

Description

100%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 is strong across all dimensions: it states concrete capabilities, gives natural trigger phrases, answers both 'what' and 'when', and carves out a distinct niche. It is slightly long but the density is concrete rather than padded.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'two hard veto gates', 'static quality scoring across 25 criteria', 'dynamic test input generation', 'five specialized category rubrics', 'P0/P1/P2 optimization recommendations' — with comprehensive coverage.

5 / 5

Completeness

Explicitly answers both what it does and when to use it via 'Use this skill whenever a user wants to evaluate, audit, review, score, or quality-check an agent skill' plus concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes natural user phrasings ('evaluate, audit, review, score, or quality-check') plus literal triggers like 'audit my skill', 'evaluate my skill', 'improve my skill' that users would actually say.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (auditing agent skills before publishing/deploying) with distinct triggers, so overlap with other skills is minimal.

5 / 5

Total

20

/

20

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.

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (554 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

13

/

16

Passed

Repository
aipoch/medical-research-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.