CtrlK
BlogDocsLog inGet started
Tessl Logo

003-skills-inventory

Use when you need to generate a checklist document with Java system prompts from skills.xml, following the embedded section template and producing INVENTORY-SKILLS-JAVA.md. This should trigger for requests such as Create Java system prompts checklist; Generate INVENTORY-SKILLS-JAVA.md; Use @003-skills-inventory; Inventory Java cursor rule skills; List available Java system prompt skills. Part of Plinth Toolkit

64

Quality

81%

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

67%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-organized, actionable instruction skill with a clear three-step workflow and an explicit validation checkpoint, supported by a real one-level reference file. Its main weaknesses are padding (duplicated trigger lists, repeated constraints, generic edge-case boilerplate) and hiding the template asset behind an extra level of indirection.

Suggestions

Remove the duplicated trigger list ('When to use this skill') and the generic EDGE CASE bullets that restate default Claude behavior, and drop the constraint rules repeated inside Workflow step 1 — the constraints section already covers them.

Reference the template asset directly in the body (e.g., in Workflow step 1 or the Reference section: 'template: assets/java-skills-inventory-template.md') so the core template is one level deep instead of only reachable through references/003-skills-inventory.md.

Add a short error-recovery instruction to the validation step (e.g., 'if rows are missing or extra, re-derive from skills.xml and regenerate') to close the workflow feedback loop.

DimensionReasoningScore

Conciseness

The five trigger bullets are duplicated verbatim between the 'When to use this skill' section and the frontmatter-derived phrasing, the skillId/reference-id rule is repeated in both Constraints and Workflow step 1, and the three generic EDGE CASE bullets ('stop and ask a clarifying question', 'report the blocker explicitly') restate default Claude behavior. Mostly efficient but with several unnecessary padded sections — the 3 anchor.

3 / 5

Actionability

Concrete guidance throughout: exact file paths ('references/003-skills-inventory.md', 'plinth-skills-generator/src/main/resources/skills.xml'), explicit id-resolution rules ('use the skillId attribute when it exists; otherwise use the single reference name'), and a defined output location. Not a 5 because no example of the output structure appears inline — the actual template shape is entirely delegated to the reference, leaving a minor gap.

4 / 5

Workflow Clarity

A clear three-step sequence (read template and inventory source → generate INVENTORY-SKILLS-JAVA.md → validate coverage) with an explicit validation step ('Verify that the generated file contains every effective skill id… contains no extra skill rows'), so the batch-operation cap does not apply. It falls short of 5 because there is no error-recovery feedback loop (what to do when validation finds missing or extra rows).

4 / 5

Progressive Disclosure

The body is well structured with a dedicated '## Reference' section containing a clearly signaled one-level link (references/003-skills-inventory.md, verified to exist), and bulk detail is appropriately out of the body. Not a 5 because the core template asset assets/java-skills-inventory-template.md — which the task depends on ('following the embedded section template') — is never referenced from SKILL.md itself and is only discoverable via the reference file, adding a second level of indirection.

4 / 5

Total

15

/

20

Passed

Description

86%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: it explicitly states what the skill does and provides five concrete natural-language trigger phrases, making routing reliable. Its weaknesses are the single-action scope and second-person phrasing ('Use when you need to…'), which costs it specificity points under the rubric.

DimensionReasoningScore

Specificity

The description names concrete artifacts ('from skills.xml', 'following the embedded section template', 'producing INVENTORY-SKILLS-JAVA.md') but describes essentially one action — generating the checklist — which matches 'names domain and 1-2 concrete actions'. It would be a 4 for the concrete file/artifact specificity, but the rubric's second-person penalty applies: 'Use when you need to generate…' is second-person voice, reducing the score by 1.

3 / 5

Completeness

Both 'what' (generate a checklist document from skills.xml following the embedded template, producing INVENTORY-SKILLS-JAVA.md) and 'when' ('This should trigger for requests such as: …' with five concrete phrases) are explicitly and clearly answered, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Five explicit natural trigger phrasings are listed — 'Create Java system prompts checklist', 'Generate INVENTORY-SKILLS-JAVA.md', 'Inventory Java cursor rule skills', 'List available Java system prompt skills' — covering synonyms (create/generate/inventory/list) and the exact output filename, matching the comprehensive-coverage anchor. It does not fit the 4 anchor because no common natural variation is missing.

5 / 5

Distinctiveness Conflict Risk

The Java-specific niche and unique output filename (INVENTORY-SKILLS-JAVA.md) give it distinct triggers with minimal conflict risk, but 'Part of Plinth Toolkit' signals a family of sibling inventory skills whose phrasing could overlap — mostly distinct with minor overlap risk against closely related skills, so not the 5 anchor.

4 / 5

Total

17

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/plinth
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.