CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sdk-craft

Design, build, document, and ship SDKs. Use when creating a client library, planning a breaking change, or reviewing SDK quality. It does not build a CLI (that's `devrel-tooling`) or an MCP server (that's `mcp-server-craft`).

Quality

92%

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

A well-crafted, actionable skill body: executable configs and templates, a clearly sequenced lifecycle with phase-gate validation, and clean one-level-deep progressive disclosure into real, well-scoped reference files. The only room for improvement is trimming a few motivational sentences and fixing the "§ Type Safety" heading reference.

DimensionReasoningScore

Conciseness

The body is mostly dense and efficient — tables, checklists, and executable code with little concept re-teaching. A few padded spots could be trimmed ("Build SDKs that developers can't stop talking about. Great SDK DX is a competitive advantage…", "SDK documentation has three layers: all three are needed", and the translated-JavaScript-SDK sentence that repeats a reference file's opening), so it fits anchor 4 rather than 5.

4 / 5

Actionability

Guidance is copy-paste ready throughout: a complete tsup.config.ts, a full package.json exports block, an error-class hierarchy with required fields, a JSDoc template, a doc-generator table per language, and phase gates citing concrete tools (publint, attw, npm publish --dry-run). Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The four-phase lifecycle is clearly sequenced (Design → Build → Document → Ship table, "State which phase you're in… the skill routes accordingly") with an explicit "Phase gates" section of verification questions between phases, a pre-release quality checklist, and a closing "Did this help?" feedback loop with an issue-filing path. This matches anchor 5: clear sequence, explicit validation checkpoints, and checklists.

5 / 5

Progressive Disclosure

All four bundle files (references/design-principles.md, language-idioms.md, typescript-sdk.md, build-and-publish.md) exist, are referenced one level deep, and are clearly signaled via blockquotes at the point of need in the matching phase sections. The overview inlines only summaries and examples, matching the anchor-5 split pattern; the only nit is the body's "§ Type Safety" label versus the actual "Type safety patterns" heading, which is too minor to drop the score.

5 / 5

Total

19

/

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: concrete lifecycle verbs, an explicit "Use when" clause with natural trigger phrases, and explicit de-scoping against sibling skills. The only weakness is keyword breadth — common variations like "npm package", "API client", or "publishing" are absent, which slightly limits recall.

DimensionReasoningScore

Specificity

The description names the domain and four concrete lifecycle actions ("Design, build, document, and ship SDKs") plus concrete contexts ("creating a client library, planning a breaking change, or reviewing SDK quality"). It stops short of anchor 5 because coverage has minor gaps — no mention of languages, publishing targets, or versioning specifics.

4 / 5

Completeness

It explicitly answers both questions: the what is "Design, build, document, and ship SDKs" and the when is "Use when creating a client library, planning a breaking change, or reviewing SDK quality" with concrete trigger phrases, matching the anchor-5 example structure. It does not fall to 4 because the when-clause is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: "SDKs", "client library", "breaking change", "SDK quality", plus boundary terms "CLI" and "MCP server". A few natural variations are missing (e.g., "npm package", "API wrapper", "publish"), so it fits anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The explicit negative boundary ("It does not build a CLI (that's `devrel-tooling`) or an MCP server (that's `mcp-server-craft`)") carves out a clear niche and redirects near-miss triggers to sibling skills, giving minimal conflict risk — a direct match for anchor 5.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

saif-shines/devex-kit

Path

plugins/tooling/skills/sdk-craft/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.