surrealdb-expert

Expert SurrealDB developer specializing in multi-model database design, graph relations, document storage, SurrealQL queries, row-level security, and real-time subscriptions. Use when building SurrealDB applications, designing graph schemas, implementing secure data access patterns, or optimizing query performance.

Quality

77%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/surrealdb-expert/SKILL.md

Quality

Content

55%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides highly actionable, executable guidance for SurrealDB development with strong security focus and clear TDD workflow. However, it is severely bloated with redundant content repeated across multiple sections and explains many concepts Claude already knows. The lack of progressive disclosure makes it a monolithic document that would benefit greatly from splitting into focused reference files.

Suggestions

Extract the OWASP mapping table, vulnerability details, and security patterns into a separate SECURITY.md reference file

Remove redundant examples - parameterized queries and password hashing are shown 4+ times; consolidate into single authoritative examples

Delete explanatory text Claude already knows (e.g., 'PDF files are...', what connection pooling does, basic async patterns)

Move the full test suite examples to a separate TESTING.md file, keeping only 1-2 representative tests inline

Dimension	Reasoning	Score
Conciseness	Extremely verbose at ~800+ lines with significant redundancy. Patterns are repeated multiple times (e.g., parameterized queries shown in sections 3, 4, 5, 8, and 13). Explains concepts Claude already knows like what connection pooling is, basic Python async patterns, and OWASP categories.	1 / 3
Actionability	Provides fully executable code examples throughout - Python tests, SurrealQL queries, JavaScript SDK usage, and bash commands are all copy-paste ready. Concrete examples with specific syntax for every pattern.	3 / 3
Workflow Clarity	Clear TDD workflow with explicit steps (write failing test → implement → refactor → verify). Pre-implementation checklist with phases provides validation checkpoints. Testing section includes specific pytest commands for verification.	3 / 3
Progressive Disclosure	Monolithic wall of text with no references to external files. All content is inline despite being 800+ lines. Content that should be in separate reference files (OWASP mapping table, full test suites, vulnerability details) is embedded directly.	1 / 3
	Total	8 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that clearly identifies the technology domain (SurrealDB), lists specific capabilities, and provides explicit trigger guidance. The description effectively uses third person voice and includes both technical terms (SurrealQL, row-level security) and natural user language (building applications, designing schemas). Minor improvement could include file extensions or alternative phrasings users might use.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: 'multi-model database design, graph relations, document storage, SurrealQL queries, row-level security, and real-time subscriptions' - these are distinct, actionable capabilities.	3 / 3
Completeness	Clearly answers both what (multi-model database design, graph relations, etc.) AND when with explicit 'Use when...' clause covering building applications, designing schemas, implementing security, and optimizing queries.	3 / 3
Trigger Term Quality	Includes natural keywords users would say: 'SurrealDB', 'graph schemas', 'SurrealQL', 'row-level security', 'real-time subscriptions', 'query performance'. These cover both the technology name and common feature terms.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive due to specific technology focus (SurrealDB) and unique feature set (SurrealQL, multi-model). Unlikely to conflict with generic database skills due to explicit technology naming.	3 / 3
	Total	12 / 12 Passed

Validation

75%

Warnings & errors only

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

Validation — 12 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (1295 lines); consider splitting into references/ and linking	Warning
metadata_version	'metadata' field is not a dictionary	Warning
license_field	'license' field is missing	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	12 / 16 Passed

Repository: martinholovsky/claude-skills-generator
Commit: 1086ef2

Reviewed: 4 months ago

Table of Contents

Discovery Implementation Validation

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.