CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

design-shotgun

Design shotgun: generate multiple AI design variants, open a comparison board, collect structured feedback, and iterate. Standalone design exploration you can run anytime. Use when: "explore designs", "show me options", "design variants", "visual brainstorm", or "I don't like how this looks". Proactively suggest when the user describes a UI feature but hasn't seen what it could look like.

Quality

81%

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

62%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 actual design-shotgun workflow (Steps 0–6) is excellent — concrete, executable, and rich with validation and feedback loops — but it is buried in ~300 lines of generic gstack framework boilerplate that doubles the file's token cost. The undefined `$GSTACK_DESIGN` variable and zsh-only shell fragments are minor executable gaps. Structure is monolithic with no progressive disclosure of the shared framework material.

Suggestions

Extract the shared framework content (Voice persona, Completeness Principle/Boil the Lake, telemetry and proactive onboarding flows, AskUserQuestion format, Contributor Mode, Completion Status Protocol, Plan Status Footer) into a common base file or shared reference the skill points to, cutting the body roughly in half — this addresses both conciseness and progressive disclosure.

Define GSTACK_DESIGN in the preamble (mirroring GSTACK_BROWSE) so the DESIGN SETUP fallback `$D=$GSTACK_DESIGN/design` doesn't resolve to an empty path, and guard or remove the zsh-only `setopt +o nomatch` / `source <(...)` lines so the bash blocks run under bash.

Merge Step 4's inline feedback-confirmation summary with Step 5, which repeats the same 'Here's what I understood' output and AskUserQuestion verification, removing a duplicated section.

DimensionReasoningScore

Conciseness

Roughly 300 of the ~710 body lines are generic framework boilerplate unrelated to design exploration — a full "Voice" persona section (~40 lines), "Boil the Lake" essay promotion, telemetry/proactive onboarding dialogs, an effort-compression table, contributor mode, and a plan-footer protocol — all auto-generated shared scaffolding that pads every token of context. This is "noticeably verbose; several unnecessary explanations or padded sections" (2-anchor); it exceeds the 3-anchor's "some unnecessary explanation" since the padding is systematic and comprises nearly half the file.

2 / 5

Actionability

The design-shotgun steps are highly concrete: exact bash setup blocks, the full `$D` command list, a complete copy-paste agent prompt template with retry rules, a polling loop, and the feedback JSON shape. It falls short of fully executable (5-anchor) due to real gaps: `$D=$GSTACK_DESIGN/design` references `$GSTACK_DESIGN`, which is never defined in the preamble (only `GSTACK_BROWSE` is), and zsh-only `setopt +o nomatch` / `source <(...)` lines appear inside otherwise bash-targeted blocks.

4 / 5

Workflow Clarity

Steps 0–6 are clearly sequenced with explicit validation checkpoints and error-recovery loops: concept confirmation before spending API credits, a quality gate (`$D check`) with regeneration retry, per-agent verification (`ls -lh`) with structured DONE/FAILED reports, fallback to sequential generation on parallel failure, a 10-minute polling timeout with AskUserQuestion fallback, and mandatory feedback-confirmation before saving `approved.json`. This matches the 5-anchor (clear sequence, explicit validation, feedback loops for error recovery).

5 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/) — everything lives in one ~710-line monolithic SKILL.md, and the auto-generated marker ("AUTO-GENERATED from SKILL.md.tmpl") shows the shared framework policies are re-inlined per skill rather than split into a common reference one level deep. The design-shotgun section itself is well organized with clear step headings, but content that should be separate is inline, matching the 3-anchor rather than the 4-anchor's "most content is appropriately placed".

3 / 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 multi-action capability statement, an explicit 'Use when' clause with natural trigger phrases, and proactive-suggestion guidance. The only weakness is slight keyword coverage — a few common synonyms (mockup, redesign, UI options) are absent. It clearly sits near the top of the rubric's good examples.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions covering the full workflow: "generate multiple AI design variants, open a comparison board, collect structured feedback, and iterate". This matches the 5-anchor's comprehensive coverage of concrete actions; it is not the 4-anchor because there are no noticeable gaps in coverage of the skill's stated purpose.

5 / 5

Completeness

It explicitly answers both questions: what ("generate multiple AI design variants, open a comparison board, collect structured feedback, and iterate") and when ("Use when: 'explore designs', 'show me options'... or 'I don't like how this looks'"). Both are present with concrete trigger phrases, matching the 5-anchor exactly; the 4-anchor would require a less explicit 'when', which is not the case here.

5 / 5

Trigger Term Quality

Trigger phrases are natural conversational terms users would say: "explore designs", "show me options", "design variants", "visual brainstorm", "I don't like how this looks", plus a proactive cue ("user describes a UI feature but hasn't seen what it could look like"). A few natural synonyms are still missing (e.g., mockup, redesign, UI options/alternatives), which fits the 4-anchor ("good keyword coverage; a few natural terms missing") rather than the comprehensive 5-anchor.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — AI design variant generation with browser-based comparison and structured feedback — with distinctive conversational triggers ("visual brainstorm", "I don't like how this looks") unlikely to collide with document, chart, or code skills. This matches the 5-anchor (clear niche with distinct triggers, minimal conflict risk); the 4-anchor would imply meaningful overlap with a closely related skill, which the triggers avoid.

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 (724 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

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