CtrlK
BlogDocsLog inGet started
Tessl Logo

005-agents-installation

Use when you need to install the embedded robot agents into .github/agents, .claude/agents, .cursor/agents, or .codex/agents, selecting the destination interactively and copying the embedded agent definitions from project assets. This should trigger for requests such as Install embedded agents; Bootstrap .github/agents; Bootstrap .cursor/agents; Bootstrap .claude/agents; Bootstrap .codex/agents; Copy robot agents. 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

65%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 skill body is a well-structured overview with excellent progressive disclosure — a single, real, clearly-signaled reference carrying the file manifest and detailed steps. Its weaknesses are duplicated trigger/constraint text that could be trimmed, and the absence of a mandatory verification checkpoint in a batch copy workflow that can overwrite files, which caps workflow clarity at 3.

Suggestions

Add an explicit validation step after installation (e.g. verify all nine files exist in the destination and report any mismatch) rather than leaving verification as an optional report item — this is a batch overwrite operation and currently caps workflow clarity.

Remove the 'When to use this skill' section: it duplicates the frontmatter trigger phrases verbatim, which are already loaded into context when the skill is invoked.

State the destination-choice question inline in the body (or reference its exact wording) instead of describing it only as 'Ask exactly one question', and name the optional verification command rather than leaving it unspecified.

DimensionReasoningScore

Conciseness

The 48-line body is free of concept explanations, but carries real redundancy: the 'When to use this skill' section repeats the frontmatter trigger phrases verbatim (frontmatter is already loaded into context), and the workflow step constraints restate the Constraints section ('Do not copy any file until destination is explicitly confirmed' vs 'MUST ask... before installing'). Not a 2: there is no padded explanation of concepts Claude already knows; not a 4: the duplicated trigger list and double-stated constraints could be trimmed.

3 / 5

Actionability

For an instruction-only skill the guidance is executable: 'Create the destination directory if needed, then copy all embedded agent files defined in the reference content, preserving filenames and warning before overwriting existing files', with the exact file list one clearly-signaled reference away. Not a 5: the body never shows the exact question to ask (it lives only in the reference) and leaves the verification step as 'an optional verification command' without naming one.

4 / 5

Workflow Clarity

The three-step sequence (choose destination → install → report) is clear and the interactive gate is well specified ('Ask exactly one question... wait for an explicit answer before copying files', 'If destination is ambiguous, ask a clarification question'), but this is a batch copy operation that can overwrite existing files and validation is absent — verification appears only as an optional report item, not a checkpoint. Per the rubric's batch/destructive cap, workflow clarity cannot exceed 3 despite the clear sequence.

3 / 5

Progressive Disclosure

The body is a concise overview with one well-signaled, one-level-deep reference ('For detailed guidance, examples, and constraints, see references/005-agents-installation.md'), which exists on disk and in turn enumerates the nine real asset files in assets/agents/ (all verified present). Content is appropriately split: interaction flow in the body, file manifest and detailed steps in the reference.

5 / 5

Total

15

/

20

Passed

Description

87%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 states concrete capabilities, lists natural trigger phrases covering all four destination variants, and explicitly separates what from when. The only notable gap is reliance on toolkit-internal jargon ('robot agents', 'Plinth Toolkit') that may not match how unfamiliar users phrase the request.

DimensionReasoningScore

Specificity

Names several concrete actions ('install the embedded robot agents', 'selecting the destination interactively', 'copying the embedded agent definitions from project assets') with the four specific destination paths. Not a 5: actions like install/copy are somewhat generic and there is no mention of overwrite handling or reporting. Not a 3: it goes beyond 1-2 actions by covering selection, copy, and all destination variants.

4 / 5

Completeness

Explicitly answers both: what ('install the embedded robot agents... selecting the destination interactively and copying the embedded agent definitions from project assets') and when ('Use when you need to install... This should trigger for requests such as...') with concrete trigger phrases. Matches the anchor-5 example structure directly.

5 / 5

Trigger Term Quality

Good natural trigger coverage: 'Install embedded agents; Bootstrap .github/agents; Bootstrap .cursor/agents; Bootstrap .claude/agents; Bootstrap .codex/agents; Copy robot agents' — three verb variants plus all destination paths. Not a 5: misses common variations users might say ('add agents', 'set up agents') and leans on internal jargon ('robot agents', 'Plinth Toolkit') that users outside the toolkit would not say.

4 / 5

Distinctiveness Conflict Risk

Clear niche — installing a specific embedded Plinth Toolkit agent bundle into four named agent directories — with distinct triggers ('Bootstrap .github/agents', 'Copy robot agents') that no generic skill would claim. 'Part of Plinth Toolkit' further scopes it; minimal conflict risk.

5 / 5

Total

18

/

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.