CtrlK
BlogDocsLog inGet started
Tessl Logo

adding-modules

Use when adding new modules, configs, or tools to dotfiles

63

Quality

73%

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 ./.claude/skills/adding-modules/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 tight, actionable instruction skill with executable templates, a clear step sequence, and good use of reference pointers; the main gap is that verification is segregated from the workflow rather than embedded as an explicit checkpoint.

DimensionReasoningScore

Conciseness

The body is lean throughout — terse checklists, one executable template, concrete test commands, and reference pointers — with no padding and no explanation of concepts Claude already knows, matching the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

A concrete 6-step checklist names specific files, the bash install template is executable, and test commands are copy-paste ready; minor gaps remain (the README contents are listed as bullets rather than specified) and template placeholders are expected, so it sits just below fully executable.

4 / 5

Workflow Clarity

The checklist is a clearly sequenced multi-step flow and a dedicated Testing section supplies verification, so the destructive/batch cap at 3 does not apply; however validation lives in a separate section rather than as an inline validate→fix→retry checkpoint within the flow.

4 / 5

Progressive Disclosure

Content is organized into clear, well-labeled sections and uses one-level-deep pointers to existing repo modules ('git/install.sh', 'bash/install.sh') as reference patterns, with no nested or buried references and no bundle files needed.

5 / 5

Total

18

/

20

Passed

Description

61%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 has a clear, natural trigger and a distinct niche, but it conflates 'what' and 'when' into a single clause and uses only one generic verb, so it does not fully convey the skill's concrete capabilities.

Suggestions

Split the description into a 'what' clause and a 'when' clause, e.g. 'Creates module directories with READMEs and install scripts, and updates the root installer. Use when adding new modules, configs, or tools to dotfiles.'

Replace the single generic verb 'adding' with concrete actions such as 'scaffold', 'generate install scripts for', and 'wire into the root installer' to raise specificity.

Add common synonyms a user might say, such as 'dotfiles repo', 'stow packages', or 'brew bundle', to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description names the dotfiles domain and target objects ('modules, configs, or tools') but relies on a single generic verb ('adding') rather than a range of concrete actions, matching the 'names domain and 1-2 concrete actions' anchor.

3 / 5

Completeness

An explicit 'Use when...' trigger is present (so it is not capped at 3 by the missing-trigger rule), but 'what' and 'when' collapse into one clause and the skill's actual function (creating module dirs, writing READMEs, updating the installer) is not stated, leaving the 'what' thin.

3 / 5

Trigger Term Quality

'dotfiles', 'modules', 'configs', and 'tools' are natural terms a user would say, paired with an explicit 'Use when' trigger, giving good keyword coverage; it falls short of 5 only because no synonyms or file extensions are included.

4 / 5

Distinctiveness Conflict Risk

The dotfiles module-addition niche is clearly scoped and unlikely to fire for unrelated skills, with only minor overlap risk against other dotfiles-maintenance skills.

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
joshmanders/dotfiles
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.