CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cloudbase-document-database-web-sdk

Use CloudBase document database Web SDK only for confirmed NoSQL collection work. Query, create, update, and delete document data; if the task mentions PostgreSQL / CloudBase PG / app.rdb(), route to postgresql-development instead.

Quality

76%

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 ./config/.claude/skills/cloudbase-document-database-web-sdk/SKILL.md

The canonical home for this skill is cloudbase-document-database-web-sdk in TencentCloudBase/CloudBase-AI-Toolkit

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 credible, information-dense operator guide with genuinely non-obvious CloudBase specifics (write-result shapes, permission-rule caching, validated CUSTOM-rule patterns) and real error-recovery loops. Its weaknesses are duplication — the CMS rule pattern and result._id gotcha are each stated twice — and a progressive-disclosure layer whose referenced files are missing from the bundle, leaving update/delete coverage thin and long security-rule detail inlined in SKILL.md.

Suggestions

State the CMS role-rule pattern and the result._id return-shape rule once (in Working rules) and keep the Common mistakes entries as one-line pointers to remove the duplication.

Ship the referenced companion files (crud-operations.md, complex-queries.md, security-rules.md, etc.) in the bundle, or inline a minimal update/remove example so the routing table resolves and CRUD coverage is self-contained.

Move the extended security-rule propagation and CMS-pattern detail into security-rules.md and leave only the decision rules ('READONLY for owner-only, CUSTOM for admin/editor roles') in SKILL.md.

DimensionReasoningScore

Conciseness

The body is mostly operational and CloudBase-specific (result._id shape, rule-evaluator caching, CUSTOM rule syntax) rather than explaining known concepts, but it is noticeably duplicated: the CMS role-rule pattern and the result._id gotcha each appear in full in both "Common mistakes / gotchas" and "Working rules", and the generic try/catch "Error handling" example adds little Claude doesn't already know. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the lean 4–5 anchors.

3 / 5

Actionability

Guidance is largely executable: a canonical init block, working query/create/pagination/field-selection examples, exact security-rule expressions (``get(`database.user_roles.${auth.uid}`).role == 'admin' || doc.authorId == auth.uid``), and concrete verification steps (read result.code/result.message, get() round-trip on the written _id). It stops short of the 5 anchor because update/remove examples are absent and the companion files that would carry them (crud-operations.md etc.) are not in the bundle — minor gaps in covering the common cases.

4 / 5

Workflow Clarity

The "Minimal checklist" plus numbered "Working rules" give a clear starting sequence (confirm browser-side -> shared init -> verify auth -> read companion reference), and database-appropriate feedback loops are explicit: retry after the 2–5 minute permission-rule cache window, verify writes via result fields and a get() round-trip, and inspect the rule model on permission failures. It is not a 5 because the sequence is distributed across several sections rather than one coherent ordered workflow with checkpoints at each step.

4 / 5

Progressive Disclosure

The "Quick routing" section is well-signaled and one level deep (CRUD -> ./crud-operations.md, etc.), but none of the seven referenced companion files exist in this bundle — there is no references/ directory — and the sibling skill paths (../auth-web-cloudbase/SKILL.md, ../postgresql-development-cloudbase/references/pgdoc.md) are also absent. Additionally, material that belongs in security-rules.md (the full CMS pattern and propagation behavior) is inlined at length. The structure is good on paper but the disclosure chain cannot actually resolve in this environment, which fits 'some structure but could be better organized' better than the 4 anchor.

3 / 5

Total

14

/

20

Passed

Description

78%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 strong, disciplined description: it names the domain and four concrete CRUD actions, states an explicit use condition, and preemptively routes the most confusable case (CloudBase PG) to the sibling skill in third-person voice with no fluff. Its main gap is that the positive trigger surface is thinner than the negative one — natural SDK call names a user might mention (app.database(), db.collection(), watch()) are absent.

Suggestions

Add positive trigger phrases such as 'use when the request mentions app.database(), db.collection(), .where(), .watch(), or @cloudbase/js-sdk in a Web frontend' to lift completeness and trigger-term coverage.

Mention one or two of the skill's advanced capabilities (aggregation, realtime listeners, geolocation queries) so the description's capability list matches actual coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Query, create, update, and delete document data" — anchored to a named domain ("CloudBase document database Web SDK"). It falls short of the 5 anchor because capabilities the skill actually covers (pagination, aggregation, realtime watch, geolocation) are absent, leaving minor gaps in coverage.

4 / 5

Completeness

Both 'what' ("Query, create, update, and delete document data" via the Web SDK) and 'when' ("only for confirmed NoSQL collection work", plus an explicit negative trigger: "if the task mentions PostgreSQL / CloudBase PG / app.rdb(), route to postgresql-development instead") are present. Not a 5 because the positive 'when' lacks concrete positive trigger phrases — it states the constraint but never says 'use when the user mentions app.database(), collections, .where(), watch()' or similar.

4 / 5

Trigger Term Quality

Good keyword coverage: "CloudBase", "document database", "NoSQL", "collection", "PostgreSQL / CloudBase PG / app.rdb()" are terms a user would plausibly say when needing this skill or when needing to be routed away from it. A few natural positive triggers are missing (e.g., "db.collection()", "app.database()", "@cloudbase/js-sdk"), keeping it below the comprehensive-synonyms bar of a 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (CloudBase NoSQL document work in the browser via the Web SDK) with explicit conflict resolution — the PostgreSQL/CloudBase PG/app.rdb() routing instruction actively prevents the most likely wrong-skill trigger. Conflict risk with adjacent skills is minimal; the scoping to "Web SDK" and "NoSQL collection work" separates it from the Mini Program and PG variants.

5 / 5

Total

17

/

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

TencentCloudBase/CloudBase-AI-Toolkit

Path

config/.claude/skills/cloudbase-document-database-web-sdk/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.