CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-block

Create or update a Sim integration block with correct subBlocks, conditions, dependsOn, modes, canonicalParamId usage, outputs, and tool wiring. Use when working on `apps/sim/blocks/blocks/{service}.ts` or aligning a block with its tools.

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable, well-structured reference skill: executable code patterns for every construct, an explicit final-validation checkpoint, and a thorough completion checklist. Its weaknesses are redundancy (duplicated wandConfig/canonicalParamId/V2 sections worth ~100+ lines) and the absence of any progressive disclosure — everything, including pure reference material, is inlined in one very long SKILL.md.

Suggestions

Deduplicate the body: merge the two wandConfig sections into one, state the canonicalParamId constraints once, and show createVersionedToolSelector in only one place — this trims roughly 100+ lines without losing information.

Split pure reference material (SubBlock Types Reference, Condition/DependsOn syntax, V2 patterns) into a references/ file (e.g., references/subblock-types.md) and keep SKILL.md focused on the workflow plus clearly-signaled one-level-deep pointers.

Add an error-recovery loop to Final Validation: instruct that if a tool/block mismatch is found (missing param, wrong condition, missing output), fix the subBlock or tools wiring and re-run the verification before finishing.

DimensionReasoningScore

Conciseness

The bulk is lean, repo-specific code and constraints Claude cannot infer, but there is notable redundancy: two separate wandConfig sections ("WandConfig Pattern" and "WandConfig for Complex Inputs"), canonicalParamId "Critical constraints" stated twice in near-identical wording, createVersionedToolSelector demonstrated twice, a Complete Example that largely restates the Block Configuration Structure skeleton, and an "You are an expert…" persona line. This fits anchor 3 (mostly efficient, could be tightened) — the redundancy exceeds the 'minor instances' of anchor 4 but is far from the padded over-explanation of anchor 2.

3 / 5

Actionability

Fully executable guidance throughout: complete TypeScript skeletons for every subBlock type with imports, concrete tools.config transform patterns, a registry snippet, an exact icon-request script, and a near-copy-paste Complete Example covering the common case. Matches anchor 5 — the {service} placeholders are justified templates, not pseudocode, so it does not fall to anchor 4.

5 / 5

Workflow Clarity

A clear sequence exists (create file → configure subBlocks → wire tools → register → checklist), and the "Final Validation (Required)" section is an explicit verification checkpoint ("Read every tool definition that appears in tools.access — do not skip any", verify param mappings, outputs, conditions) backed by a 14-item checklist. It falls short of anchor 5 only because there is no error-recovery feedback loop (no 'if validation finds a mismatch, fix the wiring and re-verify' path), placing it at anchor 4 with a minor validation gap.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/); all ~826 lines live inline in SKILL.md. Section headers are clear and well-ordered, but substantial reference material (SubBlock Types Reference, Condition/DependsOn syntax, V2 patterns) clearly belongs in separate files. This matches anchor 3 (some structure, but content that should be separate is inline) — better organized than anchor 2, but an 826-line skill with zero reference files cannot reach anchor 4's 'most content is appropriately placed'.

3 / 5

Total

15

/

20

Passed

Description

92%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 strong description: concrete and comprehensive on capabilities, with an explicit and specific 'Use when' clause tied to the exact file path and tool-alignment scenario. The only weakness is slightly thin natural-language trigger coverage (missing common user phrasings like "add a block" or service-specific mentions) relative to the jargon-heavy term list.

DimensionReasoningScore

Specificity

"Create or update a Sim integration block with correct subBlocks, conditions, dependsOn, modes, canonicalParamId usage, outputs, and tool wiring" enumerates multiple concrete actions (create, update, align) with comprehensive, gap-free coverage of the block-config domain — no vague language anywhere. It clearly matches the score-5 anchor rather than 4, which would require minor gaps in coverage; no core block-configuration area is absent.

5 / 5

Completeness

Explicitly answers both: what ("Create or update a Sim integration block with correct subBlocks, conditions, dependsOn, modes, canonicalParamId usage, outputs, and tool wiring") and when ("Use when working on `apps/sim/blocks/blocks/{service}.ts` or aligning a block with its tools") with two concrete trigger phrases. This matches anchor 5; it is above anchor 4 because the 'when' clause is explicit and concrete rather than merely present.

5 / 5

Trigger Term Quality

Natural terms a user would say are present: "block", "Sim integration block", "tools", and the concrete file path "apps/sim/blocks/blocks/{service}.ts". Common variations are missing (e.g., "add a block", "new integration", service-specific phrasing), so it fits anchor 4 (good coverage, a few natural terms missing) rather than 5's synonym-level coverage; it exceeds anchor 3 because the core natural domain terms are all present.

4 / 5

Distinctiveness Conflict Risk

The description targets a clear niche — Sim's block system, anchored by the exact file path `apps/sim/blocks/blocks/{service}.ts` — making it highly distinguishable from other skills with minimal conflict risk. Clean match to the score-5 anchor.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (826 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

itsablabla/jada-ironman

Path

.agents/skills/add-block/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.