CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

86%

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

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

Excellent project-specific content: executable commands, validated multi-step workflows, and a disciplined refusal to restate what the codebase already shows. The single structural weakness is that it is a long monolithic file with no progressive disclosure — detailed reference material (IR schemas, modality API docs) sits inline in SKILL.md instead of being split into bundle files.

Suggestions

Move the domain-map IR reference material (classes/bindings JSON examples, arg routing, projections, cache) into a references/domain-map-ir.md file and keep only a compact summary plus a one-line pointer in SKILL.md.

Extract the consumer-facing API documentation (singleton vs direct instantiation, AI SDK adapter, /tools subpath) into references/modalities.md, leaving the architecture overview and workflows in SKILL.md.

Trim the ASCII pipeline diagram to a three-line stage list ('capture-tools.ts -> domain-map.json -> generate-sdk.ts') to reclaim tokens without losing information.

DimensionReasoningScore

Conciseness

Nearly every token is project-specific knowledge Claude cannot know (pipeline stages, domain-map IR, side-effect membrane rules, env vars, .js import convention), and it explicitly refuses to enumerate methods ('It does not enumerate every method'). The ASCII pipeline diagram and a few JSON examples could be tightened, which keeps it at the 'minor instances of over-explanation' anchor rather than the lean 5.

4 / 5

Actionability

Fully executable throughout: exact commands ('bun scripts/capture-tools.ts', 'npx vitest run test/unit/sdk.test.ts', 'bun scripts/e2e-test.ts', 'npx tsc'), copy-paste TypeScript/JSON examples for every pattern, and numbered procedures (Supporting a New Tool, Adding a New Side-Effect Method) that cover the common cases. This matches the anchor-5 example.

5 / 5

Workflow Clarity

Multi-step processes are explicitly sequenced with validation checkpoints and feedback loops: 'Run validate-generated.ts to confirm consistency', Stage 3 validation rules for side-effect declarations, and the Red-Green-Yellow pattern that mandates failing tests first, then passing tests, then refactor with 'validate-generated.ts to verify pipeline integrity'. This matches the anchor-5 validate-fix-retry shape.

5 / 5

Progressive Disclosure

The body is ~345 lines with no references/, scripts/, or assets/ files in the bundle — everything is inlined under decent section headers. Content that plausibly belongs in separate reference files (the domain-map IR schema with multi-part JSON examples, the AI SDK adapter / tools-subpath usage docs, the side-effect extension pattern) is inline, matching the 'some structure but could be better organized; content that should be separate is inline' anchor rather than the well-split anchor at 4. The under-50-line simple-skill exception does not apply, and headers alone do not constitute progressive disclosure at this length.

3 / 5

Total

17

/

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: third-person, concise, explicit 'Use when...' triggers, and specific domain coverage. The only weakness is that its trigger phrases are generic software-development terms while the domain itself is highly specific, creating minor overlap risk with general coding skills.

DimensionReasoningScore

Specificity

Names the domain ('Develop the Stitch SDK') and lists several concrete coverage areas — 'generation pipeline, dual modality (agent vs SDK), error handling, and Traffic Light (Red-Green-Yellow) implementation workflow' — which is several specific capabilities. Not quite a 5 because 'Covers...' names topics rather than concrete actions, leaving minor gaps in what the skill actually does.

4 / 5

Completeness

Explicitly answers both what ('Develop the Stitch SDK. Covers the generation pipeline, dual modality, error handling, and Traffic Light implementation workflow') and when ('Use when adding features, fixing bugs, or understanding the architecture') with concrete trigger phrases — the exact shape of the anchor-5 example. The 'when' clause is explicit, not weakly implied, so it is not a 4.

5 / 5

Trigger Term Quality

'Use when adding features, fixing bugs, or understanding the architecture' uses natural phrases a developer would say. Good keyword coverage, but missing common synonyms and artifact terms users might mention (e.g. 'MCP', 'codegen', 'domain-map', 'generated SDK'), so it falls just short of the comprehensive-with-synonyms anchor at 5 and clearly above the missing-variations anchor at 3.

4 / 5

Distinctiveness Conflict Risk

Clear niche — a named package ('Stitch SDK') with its own vocabulary (Traffic Light, dual modality) — so it is mostly distinct. However, the trigger phrases 'adding features, fixing bugs, or understanding the architecture' are generic dev-work phrases that could overlap with other code-development skills, matching the minor-overlap anchor at 4 rather than the distinct-triggers anchor at 5.

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

referenced_paths_exist

Referenced path issues: 8 missing

Warning

Total

15

/

16

Passed

Repository

google-labs-code/stitch-sdk

Path

.agents/skills/stitch-sdk-development/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.