CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-climate

Code Climate (Qlty) integration. Manage Repositories, Organizations. Use when the user wants to interact with Code Climate (Qlty) data.

Quality

75%

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

Fix and improve this skill with Tessl

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

Quality

Content

75%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 strong, executable operational guide: concrete CLI commands cover setup, connection state handling, action discovery/execution, and a proxy fallback. Weaknesses are a padded intro paragraph, a dangling "Step 2" reference in the workflow, and no out-of-line reference files for the lengthy action catalog.

Suggestions

Delete or trim the opening platform-summary paragraph — Code Climate's purpose and user base are background Claude does not need to operate the CLI.

Fix the broken workflow numbering: either label the sections Step 1/1b/2 consistently or replace the "skip to Step 2" references with descriptive section names.

Add a brief validation note for destructive actions (e.g. confirm repository name and verify with get-repository before running delete-repository).

DimensionReasoningScore

Conciseness

The body is mostly commands and tables, but the intro paragraph ("Code Climate is a platform that helps software engineering teams improve code quality... It's used by developers, QA engineers, and engineering managers") pads with who-uses-it background Claude does not need, and phrases like "This will burn less tokens" add fluff. This fits 'mostly efficient with some unnecessary explanation' rather than the more heavily padded anchor 2.

3 / 5

Actionability

Commands are copy-paste ready throughout: install (npm install -g @membranehq/cli@latest), both interactive and headless auth flows, connection ensure with polling, action list/run with a concrete --input JSON example, and a full proxy flag table. Minor placeholders (CONNECTION_ID) and one npx-vs-global inconsistency do not undermine coverage of the common cases.

5 / 5

Workflow Clarity

A clear install → login → connect → poll → search → run sequence exists with an explicit state machine (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) and a retry loop after the user completes an action. Gaps: "skip to Step 2" references a Step 2 that is never labeled, the "1b" heading has no companion numbering, and the destructive delete-repository action gets no validation guidance.

4 / 5

Progressive Disclosure

Sections are well organized (install, auth, connect, search, run, proxy, best practices) with no nested references, but there are no bundle files at all — the 20-row action catalog is inlined in a ~158-line SKILL.md. The table doubles as the discovery surface so inline is defensible, fitting 'good structure; most content appropriately placed; minor organization gaps' rather than the well-split reference-file anchor 5.

4 / 5

Total

16

/

20

Passed

Description

66%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 distinct and has an explicit what/when structure, but it under-sells the skill's actual capabilities. "Manage" is generic, and trigger coverage relies entirely on brand names with no functional terms like code quality, test coverage, or code review.

Suggestions

Replace the generic verb "Manage" with concrete operations from the action catalog, e.g. "Retrieve repository quality ratings, list test coverage reports and snapshot issues, add or remove repositories, manage organizations and members".

Add functional trigger terms to the 'Use when' clause, e.g. "Use when the user mentions Code Climate, Qlty, code quality ratings, test coverage reports, or snapshot issues".

Mention both brand spellings and common shorthand (Code Climate, Qlty, code quality analysis) so users referencing the platform by either name trigger the skill.

DimensionReasoningScore

Specificity

"Manage Repositories, Organizations" names the domain and two concrete entity groups, but "Manage" is a generic verb and no specific operations (ratings, coverage reports, issues) are listed. It sits between the generic-action anchor (2) and the 1-2 concrete actions anchor (3); the two concrete objects lift it to 3.

3 / 5

Completeness

Both what ("Manage Repositories, Organizations") and when ("Use when the user wants to interact with Code Climate (Qlty) data") are explicitly present, but the when-clause is circular — it restates the product name rather than giving concrete usage scenarios, fitting the anchor where 'when' could be more explicit or specific.

4 / 5

Trigger Term Quality

"Code Climate (Qlty)" covers both brand names, the key synonym pair, plus "Repositories" and "Organizations". However, natural functional phrases users would say — "code quality", "test coverage", "code review" — are missing, matching the anchor for some relevant keywords but missing common variations.

3 / 5

Distinctiveness Conflict Risk

Code Climate (Qlty) is a specific named product with distinct triggers, giving it a clear niche and minimal conflict risk with other skills. Although "Repositories" and "Organizations" are generic nouns, the trigger is explicitly tied to Code Climate.

5 / 5

Total

15

/

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