CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-skill-builder

Create project-specific Claude Code skills tailored to particular codebases, domains, or organizations. Workflow for analyzing project context, identifying skill opportunities, designing project-specific patterns, and building custom skills. Use when creating skills for specific projects, capturing project knowledge, building team-specific workflows, or developing domain-specific skill toolkits.

Quality

66%

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/project-skill-builder/SKILL.md

The canonical home for this skill is project-skill-builder in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

35%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 reads as an abstract outline: the 5-step workflow is restated three times, no step explains how to actually perform it, and there are no concrete examples, commands, or templates for the artifacts it names. Validation exists only as labels without checkpoints, and the skill depends on external skills ('development-workflow', 'skill-researcher') that are not bundled or clearly signaled.

Suggestions

Add one worked example: a brief project-context excerpt, a prioritized opportunity list, and the resulting SKILL.md frontmatter/body, so Claude can pattern-match real output instead of abstract labels.

Make each step executable — give concrete methods or commands for analyzing a codebase, identifying opportunities, and validating a deployed skill (e.g., 'run the skill on a real task and check the output against the opportunity list') instead of bare 'Understand'/'Validate' labels.

Cut the redundancy: the 5-step list appears in Overview, Workflow, and Quick Reference — keep it once, and remove the closing tagline and the horizontal-rule padding between steps.

DimensionReasoningScore

Conciseness

The same abstract 5-step workflow is restated three times ('Project Skill Builder Workflow (5 steps)', the full '## Workflow' section, and the '## Quick Reference' code block), plus a redundant closing tagline and an Examples section of vague bullets — several padded sections with no new information. It is not anchor 1 because it never explains concepts Claude already knows, but it is noticeably below anchor 3's 'mostly efficient'.

2 / 5

Actionability

No executable guidance anywhere: steps are labels like 'Understand: Codebase architecture and patterns' and 'Validate: Effective for team/project' with no commands, code, templates, or criteria; the only concrete details are 'Deploy: To project .claude/skills/' and the dependency 'Use: development-workflow'. This is slightly above anchor 1 (it names per-step output artifacts and a deploy path) but well below anchor 3, since there is nothing Claude could actually run or pattern-match.

2 / 5

Workflow Clarity

The five steps are clearly sequenced and each names an output ('Output: Project context document', 'Output: Skill opportunity list (prioritized)'), matching anchor 3's 'steps listed, sequence present'. However, validation is only a label — 'Test: In actual project context', 'Validate: Effective for team/project' — with no checkpoints, criteria, or error-recovery loop, so it cannot reach anchor 4; it stays above anchor 2 because the sequence and per-step outputs are more defined than a rough crude list.

3 / 5

Progressive Disclosure

The body has section structure (Overview, When to Use, Workflow, Examples, Quick Reference) but is a single abstract layer: the mentioned resources ('Uses: development-workflow, skill-researcher') are other skills, not clearly signaled files in this bundle, and no references/, scripts/, or assets/ exist. Structure exists but nothing is split or navigable beyond headings, fitting anchor 3 better than anchor 4.

3 / 5

Total

10

/

20

Passed

Description

83%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 with a clear what, an explicit 'Use when...' trigger clause, and mostly natural trigger terms. It is capped below excellent only by slightly abstract action verbs and a few missing natural variations like 'onboarding' and 'custom skills'.

DimensionReasoningScore

Specificity

The description lists several actions — 'analyzing project context, identifying skill opportunities, designing project-specific patterns, and building custom skills' — which goes beyond the 1-2 actions of anchor 3, but the verbs remain more abstract than anchor 5's fully concrete action list (no validation/deploy mention, no output artifacts named), leaving minor gaps in coverage.

4 / 5

Completeness

It clearly answers both parts: what ('Create project-specific Claude Code skills tailored to particular codebases, domains, or organizations. Workflow for analyzing...building custom skills') and when via an explicit trigger clause ('Use when creating skills for specific projects, capturing project knowledge...'), matching anchor 5's requirement for both with concrete trigger phrases.

5 / 5

Trigger Term Quality

'creating skills for specific projects, capturing project knowledge, building team-specific workflows, or developing domain-specific skill toolkits' gives good natural keyword coverage a user would plausibly say, but misses common variations such as 'onboarding', 'custom skills', or 'team knowledge base', so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The 'project-specific Claude Code skills' niche is mostly distinct and the triggers ('project knowledge', 'team-specific workflows') steer away from generic skill tooling, but a general skill-creation skill (e.g., a generic skill-builder) would still overlap on 'creating skills', so minor overlap risk remains short of anchor 5's minimal-conflict niche.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/project-skill-builder/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.