CtrlK
BlogDocsLog inGet started
Tessl Logo

codeq-natural-language-processing-api

Codeq Natural Language Processing API integration. Manage data, records, and automate workflows. Use when the user wants to interact with Codeq Natural Language Processing API data.

54

Quality

61%

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/codeq-natural-language-processing-api/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 content is a lean, actionable integration guide with executable Membrane CLI commands, a clear connect-to-run workflow, and explicit connection-state validation checkpoints. Its main weaknesses are a dangling 'Step 2' reference and a 'Popular actions' section that discovers rather than showcases actions.

DimensionReasoningScore

Conciseness

The body is mostly commands, tables, and state-handling lists with little padding; only minor trimmable bits remain ('so you can focus on the integration logic rather than auth plumbing', the opening 'provides tools for understanding and processing human language' sentence), fitting 'Efficient; minor instances of over-explanation that could be trimmed' rather than the 3-anchor's 'some unnecessary explanation'.

4 / 5

Actionability

It gives copy-paste-ready commands for install, login, connection ensure, action list/run, and proxy with a full flag table, but leaves minor gaps — the 'Popular actions' section only re-prints the discovery command without naming actual popular actions, and 'Use action names and parameters as needed' is vague — matching 'Mostly executable guidance; concrete code or commands with minor gaps'.

4 / 5

Workflow Clarity

The connect-and-run sequence is clear with explicit validation (poll until state leaves BUILDING, branch on READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR, re-poll after user action), but the 'skip to Step 2' reference points to an unlabeled step, a minor sequencing gap that keeps it at the 4-anchor rather than 5.

4 / 5

Progressive Disclosure

With no bundle files present the body is self-contained and well-organized into headed sections (Overview, Working with…, Authentication, Connecting, Searching, Popular actions, Best practices); content is appropriately placed with only minor organization gaps (the proxy flag table and connection-state reference could live in a separate reference), matching the 4-anchor.

4 / 5

Total

16

/

20

Passed

Description

48%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 a specific named API and includes an explicit 'Use when' trigger, but its capability wording is generic and the trigger is tautological rather than naming concrete NLP tasks. It is distinguishable but underspecified.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete NLP actions such as 'Run sentiment analysis, text summarization, and entity/key-phrase recognition on documents.'

Expand the trigger to name user-facing tasks, e.g. 'Use when the user wants sentiment analysis, summarization, entity recognition, or syntax analysis of text via the Codeq NLP API.'

Keep the API name as the distinctiveness anchor but pair it with the specific NLP features so the skill triggers on real user intent.

DimensionReasoningScore

Specificity

The description names the domain ('Codeq Natural Language Processing API integration') but its actions are generic — 'Manage data, records, and automate workflows' describes no concrete NLP capability, matching the 'Names the domain but actions are minimal or generic' anchor rather than the 3-anchor which requires 1-2 concrete actions.

2 / 5

Completeness

Both a 'what' and a 'Use when...' clause are present, but the 'what' is vague ('manage data, records, automate workflows') and the 'when' is tautological ('when the user wants to interact with Codeq Natural Language Processing API data'), leaving it below the 4-anchor's 'both what and when with reasonable specificity'.

3 / 5

Trigger Term Quality

It surfaces the API name and 'data', 'records', 'workflows' but omits the natural task terms users would actually say (sentiment analysis, text summarization, entity recognition), fitting 'Some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

The named 'Codeq Natural Language Processing API' gives it a clear niche with minimal conflict risk, though the generic 'manage data, records, automate workflows' phrasing leaves minor overlap risk with other integration skills, matching the 'Mostly distinct; minor overlap risk' anchor.

4 / 5

Total

12

/

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.

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