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.

55

Quality

69%

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

Quality

Content

56%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 well-structured with clear sequencing, explicit failure recovery, and strong safety guardrails for destructive operations, but it is undermined by cross-section redundancy and heavy reliance on reference files that are absent from the bundle. Deduplicating repeated rules and consolidating the dual workflow models would tighten it considerably.

Suggestions

Deduplicate repeated rules: state the vector-DB-as-retrieval-infrastructure and anti-pattern §5 application-ownership rules once (Guardrails) and reference them elsewhere.

Consolidate the Scenes/Structural Flow and Default Workflow sections into a single workflow so the agent follows one path.

Ensure the referenced bundle files (`resources/execution-protocol.md`, `resources/checklist.md`, `resources/anti-patterns.md`, etc.) ship with the skill, or inline the minimal steps they carry.

DimensionReasoningScore

Conciseness

The body is mostly prescriptive and does not explain concepts Claude already knows, but it is noticeably redundant: the vector-DB-as-retrieval-infrastructure rule appears three times (Control-flow features, Transitions, Guardrail 12), anti-patterns §5 application ownership is restated in three places, and "When to use"/"Intent signature" largely duplicate each other and the description. This fits "mostly efficient but could be tightened" rather than the padded verbosity of a 2.

3 / 5

Actionability

Concrete decision rules exist (enforce 3NF, expand-contract with dual-write and verified read switch, hybrid retrieval default, named Serena tools `find_file`/`search_for_pattern`, pointer to `resources/anti-patterns.md` §5), but the actual executable steps are deferred to `resources/execution-protocol.md`, `resources/checklist.md`, and other files not present in the bundle, so key execution details are missing — matching "some concrete guidance but incomplete".

3 / 5

Workflow Clarity

The Structural Flow (Entry → PREPARE/ACQUIRE/REASON/ACT/VERIFY/FINALIZE → Transitions → Failure and recovery → Exit) gives a clear sequence with explicit verification and failure-handling steps, and destructive live-table changes get validation safeguards (verified read switch, soak window before contract). It stops short of a 5 because two parallel workflow framings (Scenes vs. Default Workflow) coexist without reconciliation and checkpoints are procedural rather than command-level.

4 / 5

Progressive Disclosure

The References section is well-labeled and one level deep, but the bundle contains none of the ten-plus referenced files (`resources/*.md`, `../_shared/core/*`, `../oma-observability/SKILL.md`) — scored against the actual bundle structure, every referenced path is dangling and navigation is unverifiable. Inline content such as the 18-item Guardrails list also belongs in reference files, matching "some structure but could be better organized" rather than the minor-gaps profile of a 4.

3 / 5

Total

13

/

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.

A specific, third-person description with good trigger terms and an explicit routing boundary, but it lacks any "Use when..." trigger clause, capping completeness. Adding explicit trigger conditions (and synonyms like SQL, ERD, RAG, indexing) would raise both completeness and trigger coverage.

Suggestions

Add a "Use when" clause with concrete triggers, e.g. "Use when the user mentions databases, schemas, ERDs, SQL, migrations, query tuning, indexes, RAG, or vector search."

Include common synonyms users say naturally — SQL, ERD, RAG, indexing, backup/capacity planning — to broaden trigger coverage.

State the negative boundary for other adjacent skills (infra provisioning, QA audit) the body already mentions, to further reduce conflict risk.

DimensionReasoningScore

Specificity

The description names several concrete actions — "Design schemas and migrations", "tune queries", "plan vector retrieval and database operations" — which is more than the 1-2 actions of a score-3 anchor, but "database operations" is generic and coverage of the skill's full scope (anti-pattern review, capacity, backup) is missing, so it does not reach comprehensive.

4 / 5

Completeness

The "what" is clear (design schemas/migrations, tune queries, plan vector retrieval), but there is no "Use when..." clause or equivalent explicit trigger guidance; the boundary sentence "Application API implementation uses oma-backend" is a negative routing cue, not a when-to-use statement, so completeness is capped at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Natural trigger terms are present: "schemas", "migrations", "tune queries", "vector retrieval", "database". Common synonyms a user would actually say — "SQL", "ERD", "RAG", "indexing", "backup" — are absent, which keeps it below comprehensive coverage (5) but clearly above partial coverage (3).

4 / 5

Distinctiveness Conflict Risk

The database niche (schemas, migrations, query tuning, vector retrieval) is distinct and the explicit boundary "Application API implementation uses oma-backend" reduces overlap risk with a backend skill. It is not a 5 because "database operations" is broad and only one adjacent-skill boundary is stated.

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

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.