CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-dx

Code Dx integration. Manage data, records, and automate workflows. Use when the user wants to interact with Code Dx data.

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/code-dx/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body delivers strong, executable CLI guidance with a well-handled connection state machine, but it is held back by redundant sections, an unexplained Code Dx entity hierarchy, broken step cross-references, and the absence of any concrete Code Dx action example.

Suggestions

Fix the broken cross-references: define what "Step 2" is or replace it with the actual section name ("Searching for actions"), and renumber the connection subsections so "1b." has a matching "1a.".

Remove the redundant "Popular actions" section and the "When to use which actions" filler line; fold anything unique into "Searching for actions".

Add one concrete Code Dx example (e.g. an action run fetching findings for a project) so the generic CLI pattern is grounded in the skill's actual domain.

DimensionReasoningScore

Conciseness

The body is mostly command-driven and efficient, but includes trimmable material: a two-sentence intro explaining what Code Dx is, a vague entity bullet list under "Code Dx Overview" with the filler line "When to use which actions: Use action names and parameters as needed.", and a "Popular actions" section that restates the action-list command already shown. This matches anchor 3 (mostly efficient but includes some unnecessary explanation or could be tightened); the redundancy exceeds the "minor instances" of anchor 4.

3 / 5

Actionability

Concrete copy-paste-ready commands appear throughout (npm install, membrane login, connection ensure --json, polling with --wait, action run --input, and a full proxy flag table). It stops short of anchor 5 because no Code Dx-specific worked example exists — every example is generic CLI scaffolding with placeholders rather than a real finding/project operation.

4 / 5

Workflow Clarity

The sequence (install → login → connect → poll → discover → run) is clear, and the connection state machine (READY / BUILDING / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) with per-state recovery instructions is a genuine feedback loop. Minor gaps keep it below 5: "skip to **Step 2**" references a step that is never defined, and "#### 1b." implies an unlabeled "1a".

4 / 5

Progressive Disclosure

This is a single-file skill with no bundle files; content is well-sectioned with clear headers, logical ordering, and no nested references. It fits anchor 4 (good structure, content appropriately placed, minor organization gaps) — the gaps being the redundant "Popular actions" section and the broken step numbering — but not 5, since a cleaner split (e.g. moving the clientAction state reference or proxy flag table to a reference file) would improve navigation.

4 / 5

Total

15

/

20

Passed

Description

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

The description is distinctive and has an explicit use-when clause, but its capability statement is generic ("Manage data, records, and automate workflows") and it omits the domain vocabulary (findings, vulnerabilities, analyses, projects) that would make triggers natural for Code Dx users.

Suggestions

Replace generic actions with concrete Code Dx operations, e.g. "Query and triage findings, run analyses on projects, and manage comments and users".

Add natural trigger terms to the when clause, e.g. "Use when the user mentions Code Dx, wants to fetch or triage security findings, or needs to automate Code Dx workflows".

Mention the key entities (projects, analyses, findings) so the description doubles as a coverage map of what the skill can do.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the Code Dx domain but the actions are generic ("manage data" is close to "Processes data"), with no concrete operations like extracting findings or running analyses. It is above anchor 1 because the domain is named and multiple actions are listed, but below anchor 3 because none of the actions are concrete.

2 / 5

Completeness

Both halves are present: a what ("Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with Code Dx data"). It is not 5 because the what is generic and the when lacks concrete trigger phrases beyond "interact with Code Dx data"; it is above 3 because the when is explicit rather than missing or implied.

4 / 5

Trigger Term Quality

"Code Dx" is a specific, natural trigger term and "data", "records", "workflows" add some coverage, but the vocabulary users of this tool would actually say — findings, vulnerabilities, security analysis, projects — is missing. This matches anchor 3 (relevant keywords but missing common variations/synonyms); it exceeds anchor 2 because the keywords are domain-specific rather than purely generic.

3 / 5

Distinctiveness Conflict Risk

The description repeatedly names the niche product "Code Dx" ("Code Dx integration", "interact with Code Dx data"), giving it a clear niche with distinct triggers and minimal conflict risk with other skills. This clearly matches the anchor-5 example profile.

5 / 5

Total

14

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

membranedev/application-skills

Path

skills/code-dx/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.