CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

appdrag

AppDrag integration. Manage Organizations. Use when the user wants to interact with AppDrag data.

Quality

66%

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

Quality

Content

61%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.

A solid, executable guide for driving AppDrag through the Membrane CLI, with copy-paste commands covering the full lifecycle from install to running actions and proxy fallback. Its main weaknesses are the cap-inducing lack of validation for destructive actions and a broken step-numbering reference, plus token waste from an empty table column and padded prose.

Suggestions

Add validation guidance for destructive and batch operations (e.g., confirm target file/directory or preview raw SQL before running delete-* or execute-raw-sql-query actions) — this also lifts the workflow_clarity cap.

Fix the broken workflow numbering: either label 'Step 1'/'Step 2' sections explicitly or rewrite 'skip to **Step 2**' to point at the real section ('Searching for actions'), and unify the CLI invocation ('membrane' vs 'npx @membranehq/cli').

Drop the empty Description column from the Popular actions table (or actually populate it) and trim editorial sentences like 'This is the fastest way to get a connection' to tighten token efficiency.

DimensionReasoningScore

Conciseness

The body is mostly efficient with concrete commands, but the Popular actions table carries a completely empty Description column across 14 rows (pure token waste, including a near-duplicate 'Execute Raw SQL Query'/'Execute SQL Query' pair), and prose like 'This is the fastest way to get a connection' and 'This will burn less tokens and make communication more secure' could be trimmed. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than anchor 4, whose only flaws are minor.

3 / 5

Actionability

Concrete, copy-paste-ready CLI commands appear throughout: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://appdrag.com" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input \'{"key": "value"}\' --json', plus a flags table for proxy requests. Minor gaps keep it below anchor 5: the polling example inconsistently uses 'npx @membranehq/cli' instead of 'membrane', and real action IDs are never shown in a run example (only table keys).

4 / 5

Workflow Clarity

A real sequence exists (install → login → connection ensure → poll for READY → search actions → run → proxy fallback) with a poll-again feedback loop after CLIENT_ACTION_REQUIRED, but 'If the returned connection has state READY, skip to **Step 2**' references steps that are never labeled (only '#### 1b.' exists, no Step 1 or Step 2 headings). More importantly, the action catalog includes destructive and batch operations (Delete File, Delete Directory, Execute Raw SQL Query) with no validation/verification guidance, which per the rubric caps workflow clarity at 3.

3 / 5

Progressive Disclosure

No bundle files exist, so the single file is scored on structure: clear, well-ordered sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) with headers that make navigation easy. It stays at anchor 4 rather than 5 because detailed material that could live in reference files is fully inlined — the nested object-model tree, the clientAction state-machine breakdown, and the 14-row action catalog.

4 / 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 names the AppDrag domain and includes an explicit 'Use when' clause, but its capability statement is thin and misaligned with the body's actual scope (websites, pages, databases, newsletter and eCommerce actions rather than 'Organizations'). Trigger coverage rests on the single term 'AppDrag' plus generic 'data'.

Suggestions

Replace or expand 'Manage Organizations' with the capabilities the body actually covers, e.g. 'Manage AppDrag websites, pages, files, databases, and newsletter contacts, and run raw SQL queries'.

Add natural trigger terms users would say — 'AppDrag website', 'AppDrag database', 'newsletter list', 'eCommerce products' — to improve trigger term quality.

Make the 'Use when' clause concrete: 'Use when the user mentions AppDrag, their AppDrag site, or wants to manage AppDrag data' instead of the generic 'interact with AppDrag data'.

DimensionReasoningScore

Specificity

It names the domain ('AppDrag integration') but the only named action is the generic 'Manage Organizations' — matching anchor 2, 'Names the domain but actions are minimal or generic.' It falls below anchor 3 because one vague action is not '1-2 concrete actions' like 'extracts content', and above anchor 1 because a domain and an action are at least named.

2 / 5

Completeness

It has both a 'what' ('AppDrag integration. Manage Organizations.') and an explicit 'when' ('Use when the user wants to interact with AppDrag data'), and both could be more explicit or specific — precisely anchor 4. It is above anchor 3 because the 'Use when...' clause is explicit rather than missing or weakly implied, but below anchor 5 because neither the what nor the trigger phrases are concrete.

4 / 5

Trigger Term Quality

'AppDrag' is exactly the natural term a user would say and anchors the trigger, but the description misses the common variations and synonyms the body itself covers — website, page, database, newsletter, eCommerce, blog — matching anchor 3, 'Some relevant keywords but missing common variations or synonyms.' Not anchor 4, since keyword coverage is a single term plus the vague 'AppDrag data'.

3 / 5

Distinctiveness Conflict Risk

AppDrag is a specific named platform, giving the skill a clear niche with minimal conflict risk, matching anchor 4 ('Mostly distinct; minor overlap risk'). It falls short of anchor 5 only because the unqualified 'Manage Organizations' phrase could overlap with generic organization-management skills.

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