CtrlK
BlogDocsLog inGet started
Tessl Logo

planetscale

PlanetScale integration. Manage data, records, and automate workflows. Use when the user wants to interact with PlanetScale 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/planetscale/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.

The body is highly actionable with concrete CLI commands and a clear connection workflow, but it carries some explanatory padding, an empty 'Popular actions' section, and no verification guidance for destructive database operations. Conciseness and workflow validation are the main weaknesses.

Suggestions

Add a validation/verification checkpoint for destructive operations, e.g. confirm or dry-run before `membrane action run` and `membrane request` with DELETE/PUT/PATCH, and verify the `output` field afterward.

Remove concept-explanation padding (the opening PlanetScale definition and phrases like 'so you can focus on the integration logic') to tighten the token budget.

Populate the 'Popular actions' section with actual example actions (e.g. list databases, create branch, open deploy request) or remove the redundant header that only repeats the discovery command.

DimensionReasoningScore

Conciseness

The body is mostly efficient with copy-paste commands, but includes unnecessary explanation Claude already knows ('PlanetScale is a serverless MySQL database platform...') and filler like 'so you can focus on the integration logic rather than auth plumbing' and 'This is the fastest way to get a connection', fitting the 'mostly efficient but includes some unnecessary explanation' anchor; not a 4 because several padding sentences remain and not a 2 because the bulk is concrete commands.

3 / 5

Actionability

Provides concrete, executable membrane CLI commands with flags and a full proxy-options table, matching 'mostly executable guidance; concrete code or commands with minor gaps'; not a 5 because the 'Popular actions' section lists no actual actions (only repeats the discovery command) and placeholders like CONNECTION_ID are unresolved, not a 3 because the guidance is genuinely executable rather than pseudocode.

4 / 5

Workflow Clarity

The connection workflow is well sequenced with state checkpoints and a polling feedback loop (BUILDING -> READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR), but the skill governs database operations that can be destructive (the proxy table exposes DELETE) with no validation or verification step before/after running actions, triggering the destructive-operations cap at 3; not a 4 because of the missing verification for destructive action runs and not a 2 because the connection sequence and feedback loop are clearly present.

3 / 5

Progressive Disclosure

Content is organized into clear, well-labeled sections (Install, Authentication, Connecting, Searching, Running actions, Proxy requests, Best practices) with no bundle files and no nested references, fitting 'good structure; most content is appropriately placed; minor organization gaps'; not a 5 because the file is ~140 lines (above the simple-skill threshold) with some redundancy (the 'Popular actions' section) and not a 3 because structure and navigation are solid.

4 / 5

Total

14

/

20

Passed

Description

62%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 answers both what and when in third person and leverages a distinct product name, but its action verbs are generic and it lacks richer trigger-term coverage. Specificity and trigger phrasing are the main weaknesses.

Suggestions

Replace generic verbs with concrete PlanetScale actions, e.g. 'Manage databases, branches, and deploy requests' referencing the skill's actual capabilities.

Expand the 'Use when' clause with concrete trigger phrases such as 'when the user mentions PlanetScale, database branches, or deploy requests'.

Add natural synonyms like 'MySQL', 'database', or 'serverless database' to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Names the PlanetScale domain plus a few activities ('Manage data, records, and automate workflows'), but the verbs are generic rather than concrete actions, matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor; not a 2 because more than a single bare action is listed, not a 4 because no specific concrete operations are enumerated.

3 / 5

Completeness

Both 'what' ('PlanetScale integration. Manage data, records, and automate workflows.') and 'when' ('Use when the user wants to interact with PlanetScale data.') are explicitly present, matching the 'has both what and when; when could be more explicit' anchor; not a 5 because the 'when' clause lacks concrete trigger phrases, not a 3 because the 'when' is explicit rather than only implied.

4 / 5

Trigger Term Quality

The natural keyword 'PlanetScale' and 'data' appear in the trigger, but common variations or synonyms (e.g., 'MySQL', 'database', 'branch', 'deploy request') are missing, fitting the 'some relevant keywords but missing common variations' anchor; not a 4 because keyword coverage is thin and not a 2 because a real user-facing product name is present.

3 / 5

Distinctiveness Conflict Risk

PlanetScale is a specific named SaaS product giving a clear niche with distinct triggers and minimal conflict risk, but 'interact with PlanetScale data' could still overlap with generic MySQL/database skills, fitting the 'mostly distinct; minor overlap risk' anchor; not a 5 because the trigger scope is somewhat narrow and not a 3 because the named product makes it clearly distinguishable.

4 / 5

Total

14

/

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.