CtrlK
BlogDocsLog inGet started
Tessl Logo

project-consistency

Generates shared CSS variables, validates component naming conventions, creates layout pattern templates. Use when coordinating design system, theme, consistent styling, CSS variables, or component library across parallel agents.

63

Quality

75%

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 ./src/orchestrator/skills/project-consistency/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 efficient and highly actionable with a clearly sequenced two-phase workflow and concrete validation commands, but its single progressive-disclosure reference is broken: TEMPLATES.md does not exist, leaving the prompt-template guidance unresolvable. Fixing or inlining that reference plus adding error-recovery steps for failed checks would lift the weakest dimensions.

Suggestions

Create the missing TEMPLATES.md (containing the actual page-agent and foundation prompt templates) or inline the essential template skeleton into SKILL.md and delete the dead link.

Make the foundation checkpoint executable: replace 'Layout renders, UI components compile' with concrete commands (e.g., a build/typecheck command) so agents can verify rather than assume.

Add an error-recovery loop for the per-page check: state what to do when 'grep -rF "style={{" src/pages/' returns hits or imports fail to resolve (fix by replacing inline styles with token-based classes, then re-run until 0 hits).

DimensionReasoningScore

Conciseness

The body is lean: rules delivered via tables, an executable grep check, and no explanation of concepts Claude already knows (no CSS-variable tutorials, no library comparisons). Not 5 because the 22-line tokens.css example mostly demonstrates a naming convention Claude could infer from a 5-line sample, and the 'Convoy Integration' fenced block restates its five items in prose; not 3 because there is no padded or over-explained section.

4 / 5

Actionability

Concrete, usable guidance throughout: exact paths ('src/styles/tokens.css', 'src/components/Layout.tsx'), an executable check ('grep -rF "style={{" src/pages/'), naming rules (PascalCase components, camelCase props), and a copy-paste-ready tokens.css with the var-only usage pattern 'bg-[var(--color-primary)]'. Not 5 because the foundation checkpoint's 'Layout renders, UI components compile' gives no command or procedure to actually verify those, and the convoy section defers its substance to a file that isn't there.

4 / 5

Workflow Clarity

The two-phase sequence is explicit — 'Phase 1 (sequential): foundation-setup creates tokens, Layout, UI library, style guide brief. Phase 2 (parallel): every page task imports from Phase 1' — with two numbered validation checkpoints including a zero-hit grep gate. Not 5 because there is no error-recovery feedback loop telling an agent what to do when the per-page grep returns hits or imports fail to resolve; not 3 because checkpoints are explicit and concrete, not merely implied.

4 / 5

Progressive Disclosure

Sections are well-organized, but the body's only external reference — 'Prompt templates: see [TEMPLATES.md](./TEMPLATES.md)' — points to a file that does not exist anywhere in the skill directory, and no references/, scripts/, or assets/ bundle is present. Navigation to the prompt templates (the operational core of the Convoy Integration section) is a dead end, matching the anchor where referenced content is effectively unreachable. Not 3 because a clearly signaled-but-missing reference is worse than one that is merely 'not clearly signaled'; not 1 because the in-body content is genuinely sectioned and self-navigable.

2 / 5

Total

14

/

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: concrete third-person actions paired with an explicit, multi-trigger 'Use when' clause using natural terminology. Minor room to improve via additional synonyms (design tokens, shared styles) and slightly sharper trigger scoping around generic terms like 'theme'.

DimensionReasoningScore

Specificity

Names the domain and three concrete actions — 'Generates shared CSS variables, validates component naming conventions, creates layout pattern templates' — each with a specific object and verb. Not 5 because coverage stops at three actions with no mention of related capabilities (e.g., validation tooling, drift checks); not 3 because the actions listed are specific and complete as stated rather than minimal.

4 / 5

Completeness

Explicitly answers 'what' (three concrete generative/validating actions) and 'when' with a concrete 'Use when coordinating design system, theme, consistent styling, CSS variables, or component library across parallel agents' clause listing multiple trigger phrases. Voice is third person throughout. Matches the anchor-5 pattern of concrete actions plus an explicit multi-trigger 'Use when' sentence.

5 / 5

Trigger Term Quality

The 'when' clause covers natural user phrasings: 'design system', 'theme', 'consistent styling', 'CSS variables', 'component library'. Not 5 because common variations like 'design tokens', 'shared styles', 'styling consistency', or 'shared components' are missing; not 3 because several natural, likely-spoken terms are present rather than just a few relevant keywords.

4 / 5

Distinctiveness Conflict Risk

CSS variables, design tokens, and the 'across parallel agents' framing carve a fairly distinct niche with specific triggers. Not 5 because broad terms like 'theme' and 'consistent styling' could also fire on generic styling or theming requests where this orchestration skill is not wanted; not 3 because the parallel-agent coordination context meaningfully separates it from ordinary styling skills.

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
monkilabs/opencastle
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.