CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

design-consultation

Design consultation: understands your product, researches the landscape, proposes a complete design system (aesthetic, typography, color, layout, spacing, motion), and generates font+color preview pages. Creates DESIGN.md as your project's design source of truth. For existing sites, use /plan-design-review to infer the system instead. Use when asked to "design system", "brand guidelines", or "create DESIGN.md". Proactively suggest when starting a new project's UI with no existing design system or DESIGN.md.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

66%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 design consultation workflow itself is excellent: phased, concrete, and validated with feedback loops and fallbacks. But the skill buries it in hundreds of lines of generic framework boilerplate, and everything lives in one monolithic SKILL.md with no reference files, which costs token efficiency and navigability.

Suggestions

Move the gstack framework boilerplate (preamble bash, Voice, AskUserQuestion format, Completeness Principle, Contributor Mode, Completion Status Protocol, Telemetry, Plan Status Footer) into a shared framework file or a preamble reference that this SKILL.md points to, cutting the body roughly in half.

Extract the design knowledge catalogs (aesthetic directions, decoration/layout/color/motion approaches, font recommendations, blacklist and overused-font lists, AI slop anti-patterns) into a references/ file (e.g., DESIGN_KNOWLEDGE.md) linked from Phase 3, keeping only the decision framework inline.

Remove time-sensitive details from the main flow — e.g., 'best websites 2025' search strings and the pinned BUN_VERSION=1.3.10 — or relocate them to a setup/deprecated section so they don't go stale in the core instructions.

DimensionReasoningScore

Conciseness

Roughly the first 340 lines are generic gstack framework boilerplate (session/telemetry bash preamble, 'Voice' persona, AskUserQuestion format, Completeness Principle, Contributor Mode, Plan Status Footer) unrelated to the design task, and the design phases add further padding such as 'best websites 2025' search strings and a pinned BUN_VERSION=1.3.10. This is noticeably-to-severely verbose; it is not a 1 because the Phase 0-6 content itself is dense and directive rather than explaining things Claude already knows.

2 / 5

Actionability

Guidance is copy-paste ready throughout: exact bash setup checks, full $D command templates (variants/check/compare/iterate/extract), a concrete polling loop with the feedback JSON shape, a complete DESIGN.md template, and a 9-point preview-page spec. Specific examples cover the common paths (Path A AI mockups, Path B HTML fallback, plan vs. implementation mode).

5 / 5

Workflow Clarity

Phases 0-6 are clearly sequenced with explicit validation checkpoints and feedback loops: a $D check quality gate per variant, file-polling feedback with a 10-minute timeout and AskUserQuestion fallback, a 'Here's what I understood... Is this right?' verification step, coherence re-checks after overrides, and a final confirm listing any agent-default decisions. Fallbacks for missing binaries (browse, designer) are spelled out at each step.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and this ~890-line monolith inlines content that clearly belongs in separate files: the framework preamble/voice/telemetry sections and the font catalogs, aesthetic-direction lists, and blacklist tables belong in shared or reference files. Structure within the file is decent, but the inlining problem is severe, matching the 'content that clearly belongs in separate files is inlined' anchor rather than the merely 'could be better organized' one.

2 / 5

Total

14

/

20

Passed

Description

92%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, comprehensive on capabilities, with an explicit 'Use when' clause containing natural quoted trigger phrases and explicit routing away from a sibling skill. The only gap is a handful of natural synonym triggers (fonts, palette, visual identity).

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with the sub-areas enumerated: 'understands your product, researches the landscape, proposes a complete design system (aesthetic, typography, color, layout, spacing, motion), and generates font+color preview pages. Creates DESIGN.md'. This matches the comprehensive-coverage anchor; it is not a 4 because there are no meaningful gaps in what the skill does.

5 / 5

Completeness

Both halves are explicit: the 'what' (research, propose, generate previews, create DESIGN.md) and the 'when' with concrete trigger phrases ('Use when asked to...'), plus proactive-suggestion guidance. It clearly matches the anchor for explicitly answering both what AND when; not a 4 because the 'when' is already fully explicit with quoted trigger phrases.

5 / 5

Trigger Term Quality

Explicit triggers are natural phrases users would say: 'Use when asked to "design system", "brand guidelines", or "create DESIGN.md"'. Good coverage, but common variations like 'pick fonts', 'color palette', 'visual identity', or 'rebrand' are missing, which keeps it below the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (new design system consultation) and explicitly disambiguates the nearest neighbor: 'For existing sites, use /plan-design-review to infer the system instead.' Triggers ('design system', 'brand guidelines', 'create DESIGN.md') are distinct, so conflict risk is minimal.

5 / 5

Total

19

/

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

skill_md_line_count

SKILL.md is long (891 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/gstack/.agents/skills/gstack-design-consultation/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.