CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

surrealql

Generate and modify SurrealQL queries to interact with SurrealDB databases. This includes creating and retrieving records, designing and managing schemas, establishing and querying graph relationships, performing live (real-time) queries, and leveraging all unique SurrealQL features for advanced database workflows. Use this skill whenever users need to write, adapt, or troubleshoot SurrealQL statements.

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 well-structured overview skill with excellent progressive disclosure, executable validation/formatting commands, and a built-in validate-and-recover loop appropriate for database operations. Its main weaknesses are marketing-fluff padding, a redundant intro, and hardcoded version numbers that will become stale over time.

Suggestions

Remove the marketing sentence ('SurrealQL is... modern, flexible, and powerful... easy to learn and use') and the redundant restatement of the description in the intro; Claude gains nothing from them.

Replace hardcoded version numbers ('v3.1.4', '3.x', 'since SurrealDB v3.1.0') with the version-detection commands themselves, or move version-specific notes into a dedicated version/compatibility section so they age gracefully.

Add one or two inline SurrealQL examples for the most common cases (e.g. a basic SELECT with WHERE and a CREATE) so users get immediate syntax grounding without opening a reference file.

DimensionReasoningScore

Conciseness

Mostly efficient (compact statement tables, lean command examples), but includes unnecessary padding: the marketing sentence 'a modern, flexible, and powerful query language that is designed to be easy to learn and use', a redundant restatement of the description, and time-sensitive version numbers ('v3.1.4', '3.x', 'since SurrealDB v3.1.0') that will age and are not in a deprecated/old-patterns section.

3 / 5

Actionability

Provides fully executable, copy-paste-ready commands (`surreal validate query.surql`, `curl -s https://download.surrealdb.com`, `npx @surrealdb/surql-fmt --stdin`) with a worked example; the minor gap is that no actual SurrealQL query examples appear inline, being delegated entirely to the reference files.

4 / 5

Workflow Clarity

The generate→validate→format flow is well supported: 'always validate them using the SurrealDB CLI' with an error-recovery feedback loop ('Validation may fail to due version differences, at which point you can retrieve your SurrealDB CLI version with `surreal version`'), and explicit always-format situations. It falls short of a 5 because the workflow is implied across sections rather than presented as an explicit sequenced process.

4 / 5

Progressive Disclosure

Clear overview with a well-signaled References section ('For detailed querying patterns (filtering, graph traversal, aggregation, subqueries), see references/querying.md') pointing to three real, one-level-deep files (querying.md, schema.md, values.md — verified to exist with no nested references); statement tables serve as a navigable index, and content is appropriately split.

5 / 5

Total

16

/

20

Passed

Description

87%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 description that clearly states capabilities and an explicit 'Use when' trigger clause with natural keywords. The only weakness is the vague 'all unique SurrealQL features' over-claim at the end, which adds fluff without concrete information.

DimensionReasoningScore

Specificity

Lists multiple concrete actions ('creating and retrieving records', 'designing and managing schemas', 'establishing and querying graph relationships', 'performing live (real-time) queries'), but the closing phrase 'leveraging all unique SurrealQL features for advanced database workflows' is vague over-claim fluff that keeps it below the comprehensive anchor.

4 / 5

Completeness

Explicitly answers both what ('Generate and modify SurrealQL queries to interact with SurrealDB databases...') and when ('Use this skill whenever users need to write, adapt, or troubleshoot SurrealQL statements') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural keyword coverage with 'SurrealQL queries', 'SurrealDB databases', and 'write, adapt, or troubleshoot SurrealQL statements', plus domain topics like schemas and graph relationships; a few natural terms are missing (e.g. .surql files, converting from SQL/other query languages).

4 / 5

Distinctiveness Conflict Risk

SurrealQL/SurrealDB is a clear niche with distinct triggers; no other skill would plausibly compete for these queries, so conflict risk is minimal.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

boranfurkan/discordlancer

Path

.claude/skills/surrealql/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.