CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

adding-modules

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

Quality

76%

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

93%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 an excellent example of a lean, repo-specific procedural skill: a concrete numbered checklist, an executable template, a precise skip_units contract with the authoritative source named, and explicit test commands. The only meaningful gap is the absence of an error-recovery loop in the Testing section, which keeps workflow clarity just below top marks.

DimensionReasoningScore

Conciseness

Every section is repo-specific contract Claude cannot infer — the sourced-module/exit semantics, the skip_unless usage rules (command vs. path vs. chained requirements vs. message format), exact registration positions ('among the source lines', 'positioned per the Order matters comment'), and the test flags. No section explains concepts Claude already knows, and nothing is padded.

5 / 5

Actionability

The guidance is fully executable: a copy-paste-ready install.sh template with the lib/skip.sh guard pattern, exact test commands ('bash mymodule/install.sh --non-interactive --overwrite --allow'), exact file paths (config.sh.example, bash/exports.sh, homebrew/bundle), and named reference modules for each pattern. The README spec bullets make step 2 concrete rather than vague.

5 / 5

Workflow Clarity

The numbered checklist gives a clear, correctly ordered sequence (create -> README -> install.sh -> register -> packages -> root README -> config) with an explicit validation section (test standalone, then via main installer). It falls short of anchor 5 only because the Testing section lacks an error-recovery feedback loop — there is no 'if the test fails, check X and re-run' guidance, only the commands themselves.

4 / 5

Progressive Disclosure

No bundle files exist, and none are needed at this size: the body is well-sectioned into When/Checklist/Template/Testing/References, with one-level-deep, clearly signaled pointers ('lib/skip.sh holds the full contract'; four reference modules each annotated with the pattern it demonstrates). All inline content earns its place at authoring time.

5 / 5

Total

19

/

20

Passed

Description

47%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, appropriately scoped trigger ('Use when adding new modules, configs, or tools to dotfiles') with natural keywords, but it is missing the 'what' half entirely: a reader cannot tell what the skill actually does when invoked. Adding a concise statement of the concrete actions (the module-creation checklist) would lift both completeness and specificity significantly.

Suggestions

Add a 'what' clause stating the skill's purpose, e.g. 'Guides the full checklist for adding a module to a dotfiles repo: creating the module directory, README, and install.sh, registering it in the root install.sh, and updating the root README and config.'

Name 2-3 concrete actions to lift specificity above generic 'adding', such as 'create the module directory and install.sh template', 'register the module in the root installer', and 'update the root README and config.sh.example'.

Consider adding one or two natural trigger synonyms users might phrase differently, such as 'installing a new tool config' or 'setting up a new dotfiles module', to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ('dotfiles') but the only action is the generic 'adding new modules, configs, or tools' — no concrete actions like creating module directories, writing install scripts, or updating the root README are stated. It matches anchor 2 ('Names the domain but actions are minimal or generic'): it is more concrete than anchor 1's pure abstraction, but does not list the 1-2 concrete actions anchor 3 requires.

2 / 5

Completeness

The description is only a 'when' clause ('Use when adding...') with no 'what' — it never states what the skill does (guide the checklist for adding a module: directory, README, install.sh, registration, root README updates). This matches anchor 2's 'only when is present without what' exactly, as in 'Use when working with documents'.

2 / 5

Trigger Term Quality

'adding', 'modules', 'configs', 'tools', and 'dotfiles' are natural terms a user maintaining a dotfiles repo would say, giving good keyword coverage across the domain's variations. It falls short of anchor 5's comprehensive coverage because common phrasings like 'install', 'set up', or specific tool/package names are missing.

4 / 5

Distinctiveness Conflict Risk

The 'to dotfiles' qualifier establishes a clear niche that most skills would not match, but the generic nouns 'configs' and 'tools' carry minor overlap risk with closely related repo-maintenance or package-installation skills. This fits anchor 4 ('mostly distinct; minor overlap risk') rather than anchor 5's minimal-conflict clear niche with distinct triggers.

4 / 5

Total

12

/

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

joshmanders/dotfiles

Path

.claude/skills/adding-modules/SKILL.md

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.