CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

iii-architecture-patterns

Use when composing iii primitives into backend architectures: durable workflows, reactive backends, observer side effects, agentic pipelines, event-driven CQRS, effect pipelines, and trigger-transform-action automation.

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/iii-architecture-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

A strong pattern-catalog body: concrete multi-language examples, an explicit requirement-to-pattern decision map, and clean boundary routing to sibling skills. The main improvements are small: deduplicate the When-to-Use section with the opening, complete the Rust example and define the 'publish' target, and move version-sensitive deprecation notes into a dedicated section.

Suggestions

Merge the 'When to Use' section into the opening paragraph or the Pattern Map, since it currently restates the skill's purpose twice within the body.

Complete the Rust durable-workflow example to match the TypeScript one (register the worker and functions) and briefly define the 'publish' and 'stream::send' built-ins or point to iii-core-primitives for them.

Gather the version-sensitive notes ('deprecated in 0.25', 'observable since 0.25') into a short 'Deprecated / version notes' section so they do not interrupt the pattern guidance.

DimensionReasoningScore

Conciseness

The body is lean and code-first — a compact Pattern Map table, one-sentence framing per pattern, and a terse Selection Rules list — with only minor trims available: the 'When to Use' section repeats the opening paragraph and frontmatter, and version-sensitive notes ('deprecated in 0.25', 'since 0.25') sit inline rather than in a deprecated/old-patterns section. This is efficient with minor over-explanation, not the every-token-earns-its-place level of the top anchor.

4 / 5

Actionability

Mostly executable, copy-paste-ready TypeScript and Python examples with real imports and signatures ('registerWorker', 'TriggerAction.Enqueue', 'iii.observe(...)', 'registerTrigger') plus concrete selection rules mapping each requirement to a mechanism. Minor gaps keep it below fully-executable: the Rust snippet is a fragment without worker registration, and 'publish' and 'stream::send' are invoked without being defined.

4 / 5

Workflow Clarity

The selection workflow is clear and well-sequenced: map the requirement in the Pattern Map, apply the Selection Rules to choose a composition mechanism, then implement from the shown shape; failure-mode handling appears in the observer section (echo-loop filtering, 'max_observe_depth' cap). No destructive or batch operations apply, but validation guidance is thin — testing is a single bullet ('Keep each function small enough to test independently') with no verification steps for composed architectures, which fits anchor 4 rather than 5.

4 / 5

Progressive Disclosure

No bundle files exist, so the single body is the whole skill; it is well-sectioned with clear headers, and the Boundaries section cleanly signals where deeper detail lives (iii-core-primitives, iii-observe, iii-engine-config, iii-sdk-reference) as one-level-deep references. Minor organization gaps — the three-language variants are all inlined in one ~250-line file rather than the overview pointing at split reference files — keep it at good-structure rather than the ideal split.

4 / 5

Total

16

/

20

Passed

Description

66%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 distinctive, well-scoped trigger description with concrete pattern keywords, weakened by being phrased entirely as a 'Use when' clause: it never explicitly states what the skill does (e.g., 'Provides patterns and code for composing...'), leaving the 'what' implied. Adding an explicit capability statement would raise completeness from the implicit to the explicit level.

Suggestions

State the 'what' explicitly, e.g., 'Provides architecture patterns and code for composing iii primitives into backend architectures' before the 'Use when' clause, so completeness answers both what and when.

Add one or two natural synonyms users might say, such as 'workflow orchestration', 'event-driven backend', or 'pub/sub fan-out', to broaden trigger-term coverage without adding fluff.

Sharpen the boundary against iii-observe for the observer trigger, e.g., 'Use for observer-based architecture patterns; for observer options and filters use iii-observe.'

DimensionReasoningScore

Specificity

Names the concrete action 'composing iii primitives into backend architectures' and enumerates seven specific pattern types ('durable workflows, reactive backends, observer side effects, agentic pipelines, event-driven CQRS, effect pipelines, and trigger-transform-action automation'), listing several specific items with only a minor gap: no verb states what the skill actually produces for them (code, guidance, design).

4 / 5

Completeness

The 'when' is explicit and concrete ('Use when composing iii primitives into backend architectures'), but the 'what' is never stated — whether the skill provides patterns, code, or design guidance is only implied by the enumerated architectures, since the single sentence is phrased entirely as a trigger. It sits above the pure trigger-only anchor because the enumeration explicitly delimits scope, but below anchor 4, which requires both 'what' and 'when' to be stated.

3 / 5

Trigger Term Quality

Natural phrases a user building on iii would plausibly say ('durable workflows', 'event-driven CQRS', 'reactive backends', 'agentic pipelines') give good keyword coverage, but common synonyms and variations ('workflow orchestration', 'event sourcing', 'pub/sub', 'webhook automation') are missing, so it does not reach the comprehensive synonym-level coverage of the top anchor.

4 / 5

Distinctiveness Conflict Risk

'iii primitives', 'effect pipelines', and 'event-driven CQRS' carve a clear niche that would not trigger generic skills, but the listed trigger 'observer side effects' overlaps with the sibling iii-observe skill's territory, creating minor overlap risk with a closely related skill.

4 / 5

Total

15

/

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-architecture-patterns/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.