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.

56

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 has good structure with an explicit 'Use when' clause and a distinctive niche tied to the 'iii engine'. However, the capabilities described are somewhat abstract and conceptual rather than listing concrete actions, and the trigger terms could be broader to capture more natural user phrasings. The specificity of the engine name helps with distinctiveness but may hurt discoverability if users don't know the term.

Suggestions

Add more concrete actions such as 'create pipeline steps', 'compose effect handlers', 'add tracing spans' to improve specificity beyond conceptual descriptions.

Include alternative trigger terms users might naturally say, such as 'function composition', 'pipe operator', 'middleware chain', or 'monadic effects' to improve keyword coverage.

DimensionReasoningScore

Specificity

It names the domain ('composable, pipeable function chains on the iii engine') and mentions some actions/concepts (functional pipelines, effect systems, typed composition layers, pure functions, distributed tracing), but the actions are more conceptual than concrete—it doesn't list specific operations like 'create a pipeline step', 'add tracing middleware', or 'compose effects'.

2 / 3

Completeness

Clearly answers both 'what' (builds composable, pipeable function chains on the iii engine) and 'when' (Use when building functional pipelines, effect systems, or typed composition layers where each step is a pure function with distributed tracing). The 'Use when' clause is explicit with trigger conditions.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'functional pipelines', 'effect systems', 'typed composition', 'pure function', and 'distributed tracing', but 'iii engine' is a niche/proprietary term that users may not naturally say. Missing common variations or alternative phrasings users might use (e.g., 'pipe operator', 'function composition', 'middleware chain').

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 proprietary engine name alone provides strong distinctiveness.

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. However, it falls short on actionability by lacking inline executable code (relying on an unverifiable external reference), and the workflow lacks explicit validation/error-recovery checkpoints. There is also some redundancy between sections that could be tightened.

Suggestions

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

Add explicit error handling and validation guidance — e.g., what happens when an effect throws, how to verify the pipeline executed correctly, and how to debug a broken chain.

Consolidate the 'When to Use', 'Boundaries', and 'Pattern Boundaries' sections into a single decision section to reduce redundancy.

DimensionReasoningScore

Conciseness

The content is mostly efficient but includes some redundancy — the 'When to Use' and 'Boundaries' sections at the bottom repeat information already conveyed in 'Pattern Boundaries'. The 'Common Patterns' section partially restates what's already shown in the primitives table. Some filler phrases like 'Use the concepts below when they fit the task' add little value.

2 / 3

Actionability

The skill provides API signatures and an architecture diagram, but lacks executable code inline. It references an external file (effect-system.js) for the actual implementation, and the 'Common Patterns' section lists code snippets but not in a copy-paste-ready, complete form. The guidance is concrete enough to follow but not fully executable from the skill body alone.

2 / 3

Workflow Clarity

The architecture diagram shows a clear sequence of steps, and the composition model (trigger chaining) is explained. However, there are no explicit validation checkpoints, no error recovery feedback loops, and no verification steps after pipeline execution. For a pattern involving chained effects where errors propagate, explicit guidance on error handling and validation would strengthen this.

2 / 3

Progressive Disclosure

The skill references an external file (../references/effect-system.js) for the full implementation, which is good progressive disclosure. However, no bundle files were provided, so the reference cannot be verified. The skill itself is reasonably structured with clear sections, but the 'Common Patterns' and 'Adapting This Pattern' sections could be better signaled or split. The cross-references to other iii skills (workflow-orchestration, agentic-backend) in Pattern Boundaries are helpful for navigation.

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.