CtrlK
BlogDocsLog inGet started
Tessl Logo

create-go-module

Create a new Go module in the agent repository

56

Quality

66%

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 ./.claude/skills/create-go-module/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-crafted skill that efficiently guides Claude through creating a Go module in a complex multi-module repository. It provides exact commands, a clear sequential workflow with validation steps, and a useful reference table for configuration — all without over-explaining concepts Claude already understands. The usage section at the end cleanly shows invocation patterns.

DimensionReasoningScore

Conciseness

The content is lean and efficient. It doesn't explain what Go modules are, what replace directives do conceptually, or how multi-module repos work — it assumes Claude knows all of this. Every section serves a clear purpose with no padding.

3 / 3

Actionability

Provides the exact command to run (`dda inv create-module --path=<module-path>`), specifies what to collect from the user, includes a concrete table of `modules.yml` fields with values, and gives clear usage examples. The guidance is specific and directly executable.

3 / 3

Workflow Clarity

The 5-step workflow is clearly sequenced with logical checkpoints: gather info → verify clean git state → run command → review output → report results. Step 2 serves as a validation gate before the destructive operation, and Step 5 includes error handling guidance. The task itself runs linters as built-in validation.

3 / 3

Progressive Disclosure

For a skill of this size and scope (single task, under 80 lines), the content is well-organized with clear sections, a reference table for configuration options, and no need for external files. The structure is appropriate and easy to navigate.

3 / 3

Total

12

/

12

Passed

Description

32%

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 too terse—it states a single action without elaborating on specific sub-tasks or providing any trigger guidance for when Claude should select this skill. It lacks natural keyword variations and a 'Use when...' clause, making it difficult for Claude to reliably choose this skill from a large pool.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to create a new Go module, initialize a go.mod file, or scaffold a Go package in the agent repository.'

List more specific concrete actions such as 'Initializes go.mod, sets up package directory structure, configures module dependencies, and creates boilerplate Go files.'

Include natural trigger term variations like 'go.mod', 'golang module', 'Go package', 'new Go service', 'scaffold Go code'.

DimensionReasoningScore

Specificity

Names the domain (Go module) and a single action (create), but does not list multiple concrete actions or elaborate on what creating a Go module entails (e.g., initializing go.mod, setting up directory structure, adding dependencies).

2 / 3

Completeness

Describes what it does (create a Go module) but provides no explicit 'Use when...' clause or trigger guidance for when Claude should select this skill. Per rubric guidelines, missing 'Use when' caps completeness at 2, and the 'what' is also quite thin, warranting a 1.

1 / 3

Trigger Term Quality

Includes relevant terms like 'Go module' and 'agent repository', but misses common variations users might say such as 'go.mod', 'Go package', 'new module', 'initialize module', or 'golang'.

2 / 3

Distinctiveness Conflict Risk

Somewhat specific to Go modules in an agent repository, which narrows the scope, but could overlap with general Go development skills or repository scaffolding skills without clearer differentiation.

2 / 3

Total

7

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
DataDog/datadog-agent
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.