CtrlK
BlogDocsLog inGet started
Tessl Logo

iii-python-sdk

Python SDK for the iii engine. Use when building workers, registering functions, or invoking triggers in Python.

58

Quality

66%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/iii-python-sdk/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

75%

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 well-structured with a clear 'Use when...' clause that explicitly states both what the skill does and when to use it. Its main weakness is that the actions listed ('building workers', 'registering functions', 'invoking triggers') are somewhat abstract and could benefit from more concrete elaboration. The trigger terms are adequate but lean technical, potentially missing more natural user phrasings.

Suggestions

Add more concrete action descriptions, e.g., 'define worker classes, register handler functions, configure and fire event triggers' to improve specificity.

Include natural language variations users might say, such as 'iii Python library', 'iii API', or 'iii integration' to broaden trigger term coverage.

DimensionReasoningScore

Specificity

Names the domain ('Python SDK for the iii engine') and some actions ('building workers, registering functions, invoking triggers'), but these are somewhat abstract and not fully concrete—e.g., what does 'building workers' entail specifically?

2 / 3

Completeness

Clearly answers both 'what' ('Python SDK for the iii engine') and 'when' ('Use when building workers, registering functions, or invoking triggers in Python'), with an explicit 'Use when...' clause.

3 / 3

Trigger Term Quality

Includes relevant keywords like 'Python', 'SDK', 'workers', 'functions', 'triggers', and 'iii engine', but these are fairly technical and may miss natural user phrasing variations. A user might say 'iii Python library' or 'iii API' which aren't covered.

2 / 3

Distinctiveness Conflict Risk

The combination of 'iii engine', 'Python SDK', 'workers', 'registering functions', and 'invoking triggers' creates a very specific niche that is unlikely to conflict with other skills.

3 / 3

Total

10

/

12

Passed

Implementation

57%

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

This skill provides a solid API reference overview with good progressive disclosure to related skills, but falls short on actionability by lacking a complete end-to-end working example. The workflow for setting up a worker is implicit rather than explicitly sequenced, and some sections (When to Use, Boundaries) add boilerplate without value.

Suggestions

Add a complete 'Quick Start' example showing the full workflow: install → register_worker → register_function → keep event loop alive, as a single copy-paste-ready script.

Add an executable code example for the Channels section rather than just describing the API surface.

Remove or significantly trim the 'When to Use' and 'Boundaries' sections, which are generic boilerplate that doesn't help Claude execute tasks.

DimensionReasoningScore

Conciseness

The content is mostly efficient with a good reference table and concise code examples, but the 'When to Use' and 'Boundaries' sections are boilerplate that Claude doesn't need, and some notes could be tightened (e.g., the trigger_async vs trigger explanation is somewhat redundant with the examples).

2 / 3

Actionability

Provides some executable code examples for register_function, trigger, and trigger_async, but lacks a complete minimal working example (e.g., full worker setup with register_worker through to keeping the event loop alive). The channels section describes API surface without executable code.

2 / 3

Workflow Clarity

There's no explicit step-by-step workflow for setting up a worker from scratch (install → register_worker → register_function → keep alive). The pieces are present but scattered across sections without a clear sequenced workflow or validation checkpoints.

2 / 3

Progressive Disclosure

The Pattern Boundaries section provides clear, one-level-deep references to related skills for specific topics (channels, error handling, HTTP middleware, etc.). The main content serves as a concise overview with appropriate pointers to detailed materials and external docs.

3 / 3

Total

9

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
iii-hq/iii
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.