CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aidaform

Aidaform integration. Manage data, records, and automate workflows. Use when the user wants to interact with Aidaform 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/aidaform/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 is a well-structured, actionable CLI guide: concrete commands for authentication, connection setup, action discovery and execution, plus a proxy escape hatch with a complete options table. Its main weaknesses are modest padding (audience background, a filler line, a duplicated section) and the absence of error-recovery guidance, which respectively hold conciseness and workflow clarity at 3-4 rather than 5.

Suggestions

Delete the filler line 'When to use which actions: Use action names and parameters as needed' and the audience sentence about marketers/researchers/small businesses — neither changes what Claude does, tightening conciseness toward anchor 4-5.

Merge the '## Popular actions' section into 'Searching for actions' (it currently just repeats the same `action list` command), and optionally list 2-3 real action IDs from `action list` output so users can skip discovery for common cases.

Add one or two error-recovery notes (e.g., what to do if the connector search returns no items or if an action run fails with an auth error) to move workflow clarity from a clear sequence toward explicit validation checkpoints.

DimensionReasoningScore

Conciseness

The body is mostly lean command-focused content, but it contains several unnecessary or padded spots: the 'used by marketers, researchers, and small businesses' audience sentence, the contentless line 'When to use which actions: Use action names and parameters as needed,' and the '## Popular actions' section that only repeats the action-list command already shown. That is more than the 'minor instances' of anchor 4, fitting anchor 3's 'could be tightened'.

3 / 5

Actionability

Guidance is mostly executable: copy-paste CLI commands for login (including the headless `login complete <code>` fallback), connector discovery with the exact JSON path `output.items[0].element?.id`, `action run` with a concrete `--input` JSON example, and a full proxy flags table. Minor gaps keep it below 5: the proxy section lacks a concrete example request, and 'Popular actions' lists no actual action IDs.

4 / 5

Workflow Clarity

A clear logical sequence runs setup → connect → discover actions → run, with helpful conditional branches (the headless-environment fallback and the 'when you are not sure if connection already exists' check). It falls short of anchor 5 because there are no explicit validation or error-recovery checkpoints (e.g., what to do when the connector search returns nothing or an action run fails), though nothing here is destructive or batch-oriented enough to trigger the cap.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), so there are no dangling or buried references, and the single-file structure is appropriate for a compact CLI guide of this length. Sections are clearly headed and easy to navigate; minor organization gaps (the redundant 'Popular actions' section and the thin 'Aidaform Overview' list) keep it at anchor 4 rather than 5.

4 / 5

Total

15

/

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 Aidaform niche and includes an explicit 'Use when' trigger, but its capability statement is generic filler ('Manage data, records, and automate workflows') that names no concrete actions, and its trigger vocabulary is limited to the brand name with no mention of forms, surveys, or submissions. It answers what and when at a structural level while remaining vague on both specifics.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete capabilities drawn from the skill itself, e.g., 'List and manage Aidaform forms, retrieve form submissions, and manage contacts' — this lifts specificity from anchor 2 toward 4-5.

Expand the trigger clause with natural phrases users would actually say: 'Use when the user mentions Aidaform, form submissions, survey responses, or wants to connect to their Aidaform forms' — this adds synonyms beyond the bare brand name.

State the integration mechanism briefly (e.g., 'via the Membrane CLI') so the description is distinguishable from other Aidaform-related skills and sets expectations for the setup flow.

DimensionReasoningScore

Specificity

The description names the domain ('Aidaform integration') but its actions — 'Manage data, records, and automate workflows' — are generic and abstract, closely resembling the bad example 'Processes data'. No concrete capabilities (e.g., form submissions, contacts, surveys) are stated, so it does not reach anchor 3, which requires 1-2 concrete actions.

2 / 5

Completeness

Both parts are explicitly stated: a 'what' ('Manage data, records, and automate workflows') and a 'when' ('Use when the user wants to interact with Aidaform data'). The trigger clause is present, so the missing-'Use when' cap at 3 does not apply, but the 'when' is circular ('interact with Aidaform data') and could be more explicit or specific — exactly anchor 4's characterization.

4 / 5

Trigger Term Quality

'Aidaform' is a relevant, natural keyword users would say, but coverage stops at the brand name; common variations and synonyms a user might actually say — forms, surveys, quizzes, submissions, responses, form builder — are entirely absent from the description even though the body establishes Aidaform as a form builder.

3 / 5

Distinctiveness Conflict Risk

'Aidaform' is a clear niche brand trigger with minimal wrong-skill conflict, but the surrounding phrasing 'Manage data, records, and automate workflows' is generic and overlaps with many data/CRM/automation integration skills if the user does not name the product. Mostly distinct with minor overlap risk among closely related integration skills — anchor 4.

4 / 5

Total

13

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

membranedev/application-skills

Path

skills/aidaform/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.