CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

api4ai

Api4ai integration. Manage Leads, Persons, Organizations, Deals, Projects, Pipelines and more. Use when the user wants to interact with Api4ai data.

Quality

76%

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/api4ai/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 operational guidance: a concrete Membrane CLI workflow with executable commands, polling/error-state feedback loops, and a proxy fallback for uncovered endpoints. Weaknesses are padding in the intro and the content-free Api4ai Overview section, dangling 'Step 2' cross-references, and a Popular actions table with an empty description column.

Suggestions

Delete the marketing-style intro paragraph and the 'Api4ai Overview' section (its bullets carry no information); keep the docs link and a one-line description of the two real capabilities (image and video analysis).

Fix the broken navigation: define explicit Step 1/Step 2 headings so 'skip to **Step 2**' resolves, and renumber or remove the orphaned '#### 1b.' heading.

Complete the Popular actions table (fill the Description column, add example inputs like the image URL/base64 parameters) and add one worked end-to-end example of `membrane action run` with a real action id and input payload.

DimensionReasoningScore

Conciseness

The body is mostly command-first and efficient, but the opening marketing paragraph ("Developers and businesses use it to quickly integrate AI capabilities... It's useful for adding AI features...") and the nearly empty "Api4ai Overview" section ("- **Image** / - **Analysis Results**" bullets plus "Use action names and parameters as needed.") add tokens without actionable value. Fits 'mostly efficient but includes some unnecessary explanation' rather than 4, where over-explanation would be only minor trimmings.

3 / 5

Actionability

Concrete, copy-paste-ready bash commands cover the full path (install, login, connection ensure/get with --wait, action list/run with --input JSON, request with a flags table). Not 5 because the Popular actions table has an empty Description column and there is no worked end-to-end example showing a real action run with actual input parameters.

4 / 5

Workflow Clarity

The sequence install → authenticate → connect → poll state → handle CLIENT_ACTION_REQUIRED → search actions → run/proxy is clear, with genuine validation checkpoints (poll until not BUILDING, inspect error field on CONFIGURATION_ERROR/SETUP_FAILED, re-poll after user action). Not 5 because "skip to **Step 2**" is referenced twice but no Step 2 heading exists, and the "#### 1b." heading implies an unlabeled 1a/Step 1 — incoherent cross-references that leave minor gaps.

4 / 5

Progressive Disclosure

No bundle files exist, so everything is inline in one well-sectioned ~140-line file with clear headers and no nested references. That fits 'good structure; most content is appropriately placed; minor organization gaps' — the file is modest in size and appropriately split into sections, though the proxy flag table and connection-state details could eventually live in references as the skill grows.

4 / 5

Total

15

/

20

Passed

Description

75%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 follows the good pattern: a concrete 'what' list plus an explicit 'Use when...' clause, mostly in third-person imperative style. Its main weakness is that the 'when' clause merely restates the product name and the capability list reads like generic CRM vocabulary rather than terms tied to this product's actual capabilities.

Suggestions

Align the 'what' list with the skill's actual capabilities as documented in the body (image/video analysis, object detection) — 'Manage Leads, Persons, Organizations, Deals, Projects, Pipelines' does not match what the skill does, creating trigger conflicts with CRM skills.

Make the 'when' clause concrete instead of circular: e.g. 'Use when the user wants to analyze images or videos, detect objects in images, or work with the Api4ai API.'

Add natural trigger synonyms users would say (e.g. 'image recognition', 'object detection', 'tag images') so the skill surfaces for capability-based requests, not just brand-name mentions.

DimensionReasoningScore

Specificity

"Manage Leads, Persons, Organizations, Deals, Projects, Pipelines and more" enumerates several concrete entities, matching the anchor listing several specific items with minor gaps. It falls short of 5 because the only verb is the generic "Manage" and "and more" is padding, and above 3 because coverage of named objects is broad rather than 1-2 items.

4 / 5

Completeness

Both parts are present: what ("Manage Leads, Persons, Organizations, Deals, Projects, Pipelines") and when ("Use when the user wants to interact with Api4ai data"). Not 5 because the 'when' clause is circular — it restates the brand name rather than giving concrete trigger phrases — while anchor 3 is excluded since a 'when' clause is explicitly present.

4 / 5

Trigger Term Quality

Natural nouns like "Leads", "Deals", "Projects", "Pipelines" plus the brand term "Api4ai" give good keyword coverage users would plausibly say. Not 5 because common synonyms and variations (e.g. "image recognition", "object detection", file types) are absent.

4 / 5

Distinctiveness Conflict Risk

The brand name "Api4ai" establishes a clear niche, but the generic CRM vocabulary ("Leads", "Deals", "Pipelines", "Organizations") creates minor overlap risk with CRM-style skills. Fits 'mostly distinct; minor overlap risk' better than 3, since the brand anchor keeps the trigger tied to one product.

4 / 5

Total

16

/

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