CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

iii-sdk-reference

Use when working with iii SDK APIs across Node.js, browser, Python, Rust, or Go: package installation, worker initialization, function/trigger registration, observers, invocation, local dispatch, channels, logging, OpenTelemetry, and language-specific caveats.

Quality

89%

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

86%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 excellent, lean multi-language SDK reference: executable examples, exact signatures, and genuinely non-obvious behavioral caveats (channel abort semantics, namespace resolution, browser invocation lifetime) with zero padding. The main structural weakness is that everything lives inline in SKILL.md rather than being split into per-language reference files.

Suggestions

Move the per-language sections (Node.js, Browser, Python, Rust, Go) into references/<language>.md files, keeping the Common API Map and SDK-selection table in SKILL.md as the navigable overview.

Extract the Channels and Namespaces deep-dives into a references/ file (or fold into the sibling skills they border on), keeping only the one-line decision rules inline.

Consolidate the scattered version notes (0.24.5, 0.25 deprecations mentioned in the table, language sections, and observer section) into a single 'Deprecations in 0.25' subsection under the existing (0.25) heading.

DimensionReasoningScore

Conciseness

The body is dense, SDK-specific reference material with no concept padding — every statement (e.g., "a writer left open keeps the reader waiting until its process exits") describes engine behavior Claude cannot know. Version-sensitive notes are consolidated in the 'Observers and local dispatch (0.25)' section and attached to the deprecated APIs rather than expressed as time-conditional instructions, so there is nothing to trim for anchor 4.

5 / 5

Actionability

Install commands are copy-paste ready per language ("cargo add iii-sdk", "go get github.com/iii-hq/iii/sdk/packages/go/iii"), each language has an executable minimal example, and the Common API Map gives exact signatures like "register_worker(address, options?)". Coverage of the common cases in all five languages matches anchor 5.

5 / 5

Workflow Clarity

Content is organized in use order (Install → Choose the SDK → API map → per-language usage → cross-cutting concerns) with clear boundary routing to sibling skills, and no destructive or batch operations require validation checkpoints. It sits above anchor 3 (checkpoints missing for a process that needs them) but below anchor 5, since no explicit stepwise path with checkpoints is laid out for a newcomer.

4 / 5

Progressive Disclosure

The full five-language API reference (~250 lines) is inlined in SKILL.md with no references/ bundle files; the per-language sections and channels/namespaces detail fit anchor 3's 'content that should be separate is inline'. It is not anchor 2 (structure is strong with clear headers and easy navigation) nor anchor 4 (the bulk reference material is not split into separate files, though deferral to sibling skills like `iii-observe` is clearly signaled in Boundaries).

3 / 5

Total

17

/

20

Passed

Description

88%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: it opens with an explicit 'Use when' trigger clause, names five language targets, and enumerates the SDK's concrete capabilities without fluff or over-claiming. The only weaknesses are missing TypeScript/JavaScript synonyms and slight trigger overlap with the sibling observe skill.

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities — "package installation, worker initialization, function/trigger registration, observers, invocation, local dispatch, channels, logging, OpenTelemetry" — across five named language targets, giving comprehensive coverage. It clearly matches the anchor-5 'multiple specific concrete actions; comprehensive coverage' rather than anchor 4, which requires minor gaps in coverage.

5 / 5

Completeness

It explicitly answers both when ("Use when working with iii SDK APIs across Node.js, browser, Python, Rust, or Go") and what (the enumerated capability list), with concrete trigger conditions. This matches anchor 5 exactly; anchor 4 would require the 'when' to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

Natural domain terms users would say are well covered ("iii SDK", "Node.js", "Python", "Rust", "Go", "channels", "OpenTelemetry"), but common synonyms like "TypeScript"/"JavaScript" are omitted even though the body targets TypeScript. This fits anchor 4 ('good keyword coverage; a few natural terms missing') better than anchor 5's requirement of synonyms and variations.

4 / 5

Distinctiveness Conflict Risk

The iii SDK language-API niche is clear and mostly distinct, but listing "observers" and "trigger registration" overlaps with the sibling `iii-observe` skill that the body itself defers to for the observe model. This is minor overlap with a closely related skill (anchor 4), not the minimal conflict risk of anchor 5 and well above anchor 3.

4 / 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

iii-hq/iii

Path

skills/iii-sdk-reference/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.