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
62%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/iii-effect-system/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
d51a06d
Table of Contents
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.