CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

common-stitch-design

Drive Google Stitch over MCP safely - read screens, write and lint DESIGN.md, create design systems, and fix designs through variants instead of overwriting. Use when reviewing, editing, or generating Stitch screens or DESIGN.md files.

Quality

89%

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

90%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.

An exemplary lean, highly actionable rulebook: exact tool names, commands, parameters, and real validation/feedback loops for destructive and batch operations, with details correctly pushed to one-level-deep reference files. The main gaps are the implicit (section-ordered rather than explicit) workflow sequencing and a dangling cross-skill reference to ../common-ui-design/references/human-direction.md.

Suggestions

Fix or inline the broken cross-skill link [Human Direction](../common-ui-design/references/human-direction.md) (referenced in both the body and prompting.md) — either ship the file in the bundle or summarize the keep/change/avoid essentials locally.

Make the end-to-end sequence explicit (e.g., a short numbered flow: preflight → read/audit → confirm direction & approval → variant/write → lint → re-audit) so readers don't have to infer order from section arrangement.

DimensionReasoningScore

Conciseness

The body is dense, imperative bullets with zero concept explanations — e.g., "Never overwrite originals. Fix through `generate_variants` (default `creativeRange: REFINE`, `variantCount: 1`)" — assuming Claude's competence throughout. Every token earns its place; nothing is padded, matching the lean score-5 anchor rather than the minor-trimming case at 4.

5 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact tool names (`generate_variants`, `apply_design_system` takes screen instance ids from `get_project`), runnable commands (`npx @google/design.md lint DESIGN.md`, `node scripts/audit_html.js <dir>`), and concrete parameters ("poll `get_screen` every 30 s, max 10", "longest edge <=1600 px"). This matches the copy-paste-ready score-5 anchor; nothing is pseudocode or vague.

5 / 5

Workflow Clarity

Sections run in execution order (Preflight → Read → Human Direction → Write Safely → DESIGN.md → Prompting) with real validation checkpoints and feedback loops — "must report 0 errors and 0 warnings before upload", "re-audit after each pass; max 2 `edit_screens` passes", "On timeout do not retry; poll", and approval gates before destructive ops (so the destructive/batch cap does not apply). It falls short of 5 because the end-to-end sequence is implied by section order rather than an explicit step ordering, and some checkpoints (screenshot verification, bounded review) delegate procedure to references.

4 / 5

Progressive Disclosure

The SKILL.md is a genuine overview with well-signaled, verified one-level-deep references — [Stitch MCP](references/stitch-mcp.md#bounded-image-review), [Prompting](references/prompting.md), [DESIGN.md](references/design-md.md), plus a bundled script — all of which exist with matching anchors. It misses 5 because [Human Direction](../common-ui-design/references/human-direction.md) is referenced twice (body and prompting.md) but does not exist in this bundle, a navigation dead-end for readers.

4 / 5

Total

18

/

20

Passed

Description

87%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: third-person-imperative voice, concrete multi-action capability list, and an explicit 'Use when...' trigger clause covering both what and when. Keyword coverage is good but omits a few natural synonyms (design system, variants) that would make triggering even more reliable.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "read screens, write and lint DESIGN.md, create design systems, and fix designs through variants instead of overwriting" — matching the anchor for several specific actions with minor gaps. It falls short of 5 because capabilities like prompting guidance, image review, and design-system application are not mentioned, and it exceeds 3 because more than 1-2 actions are named concretely.

4 / 5

Completeness

It clearly answers both: what ("read screens, write and lint DESIGN.md, create design systems, and fix designs through variants") and when ("Use when reviewing, editing, or generating Stitch screens or DESIGN.md files") with concrete trigger phrases. This matches the score-5 anchor exactly; the 'when' clause is explicit, not merely implied as at 4.

5 / 5

Trigger Term Quality

"Use when reviewing, editing, or generating Stitch screens or DESIGN.md files" plus "Google Stitch" and "over MCP" give good natural keyword coverage a user would actually say. A few natural terms are missing (e.g., "design system", "variants", "mockups/UI screens"), which matches the score-4 anchor rather than the comprehensive synonym/extension coverage of 5.

4 / 5

Distinctiveness Conflict Risk

"Drive Google Stitch over MCP" plus Stitch-screen and DESIGN.md-specific triggers establish a clear niche with minimal conflict risk against generic design or documentation skills. It is below no anchor — the only mild overlap is with generic DESIGN.md tooling, which is explicitly scoped to Stitch, keeping it at 5 rather than 4.

5 / 5

Total

18

/

20

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.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

13

/

16

Passed

Repository

HoangNguyen0403/agent-skills-standard

Path

.agents/skills/common/common-stitch-design/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.