CtrlK
BlogDocsLog inGet started
Tessl Logo

stitch-sdk-development

Develop the Stitch SDK. Covers the generation pipeline, dual modality (agent vs SDK), error handling, and Traffic Light (Red-Green-Yellow) implementation workflow. Use when adding features, fixing bugs, or understanding the architecture.

72

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable, concise, and structured around explicit validated workflows. Its main gap is progressive disclosure: a complex multi-topic skill delivered as a single monolithic file rather than splitting detail into reference files.

Suggestions

Move the detailed domain-map IR schema and the side-effect membrane/extension rules into separate reference files (e.g. references/domain-map.md, references/side-effects.md) and link to them from the overview to apply progressive disclosure.

Consider extracting the modality reference (StitchToolClient config resolution, AI SDK adapter, toolMap) into a references/modality.md so the main SKILL.md stays a high-level map.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — it never explains basic concepts (MCP, codegen, ESM) and every section earns its place with concrete JSON/code; only minimal meta-prose in the intro keeps it from padding.

3 / 3

Actionability

Provides fully executable commands ('bun scripts/capture-tools.ts', 'npx vitest run'), copy-paste TypeScript and JSON examples, and concrete file paths, matching the 'fully executable, copy-paste ready' anchor.

3 / 3

Workflow Clarity

The Traffic Light (Red→Green→Yellow) flow and the 'Supporting a New Tool' / 'Adding a New Side-Effect Method' pipelines are explicitly sequenced with validation checkpoints ('validate-generated.ts', 'npx tsc'), matching the clear-sequence-with-validation anchor.

3 / 3

Progressive Disclosure

Sections are well-organized with clear headers, but everything lives inline in one ~340-line file with no bundle references; the domain-map IR and side-effect membrane detail are candidates for separate reference files, matching the 'content that should be separate is inline' anchor.

2 / 3

Total

11

/

12

Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, complete, and distinctive, with third-person voice and an explicit 'Use when' clause. Its only weakness is that the trigger terms are generic development activities rather than user-natural phrasing tied to the SDK.

Suggestions

Replace generic when-triggers ('adding features, fixing bugs') with user-natural phrasing tied to the SDK, e.g. 'Use when working on @google/stitch-sdk, adding or regenerating SDK methods, or debugging the capture/generate pipeline.'

DimensionReasoningScore

Specificity

Lists multiple concrete capability areas — 'generation pipeline, dual modality (agent vs SDK), error handling, and Traffic Light (Red-Green-Yellow) implementation workflow' — matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

Explicitly answers both what ('Develop the Stitch SDK. Covers...') and when ('Use when adding features, fixing bugs, or understanding the architecture'), matching the clear-both-with-explicit-triggers anchor; not a 2 because the 'Use when' trigger clause is present.

3 / 3

Trigger Term Quality

'Stitch SDK' is a specific natural term, but the when-triggers ('adding features, fixing bugs, or understanding the architecture') are generic dev activities missing common variations a user would say, so it sits at 'some relevant keywords but missing common variations'.

2 / 3

Distinctiveness Conflict Risk

Anchored to the distinct 'Stitch SDK' niche with triggers unlikely to fire for unrelated skills; not a 2 because the domain is clearly scoped rather than merely 'somewhat specific'.

3 / 3

Total

11

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 8 missing

Warning

Total

15

/

16

Passed

Repository
google-labs-code/stitch-sdk
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.