CtrlK
BlogDocsLog inGet started
Tessl Logo

peteski22/setup-project

Configure Claude Code for this project - detects languages and sets up rules, skills, and validators

49

Quality

62%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

32%

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 provides a basic understanding of the skill's purpose (configuring Claude Code projects) but lacks explicit trigger guidance that would help Claude know when to select it. The actions mentioned are moderately specific but could benefit from more concrete examples of what configuration entails.

Suggestions

Add a 'Use when...' clause with trigger terms like 'setup project', 'initialize', 'configure Claude', 'create CLAUDE.md', or 'new project setup'

Include common user phrases like 'set up my project', 'get started', 'initialize workspace', or 'create configuration files'

Specify concrete outputs like 'creates CLAUDE.md, .claude/settings.json, and language-specific configuration files'

DimensionReasoningScore

Specificity

Names the domain (Claude Code configuration) and some actions (detects languages, sets up rules/skills/validators), but lacks comprehensive detail about what specific configuration actions are performed or what outputs are produced.

2 / 3

Completeness

Describes what it does but completely lacks a 'Use when...' clause or any explicit trigger guidance. Per rubric guidelines, missing explicit trigger guidance caps completeness at 2, and this has no trigger guidance at all.

1 / 3

Trigger Term Quality

Includes some relevant terms like 'configure', 'project', 'rules', 'skills', but misses common variations users might say like 'setup', 'initialize', 'init', 'CLAUDE.md', or 'getting started'.

2 / 3

Distinctiveness Conflict Risk

Somewhat specific to Claude Code configuration, but 'rules' and 'skills' are generic terms that could overlap with other skills. The phrase 'for this project' helps but doesn't fully distinguish it.

2 / 3

Total

7

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured, highly actionable skill with excellent workflow clarity and explicit validation checkpoints. The main weakness is verbosity—particularly the inline documentation blocks and output templates that inflate the token count. The skill would benefit from externalizing template content to separate files.

Suggestions

Extract the Step 4b local-supplements content block and Step 9 output template to separate template files, referencing them with clear paths

Remove redundant explanations of CLAUDE.local.md purpose (mentioned in Steps 4b, 6, and 9)

Consolidate the file extension mapping into a single reference table rather than explaining it inline with examples

DimensionReasoningScore

Conciseness

The skill is comprehensive but includes some redundant explanations (e.g., explaining what CLAUDE.local.md is for multiple times, verbose template examples). The Step 4b content block explaining local supplements is particularly lengthy and could be trimmed.

2 / 3

Actionability

Provides fully executable bash commands throughout, specific file paths, exact JSON structures, and copy-paste ready code blocks. Every step has concrete commands with expected outputs.

3 / 3

Workflow Clarity

Clear numbered steps (0-9) with explicit validation checkpoints (Step 0 plugin root check with STOP instruction, Step 3 existing config checks, Step 7 prerequisite verification). Includes error recovery paths and conditional logic for different scenarios.

3 / 3

Progressive Disclosure

Well-structured with numbered steps and subsections, but the skill is monolithic (~300 lines) with no references to external files for detailed content. The Step 4b content block and Step 9 output template could be externalized.

2 / 3

Total

10

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Reviewed

Table of Contents