CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

oma-db

Design schemas and migrations, tune queries, or plan vector retrieval and database operations. Application API implementation uses oma-backend.

56

Quality

70%

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 ./.agents/skills/oma-db/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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, domain-aware skill body with genuine validation discipline for risky database operations and clearly signaled one-level-deep references. Its weaknesses are verbosity from duplicated workflow/rule statements and abstract deliverable descriptions that defer all concrete how-to to resource files whose presence cannot be confirmed in this bundle.

Suggestions

Consolidate the three overlapping workflow schemes (Scenes, Structural Flow, Default Workflow) into a single canonical sequence to remove repetition and free tokens.

Deduplicate the vector-DB ownership rule and the anti-pattern §5 "existing usage" sentence, which each appear twice; state once and reference resources/anti-patterns.md §5.

Add one or two inline concrete artifacts (e.g. a sample expand-contract migration sequence or a minimal deliverable template snippet) so the guidance is executable without relying solely on unverified resource files.

DimensionReasoningScore

Conciseness

The body does not teach concepts Claude already knows, but it is noticeably redundant: three overlapping workflow schemes (Scenes, Structural Flow, Default Workflow), the vector-DB-as-retrieval-infrastructure rule stated twice (Control-flow features and guardrail 12), and the anti-pattern §5 "existing usage" sentence repeated nearly verbatim in the workflow path and guardrail 18; the SSL-primitive table adds tokens without actionable value.

3 / 5

Actionability

Some guidance is concrete (expand-contract steps, "measure, explain, nominate the dominant cost node, then optimize and re-measure"), but most of the body describes deliverables abstractly ("Produce external/conceptual/internal schema documentation") with no inline commands, sample DDL, or example artifacts; all how-to detail is deferred to resources/ files.

3 / 5

Workflow Clarity

Sequencing is clear (Entry → PREPARE/ACQUIRE/REASON/ACT/VERIFY/FINALIZE → Exit, plus Explore/Design/Optimize) and validation checkpoints exist for destructive operations (VERIFY scene, pre-handoff checklist, expand-contract with soak window and separate deploy, "should not execute risky migrations without explicit user intent and verification"), so the destructive-ops cap does not apply; the three overlapping workflow schemes leave minor gaps that keep it below 5.

4 / 5

Progressive Disclosure

A well-signaled References section lists one-level-deep pointers each labeled with its purpose ("Self-check (run before handoff)", "Live migration playbook", etc.) and the body appropriately stays at overview level per domain; however, the 18-guardrail policy block is heavy for the main file and none of the referenced resources/*.md or ../_shared files exist in the provided bundle, so navigation cannot be fully verified.

4 / 5

Total

14

/

20

Passed

Description

66%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.

The description names several concrete, domain-specific actions and actively disambiguates against a sibling backend skill, but it lacks any explicit trigger clause telling Claude when to reach for it. Adding a "Use when..." sentence with natural trigger terms would lift both completeness and trigger coverage.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user mentions schemas, ERDs, migrations, query tuning, indexes, vector databases, RAG retrieval, or database capacity/backup planning."

Add common synonyms users actually say (ERD, SQL, NoSQL, indexing, RAG) to improve trigger-term coverage.

Briefly surface one or two more covered capabilities (e.g. capacity estimation or anti-pattern review) to close specificity gaps without padding.

DimensionReasoningScore

Specificity

"Design schemas and migrations, tune queries, or plan vector retrieval and database operations" lists several concrete actions, but coverage has minor gaps (indexing, capacity, anti-pattern review are handled by the skill yet unmentioned).

4 / 5

Completeness

The "what" is clear (design, tune, plan database work), but there is no "Use when..." clause or equivalent explicit trigger guidance; the oma-backend sentence is a routing boundary, not a when-to-use trigger, which caps completeness at 3.

3 / 5

Trigger Term Quality

Natural keywords like "schemas", "migrations", "tune queries", "vector retrieval", and "database" are present and would be said by users, but common variations such as ERD, SQL, NoSQL, indexing, RAG, or "vector database" are missing.

4 / 5

Distinctiveness Conflict Risk

The database design/tuning niche is mostly distinct and the explicit "Application API implementation uses oma-backend" routing reduces overlap risk; the broad phrase "database operations" keeps minor overlap risk with backend/infra skills.

4 / 5

Total

15

/

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

first-fluke/oh-my-agent

Path

.agents/skills/oma-db/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.