CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

checkmarx

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

Quality

67%

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/checkmarx/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 is a solid, command-first integration guide with a genuinely well-handled connection state machine, held back by redundant sections, conceptual padding, and a broken 'Step 2' cross-reference. Offloading the proxy options and clientAction details to reference files would tighten the main document.

Suggestions

Fix the dangling references: the text says 'skip to Step 2' twice but no Step 2 section exists, and '1b. Wait for the connection' has no corresponding numbered '1' heading — renumber the workflow explicitly.

Remove the redundant 'Popular actions' section (it repeats the 'Searching for actions' command verbatim) and trim the conceptual intro about what SAST is.

Move the proxy flag table and the clientAction field breakdown into a reference file (e.g. references/proxy.md) and add one concrete Checkmarx example (e.g. fetching scan results) to the action examples.

DimensionReasoningScore

Conciseness

Mostly command-driven and efficient, but it includes unnecessary padding: a two-sentence conceptual intro explaining what a SAST platform is ('Developers and security teams use it to identify vulnerabilities...'), marketing phrasing ('so you can focus on the integration logic rather than auth plumbing'), and a 'Popular actions' section that restates the exact command already given in 'Searching for actions'. This fits anchor 3 ('includes some unnecessary explanation or could be tightened') rather than 4's 'minor instances'.

3 / 5

Actionability

The body is full of concrete, executable commands — 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://www.checkmarx.com" --json', 'membrane action run <actionId> --connectionId=... --input ... --json' — plus a flag table for proxy requests and a complete headless-login fallback. It falls short of anchor 5 because examples never show a Checkmarx-specific use (e.g. an actual scan or vulnerability query) and key invocations remain placeholder-level.

4 / 5

Workflow Clarity

The sequence (install CLI → login → connection ensure → poll until READY → search actions → run/proxy) is clear, and the connection state machine provides genuine checkpoints (long-poll with --wait, handle CLIENT_ACTION_REQUIRED then re-poll, check the error field on failure). It is not a 5 because the body twice says 'skip to Step 2' yet no Step 2 exists in the document, and the '1b' numbering implies a '1' that isn't labeled — minor coherence gaps rather than validation gaps, so anchor 4 fits better than 3.

4 / 5

Progressive Disclosure

No bundle files exist and all content is inline in a ~140-line body with reasonable section headers. Content that plausibly belongs in a separate reference — the proxy flag table, the clientAction schema breakdown, and the agent-type list — is inlined, fitting anchor 3 ('could be better organized; content that should be separate is inline') rather than 4, since the SKILL.md is doing all the work itself with no offloading.

3 / 5

Total

14

/

20

Passed

Description

57%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 correctly identifies the domain and includes an explicit 'Use when' clause, but its capability statement is boilerplate that could describe almost any data integration. Replacing the generic filler with concrete Checkmarx operations (scans, projects, queries, vulnerability reports) and adding SAST/security-scan synonyms would substantially improve it.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete Checkmarx capabilities, e.g. 'Run scans, retrieve scan results and risk reports, and manage projects and queries in Checkmarx'.

Add natural trigger synonyms such as 'SAST', 'security scan', 'vulnerability scan', or 'code scanning' so users who mention these terms without saying 'Checkmarx' still match.

Make the 'when' clause more specific, e.g. 'Use when the user wants to run or check Checkmarx scans, fetch vulnerability results, or manage Checkmarx projects'.

DimensionReasoningScore

Specificity

The description names the domain ('Checkmarx integration') but the actions are boilerplate-generic: 'Manage data, records, and automate workflows' names no concrete Checkmarx operations (scans, projects, queries, vulnerability reports). It matches anchor 2 ('Names the domain but actions are minimal or generic') rather than anchor 3, which requires 1-2 concrete actions, and is above anchor 1 because the domain is clearly identified.

2 / 5

Completeness

Both parts are present: the 'what' ('Checkmarx integration. Manage data, records, and automate workflows') and an explicit 'when' clause ('Use when the user wants to interact with Checkmarx data'). It is not a 5 because the 'what' is generic rather than describing concrete capabilities and the 'when' is broad rather than trigger-specific; it is above 3 because the 'when' is explicit, not merely implied.

4 / 5

Trigger Term Quality

The only meaningful keyword is 'Checkmarx' (repeated in 'interact with Checkmarx data'), which is a term users would say, but common variations are missing: 'SAST', 'scan', 'vulnerability', 'security scan', 'code scan'. This fits anchor 3 ('Some relevant keywords but missing common variations or synonyms') better than 4, which requires good keyword coverage.

3 / 5

Distinctiveness Conflict Risk

The Checkmarx name anchors the skill to a clear niche, and the 'when' clause is conditioned on Checkmarx specifically, so wrong-skill triggering is unlikely. It falls short of anchor 5 because the generic filler 'Manage data, records, and automate workflows' overlaps phrasing common to many data-integration skills and adds no distinct trigger.

4 / 5

Total

13

/

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/checkmarx/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.