CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

relational-database-mcp-cloudbase

[Deprecated] Existing CloudBase MySQL only. Do not recommend MySQL for new relational work — use postgresql-development. Read this when the environment already has a MySQL instance and the task is queryMysqlDatabase, manageMysqlDatabase, queryPermissions, or managePermissions (inspect, write SQL, schema, permissions, destroy). Do not provision MySQL.

Quality

85%

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

The canonical home for this skill is relational-database-mcp-cloudbase in TencentCloudBase/CloudBase-AI-Toolkit

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 dense, safety-conscious operational guide with exact tool call shapes, a required _openid column snippet, and well-validated lifecycle scenarios including a carefully guarded destroy flow. Its main weaknesses are redundancy — the deprecation/provisioning boundary is repeated many times and the activation sections overlap — and missing example payloads for the mutating actions.

Suggestions

State the provisioning-retired boundary once in a prominent place and trim its repetitions from the gotchas list, the manageMysqlDatabase section, Scenario 1, and the Key principle section.

Merge the overlapping 'Activation Contract', 'When to use this skill', and 'How to use this skill' sections into a single activation section, since they restate the same triggers and tool-selection guidance.

Add copy-paste example payloads for manageMysqlDatabase(action="runStatement") and initializeSchema, and enumerate the accepted permission values for updateResourcePermission, to lift actionability to fully executable coverage.

DimensionReasoningScore

Conciseness

The content is operational rather than tutorialial, but the provisioning-retired boundary is restated roughly five times ("Trying to create a MySQL instance through MCP", "Provisioning is not available here", "MySQL provisioning is no longer available through MCP", "never create one", "Do not provision" context), and the "Activation Contract" section substantially duplicates "When to use this skill" / "How to use this skill". This is more than the 'minor instances' of anchor 4 — whole sections could be consolidated — but it is not the concept-explaining padding of anchor 2.

3 / 5

Actionability

Concrete, executable guidance throughout: a complete runQuery JSON payload ("SELECT id, email FROM users ORDER BY created_at DESC LIMIT 50"), exact call shapes ("queryPermissions(action=\"getResourcePermission\", resourceType=\"sqlDatabase\", resourceId=\"<tableName>\")"), "manageMysqlDatabase(action=\"destroyMySQL\", confirm=true)", and the copy-paste SQL snippet "_openid VARCHAR(64) DEFAULT '' NOT NULL". It falls short of anchor 5 because the most common mutating operations — runStatement and initializeSchema — lack example payloads, and permission options beyond "READONLY" are not enumerated.

4 / 5

Workflow Clarity

All five lifecycle scenarios give clear numbered sequences with explicit validation checkpoints: read-only inspection before writes ("Review the result set and confirm it matches expectations before any write operation"), pre-mutation checklists ("Before calling this tool, **confirm**:"), post-schema permission verification, and a destroy flow that polls task status and handles failure ("If the task fails, treat the returned error as the terminal result and let the caller decide whether to retry"). Destructive operations are well-guarded, so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so everything lives in one ~215-line file. Section headers are clear, and cross-skill references are well-signaled with their purpose ("Web application integration -> ../relational-database-web-cloudbase/SKILL.md"), one level deep. It misses anchor 5 because the ~80-line tool reference and five lifecycle scenarios are all inlined where a reference file split could keep the overview leaner.

4 / 5

Total

16

/

20

Passed

Description

92%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 well-crafted deprecated-skill description: it names the exact MCP tool triggers, enumerates concrete capabilities, states the precondition (existing MySQL instance), and explicitly redirects new relational work to the successor skill. The only weakness is thin synonym coverage beyond the literal tool names.

DimensionReasoningScore

Specificity

The description enumerates the full concrete action surface — "(inspect, write SQL, schema, permissions, destroy)" — alongside the four named MCP tools (queryMysqlDatabase, manageMysqlDatabase, queryPermissions, managePermissions), giving comprehensive coverage of the skill's capabilities. It exceeds anchor 4 because the parenthetical action list matches the body's complete tool set rather than leaving minor gaps.

5 / 5

Completeness

Both questions are answered explicitly: what it does ("inspect, write SQL, schema, permissions, destroy" on an existing CloudBase MySQL instance) and when to use it ("Read this when the environment already has a MySQL instance and the task is queryMysqlDatabase, manageMysqlDatabase, queryPermissions, or managePermissions"). The 'when' clause is not merely present but highly explicit with concrete tool-name triggers and a precondition, matching the anchor-5 example structure; it also adds a negative boundary ("Do not recommend MySQL for new relational work — use postgresql-development").

5 / 5

Trigger Term Quality

Strong keyword coverage: exact tool names ("queryMysqlDatabase", "managePermissions") plus natural operation terms like "MySQL instance", "write SQL", "schema", "permissions", "destroy", "provision". It falls short of anchor 5 because common user synonyms such as "database", "DB", or "relational database" are not offered as trigger phrases ("relational" appears only in the redirect to postgresql-development).

4 / 5

Distinctiveness Conflict Risk

"[Deprecated] Existing CloudBase MySQL only" plus the explicit redirect ("use postgresql-development") carves out a clear niche with minimal conflict risk — the description actively steers away from the nearest competing skill. It would not trigger for generic SQL, PostgreSQL, or SDK application work.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

TencentCloudBase/CloudBase-AI-Toolkit

Path

plugin/cloudbase/skills/relational-database-mcp-cloudbase/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.