CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clerk

Clerk integration. Manage Users, Organizations. Use when the user wants to interact with Clerk data.

Quality

68%

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

Quality

Content

57%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, executable Membrane CLI guidance with a genuinely well-sequenced connection workflow, but it is padded with a useless 'No description' action table and concept explanations Claude already has, and it offers no safety guidance for the destructive actions it advertises. Splitting the action catalog and proxy reference into files would materially cut tokens.

Suggestions

Populate the Popular actions table with real descriptions or move the full action catalog to a references/ file, keeping only the top actions inline in SKILL.md.

Add validation guidance for destructive operations: verify the target first (e.g., run get-user) and confirm with the user before executing delete-user or delete-organization.

Cut known-concept padding (the 'what is Clerk' intro paragraph and 'Use action names and parameters as needed') and fix broken internal references — 'skip to Step 2' points at no section, and '1b' has no matching '1a'.

DimensionReasoningScore

Conciseness

The bulk is efficient, copy-paste CLI commands, but there are several padded spots: the opening explains what Clerk is ('a user management and authentication platform...'), 'Use action names and parameters as needed' is pure filler, and the 20-row Popular actions table populated entirely with 'No description' adds bulk without information. This fits 'mostly efficient but includes some unnecessary explanation' rather than the noticeably-verbose anchor below.

3 / 5

Actionability

Commands are concrete and executable throughout (install, login, connection ensure, action list/run with --input, the proxy flags table). It is not a 5 because the run examples use '<actionId>' while the Popular actions table only lists keys, leaving the id-to-key mapping unstated, and no worked example with real parameters (e.g., a paginated list-users) is given.

4 / 5

Workflow Clarity

The connection workflow is well sequenced with state checkpoints (poll with --wait, branch on CLIENT_ACTION_REQUIRED, inspect the error field), but it references a 'Step 2' section that does not exist, the '1b' heading has no '1a', and destructive actions (delete-user, delete-organization) are listed with no verification or confirmation guidance — the destructive-operations cap applies, holding this at 3 despite the good connection sequencing.

3 / 5

Progressive Disclosure

A single-file skill (~160 lines) with reasonable section headers but no bundle files at all; the 20-row action catalog and the proxy flag reference are inline content that clearly belongs in separate reference files. This matches 'some structure but content that should be separate is inline' rather than the good-structure anchor, since the doc exceeds the under-50-line simple-skill exception.

3 / 5

Total

13

/

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.

A distinct, correctly scoped description that answers both what and when, anchored by the strong 'Clerk' brand trigger. Its weaknesses are thin capability coverage and a generic when-clause that omits the natural vocabulary (authentication, sign-in, sessions, invitations) users would actually say.

Suggestions

Expand the what with concrete capabilities: e.g., 'Manage users, organizations, sessions, and invitations — create, update, delete, and list records.'

Make the when-clause concrete with natural trigger phrases: e.g., 'Use when the user mentions Clerk, authentication, sign-ups, or managing users, organizations, or sessions.'

DimensionReasoningScore

Specificity

Names the domain ('Clerk integration') and one to two concrete actions ('Manage Users, Organizations'), matching the anchor for a domain plus 1-2 actions. It is not a 4 because coverage is thin — sessions, invitations, and authentication are unmentioned — and not a 2 because more than the bare domain is stated.

3 / 5

Completeness

Both parts are explicit: the what ('Clerk integration. Manage Users, Organizations.') and the when ('Use when the user wants to interact with Clerk data'). It falls short of 5 because the when-clause is generic and circular ('interact with Clerk data') rather than concrete trigger phrases, but the explicit 'Use when' rules out 3.

4 / 5

Trigger Term Quality

'Clerk', 'Users', and 'Organizations' are relevant keywords, but common natural phrases users would say — authentication, sign-in, user management, sessions — are missing. This matches the 'some relevant keywords but missing common variations' anchor rather than the good-coverage anchor above.

3 / 5

Distinctiveness Conflict Risk

'Clerk' is a specific named platform and the trigger is scoped to it ('interact with Clerk data'), giving a clear niche with distinct triggers and minimal conflict risk with other skills.

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