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.
76
77%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/surrealdb-expert/SKILL.mdQuality
Discovery
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 |
Implementation
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 |
Validation
75%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
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.