CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

oma-backend

Implement server APIs, authentication, and application data access. Schema modeling and query tuning use oma-db.

Quality

63%

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-backend/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 presents a genuinely well-structured agentic workflow — explicit phases, transitions, failure recovery, exit criteria, and strong stack-specific guardrails — but it is dragged down by concept re-teaching (DRY/SOLID/KISS), the absence of any executable code or example command, and four primary references to a nonexistent resources/ directory that break navigation for the skill's own verification step. It sits solidly at the midpoint of the rubric. Fixing the reference paths and trimming the concept explanations would move it to good.

Suggestions

Resolve or relocate the resources/ references (execution-protocol.md, checklist.md, orm-reference.md, error-playbook.md) — either ship them in the bundle or point to their real location, since the VERIFY phase instructs the agent to follow them.

Delete the explanatory text for DRY/SOLID/KISS and keep only the directives (e.g. 'Business logic in Service, data access in Repository; one responsibility per class; use the framework's DI'), and state the router→service→repository pattern once instead of three times.

Add one small concrete anchor — an example stack/stack.yaml verify block or a minimal router→service→repository snippet — so the verification and architecture guidance has an executable reference point.

DimensionReasoningScore

Conciseness

Most of the body is imperative, project-specific direction that earns its tokens, but there is real padding: the Guardrails section explains concepts Claude already knows ('DRY (Don't Repeat Yourself)', 'SOLID... Single Responsibility: Classes and functions should have one responsibility', 'KISS: Keep it simple and clear'), and the router→service→repository architecture is stated three times (Structural Flow, the Architecture Pattern diagram, and Core Rule 1). This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') — the padding is localized sections, not the extensive concept-teaching of anchor 2.

3 / 5

Actionability

There is concrete, specific guidance — "JWT + Argon2id for auth", "Parameterized queries only (never string interpolation)", named code-intelligence tools (`find_file`, `search_for_pattern`, `get_symbols_overview`, `find_symbol`), and precise layer boundaries — but no executable code or example commands anywhere, and verification is generic ('run the project's discovered verification commands, usually lint/typecheck/tests'). The stack-agnostic stance is justified by the stack/ template mechanism, yet key details like an example verify invocation or one skeleton router/service/repository snippet are missing, matching anchor 3 ('some concrete guidance but incomplete') better than anchor 4's 'concrete code or commands'.

3 / 5

Workflow Clarity

The workflow is clearly sequenced (Entry steps, PREPARE→ACQUIRE→ACT→VERIFY→FINALIZE scenes, Transitions, Exit criteria) with explicit validation (VERIFY step plus 'Checklist (run before handoff): resources/checklist.md') and a feedback loop ('If verification fails, fix root cause before handoff'). It falls short of anchor 5 because checkpoints name command categories rather than anything executable — actual commands are deferred to project discovery or stack/stack.yaml — a minor but real validation gap that anchor 4 ('clear sequence with most checkpoints present') captures exactly.

4 / 5

Progressive Disclosure

Sections are well organized and the References list clearly signals each file's purpose, but scored against the actual bundle: four of the primary references (resources/execution-protocol.md, resources/checklist.md, resources/orm-reference.md, resources/error-playbook.md) point to a directory that does not exist in the bundle — the workflow's VERIFY step depends on a file a reader cannot resolve. Combined with inline content that could live in references (13 core rules plus stack-manifest details), this fits anchor 3 ('references present but' effectively broken for navigation) rather than anchor 4, whose 'references mostly clear' presumes they resolve.

3 / 5

Total

13

/

20

Passed

Description

53%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 states a clear, third-person 'what' with domain-specific actions and a genuinely useful disambiguation pointer to oma-db, but it entirely lacks a 'when to use' trigger clause and omits the skill's own natural vocabulary (REST, endpoint, migration, background job, backend). Completeness and trigger quality are capped accordingly. It is serviceable but well below the good-example standard, which pairs capabilities with explicit 'Use when...' triggers.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for API, endpoint, REST/GraphQL, auth, migration, repository, or background job work' — this lifts completeness from 3 and imports the natural terms already listed in the body's intent signature.

Include the skill's other headline capabilities (migrations, background jobs, server-side business logic) so coverage gaps in specificity shrink from structural to minor.

Use the word 'backend' itself in the description; it is the most natural user term for this skill and currently appears only in the body.

DimensionReasoningScore

Specificity

The description names the backend domain and three concrete actions — "Implement server APIs, authentication, and application data access" — but coverage has more than minor gaps: migrations, background jobs, and server-side business logic, all central to the skill body, are absent. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) better than anchor 4, whose 'minor gaps' standard these omissions exceed.

3 / 5

Completeness

The 'what' is clear ("Implement server APIs, authentication, and application data access") but there is no 'Use when...' clause or equivalent explicit trigger guidance; "Schema modeling and query tuning use oma-db" is a routing pointer to a sibling skill, not a when-to-use trigger. Per the judging guideline, a missing 'Use when' clause caps completeness at 3, and anchor 3 ('clear what, when missing') is the exact fit.

3 / 5

Trigger Term Quality

It includes some natural keywords users would say ("server APIs", "authentication", "query tuning") but misses common variations and synonyms: REST, GraphQL, endpoint, migration, backend, database. This fits anchor 3 ('some relevant keywords but missing common variations') rather than anchor 4's 'good keyword coverage with a few natural terms missing', since the misses are the skill's own headline terms from its intent signature.

3 / 5

Distinctiveness Conflict Risk

The scope (server APIs, auth, data access) is mostly distinct from sibling skills, and the explicit "Schema modeling and query tuning use oma-db" pointer actively disambiguates the closest overlap (the database skill). It is not anchor 5 because without trigger phrases, generic asks like 'add an endpoint' or 'fix the database call' could still route ambiguously against full-stack or db skills.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 5 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

first-fluke/oh-my-agent

Path

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