CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tfgen-set-of-objects-and-go-names

Use when tfgen check fails with RENDERER_SHAPE_UNSUPPORTED set of object, or RENDERER_OUTPUT_INVALID on a dotted OpenAPI component like notification_center.ConnectorConfigField. Fix collectionConv and modelTypeName, not the generated files.

72

Quality

90%

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

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

Expert-level, zero-padding content: every line carries non-obvious domain knowledge with precise identifiers, formulas, and prohibitions, and the structure is appropriately self-contained. The weaknesses are the absence of any explicit verification checkpoint (re-running `tfgen check`) and the lack of a code-level example of the corrected output, which cap workflow clarity and actionability.

Suggestions

Add an explicit verification checkpoint: after applying the fixes, re-run `tfgen check` and confirm the RENDERER_SHAPE_UNSUPPORTED / RENDERER_OUTPUT_INVALID errors are gone before considering the task complete (workflow_clarity).

Break the sets-of-objects fix into a short ordered list — collectionConv, expand/flatten helpers, diagnostics paths, same* comparison, golden fixture — since it requires coordinated changes across several functions and the current single bullet gives no application order (workflow_clarity).

Include a minimal before/after snippet of `collectionConv` accepting `model.Set` of objects, and of `modelTypeName` returning `model.GoName(schema)+"Model"`, so the fixes are copy-paste ready rather than descriptive (actionability).

DimensionReasoningScore

Conciseness

The ~14-line body is dense with non-obvious, project-specific rules ("Nested `keepPriorOrder` lists still use `sameUnordered` in `same*`", "OpenAPI `x-coralogix-collection: set` on object arrays is the contract for Terraform Sets") and contains no padding or explanation of concepts Claude already knows. Every token earns its place, matching the lean-and-efficient anchor.

5 / 5

Actionability

The guidance names exact functions and helpers (`collectionConv`, `expandElements`, `flattenSet`), gives a near-copy-paste expression ("`modelTypeName` must be `model.GoName(schema)+\"Model\"`, same as SDK `camelize`"), and explicit prohibitions ("Do not pair set items with prior by slice index"). It falls between anchors 3 and 4 — noticeably above the midpoint — but is not fully executable since there is no code snippet, diff, or command showing the corrected `collectionConv` shape or how to re-run the check.

4 / 5

Workflow Clarity

The Trigger → Fix → Why structure is coherent and fixes are organized by failure mode, but the sets-of-objects bullet bundles five coordinated changes (converter, expand/flatten, diagnostics, ordering, golden fixture) into one unordered list, and verification is only implicit — re-running `tfgen check` after the fix is never stated as a checkpoint. This matches the anchor for sequence present but checkpoints missing or implicit; it is not 4 because no explicit validation step exists.

3 / 5

Progressive Disclosure

The skill is a self-contained under-50-line body with clear Trigger/Fix/Why sections and no bundle files exist, so none are needed. Per the simple-skill guidance, a flat, well-organized SKILL.md with no external references scores full marks here.

5 / 5

Total

17

/

20

Passed

Description

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

An exemplary skill description for a narrow internal-tool niche: it contains an explicit "Use when" clause whose trigger terms match the exact error output a user would paste, an explicit statement of what to fix and what not to touch, and near-zero conflict risk. The only weakness is that the "what" stops at naming the two functions without hinting at the fix mechanics.

DimensionReasoningScore

Specificity

The description names concrete actions and constraints — "Fix collectionConv and modelTypeName, not the generated files" — and identifies exact error codes ("RENDERER_SHAPE_UNSUPPORTED set of object", "RENDERER_OUTPUT_INVALID"). It falls short of anchor 5 because the fix mechanics detailed in the body (e.g., accepting model.Set, model.GoName(schema)+"Model") are omitted, leaving minor gaps in action coverage rather than comprehensive coverage.

4 / 5

Completeness

It explicitly answers both questions: when — "Use when tfgen check fails with RENDERER_SHAPE_UNSUPPORTED set of object, or RENDERER_OUTPUT_INVALID on a dotted OpenAPI component" — and what — "Fix collectionConv and modelTypeName, not the generated files". This matches the anchor for clear, concrete answers to both what and when.

5 / 5

Trigger Term Quality

"tfgen check fails", "RENDERER_SHAPE_UNSUPPORTED set of object", "RENDERER_OUTPUT_INVALID", and "notification_center.ConnectorConfigField" are exactly the strings a user would paste from a failing tfgen run, covering both failure modes with a concrete example. These are the natural trigger terms for this niche; there are no meaningful synonyms or variations missing at the description level.

5 / 5

Distinctiveness Conflict Risk

The description is scoped to a single internal tool (tfgen) with specific error codes and a named dotted component ("notification_center.ConnectorConfigField"), giving it a clear niche with distinct triggers and essentially no overlap risk with other skills.

5 / 5

Total

19

/

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

coralogix/terraform-provider-coralogix

Path

.claude/skills/tfgen-set-of-objects-and-go-names/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.