CtrlK
BlogDocsLog inGet started
Tessl Logo

source-command-audit-whitepapers

Audit version freshness, FR/EN parity, and metadata quality of all whitepapers and recap cards

54

Quality

60%

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 ./.agents/skills/source-command-audit-whitepapers/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 highly actionable and well-structured with concrete commands and scoring tables, but the batch audit lacks explicit validation checkpoints (capping workflow clarity at 3) and inlines a large report template that hurts conciseness. Adding verification steps and extracting bulky reference tables would lift the score.

Suggestions

Add explicit validation checkpoints between phases, e.g. verify the discovered file count and confirm `git log` executed before computing scores, to satisfy the batch-operation workflow requirement.

Move the large WP-to-guide mapping table and exclusions reference into separate reference files and link to them, reducing inline bulk.

Tighten or externalize the full report template and repeated category-fix patch examples to improve token efficiency.

DimensionReasoningScore

Conciseness

Mostly efficient with tables and concrete commands, but the ~400-line body inlines a large full report template and repetitive category-fix patches that could be trimmed or moved to reference files.

3 / 5

Actionability

Highly actionable: concrete git commands, regex patterns, explicit frontmatter field lists, and point-by-point scoring tables; only minor gaps such as the unexplained separate `--wp 10` command.

4 / 5

Workflow Clarity

A clear 7-phase sequence with objectives exists, but this batch audit lacks explicit validation/verification checkpoints, so the batch-operation cap holds at 3.

3 / 5

Progressive Disclosure

Single well-organized file with clear section headers and specified <details> blocks; no bundle files exist, though large inlined tables (WP-guide mapping, exclusions) could be split into reference files.

4 / 5

Total

14

/

20

Passed

Description

58%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 specific and distinctive about what the audit covers, but it omits an explicit "Use when..." trigger, which the rubric caps at completeness 3. Adding a trigger clause and natural user-facing terms (.qmd, "audit whitepapers") would raise trigger and completeness scores.

Suggestions

Add an explicit trigger clause to the description, e.g. "Use when the user asks to run audit-whitepapers or check whitepaper/recap-card freshness."

Include natural user-facing terms and file extensions ("whitepapers", "recap cards", ".qmd files", "FR/EN parity") to improve trigger term coverage.

Move the "Use this skill when..." guidance from the body into the description field so the what-and-when pair is self-contained.

DimensionReasoningScore

Specificity

Names the domain and three concrete audit actions ("version freshness", "FR/EN parity", "metadata quality") covering the skill's scope comprehensively, with only minor gaps like missing file extensions.

4 / 5

Completeness

The description gives a clear "what" but no "when" trigger clause; the "Use this skill when..." guidance lives in the body rather than the description, capping completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords ("whitepapers", "recap cards", "version freshness") appear but common natural variations and file extensions (.qmd) a user might say are missing.

3 / 5

Distinctiveness Conflict Risk

The combined "whitepapers and recap cards" freshness/parity/metadata niche is mostly distinct with only minor overlap risk against a generic update skill.

4 / 5

Total

14

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
FlorianBruniaux/claude-code-ultimate-guide
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.