CtrlK
BlogDocsLog inGet started
Tessl Logo

iii-effect-system

Builds composable, pipeable function chains on the iii engine. Use when building functional pipelines, effect systems, or typed composition layers where each step is a pure function with distributed tracing.

70

Quality

62%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/iii-effect-system/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 and targets a very specific niche (the iii engine), making it distinctive and complete. Its main weakness is that the capabilities could be more concretely enumerated—listing specific actions rather than abstract concepts—and the trigger terms, while relevant, lean heavily on technical jargon that may not match how all users phrase their requests.

Suggestions

List more concrete actions the skill performs, e.g., 'define pipeline steps, compose effect handlers, attach distributed tracing spans, type-check composition layers'.

Add common user-facing variations of trigger terms such as 'pipe operator', 'function composition', 'middleware chain', or 'iii framework' to improve matching.

DimensionReasoningScore

Specificity

It names the domain ('composable, pipeable function chains on the iii engine') and mentions some actions like building functional pipelines and typed composition layers, but the actions are described at a high level rather than listing multiple concrete, distinct operations (e.g., 'create pipeline steps', 'add tracing middleware', 'compose effect handlers').

2 / 3

Completeness

The description clearly answers both 'what' (builds composable, pipeable function chains on the iii engine) and 'when' (explicit 'Use when' clause covering functional pipelines, effect systems, typed composition layers with pure functions and distributed tracing).

3 / 3

Trigger Term Quality

Includes some relevant terms like 'functional pipelines', 'effect systems', 'typed composition', 'pure function', 'distributed tracing', and 'iii engine'. However, some terms are fairly niche/technical and it misses common variations a user might say (e.g., 'pipe operator', 'function composition', 'middleware chain', 'iii').

2 / 3

Distinctiveness Conflict Risk

The combination of 'iii engine', 'pipeable function chains', 'effect systems', and 'distributed tracing' creates a very specific niche that is unlikely to conflict with other skills. The 'iii engine' reference alone makes this highly distinctive.

3 / 3

Total

10

/

12

Passed

Implementation

50%

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 conceptual framework for building effect systems on the iii engine, with good architectural overview and clear pattern boundaries for when to use alternative skills. However, it lacks inline executable code examples, relying entirely on an external reference file that isn't bundled, and misses validation/error-handling guidance in its workflow. Some sections are redundant and could be consolidated for better token efficiency.

Suggestions

Add at least one inline executable code snippet showing a minimal two-effect composition (e.g., parse → persist) rather than relying solely on the external reference file.

Add explicit error handling guidance: what happens when an effect throws, how to debug a broken chain, and whether/how to add retry logic for specific effects.

Consolidate the 'Common Patterns' section with the 'iii Primitives Used' table — they largely overlap — to improve conciseness.

Include the referenced effect-system.js in the bundle or inline a condensed version, since the skill's actionability depends heavily on that file.

DimensionReasoningScore

Conciseness

The content is mostly efficient but includes some redundancy — the 'Common Patterns' section largely restates what's already shown in the architecture diagram and primitives table. The 'When to Use' and 'Boundaries' sections at the bottom are generic boilerplate that adds little value. However, it avoids explaining basic concepts Claude would already know.

2 / 3

Actionability

The skill provides a clear architecture diagram, a primitives table, and naming conventions, but lacks any executable code inline. It references an external file (effect-system.js) for the actual implementation, meaning the skill body itself only offers pseudocode-level guidance through the table and pattern descriptions rather than copy-paste ready examples.

2 / 3

Workflow Clarity

The architecture diagram shows a clear sequence of steps, and the pattern boundaries help with decision-making. However, there are no explicit validation checkpoints, error recovery steps, or feedback loops for what to do when an effect fails — despite the skill noting that 'errors propagate naturally,' there's no guidance on handling or debugging failures in the chain.

2 / 3

Progressive Disclosure

The skill references an external file (../references/effect-system.js) for the full implementation, which is good progressive disclosure structure. However, no bundle files were provided, so the reference cannot be verified. The content itself is reasonably organized with clear sections, but the 'Common Patterns' and 'Adapting This Pattern' sections could be better signaled or consolidated.

2 / 3

Total

8

/

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.