CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

moai-domain-backend

Backend development specialist covering API design, database integration, microservices architecture, and modern backend patterns. Use when designing APIs, implementing server logic, authentication, or authorization.

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 ./.claude/skills/moai-domain-backend/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 a well-headed pattern catalog whose genuine strengths are the concrete parameter-level details, the rationalizations table, red flags, and verification checklist. It is dragged down by prose-only code descriptions with no executable examples, a redundant Quick Reference section duplicating the frontmatter, and a monolithic single-file layout with no progressive disclosure despite being ~180 lines.

Suggestions

Convert the prose pattern descriptions into small executable code blocks (e.g., show the FastAPI UserResponse model and endpoints as actual Python) so guidance is copy-paste ready rather than pseudocode in prose.

Move the per-technology pattern guides (PostgreSQL/SQLAlchemy, MongoDB/Motor, Consul, RabbitMQ, Redis) into separate reference files under references/ and link to them from SKILL.md, keeping the main file a lean overview.

Delete the redundant 'Quick Reference' section that restates the frontmatter, remove the duplicate 'moai-foundation-core' entry in 'Works Well With', and relocate version-specific numbers ('Python 3.13+', 'Node.js 20+') out of the main body.

DimensionReasoningScore

Conciseness

The body is mostly efficient prose but includes clear tightening opportunities: the 'Quick Reference' section (lines 30-48) restates the frontmatter description and when-to-use almost verbatim, the 'Works Well With' section lists 'moai-foundation-core' twice, and the Technology Stack bakes in time-sensitive version numbers ('Python 3.13+', 'Node.js 20+') outside any deprecated/old-patterns section. It is above 2 because it does not explain concepts Claude already knows (no 'what is REST' padding), but below 4 due to the duplicated and redundant sections.

3 / 5

Actionability

Every implementation pattern is rendered as prose instructions with zero code blocks — e.g. 'Define a Pydantic UserResponse model with id, email, and name fields... Implement list_users and create_user endpoints with HTTPBearer security dependency.' The details are concrete (specific class and method names, parameter values like pool_size 20, max_overflow 30, HS256, 15-minute expiry), which lifts it above 2, but nothing is executable or copy-paste ready, matching the pseudocode-instead-of-executable-code anchor at 3 rather than the 'concrete code or commands' anchor at 4.

3 / 5

Workflow Clarity

The body is a topic-organized pattern catalog (API design, database, microservices, caching, security, performance) rather than a sequenced workflow, and the pattern sections themselves contain no validation checkpoints. The final 'Verification' checklist partially compensates with concrete checkpoints ('grep for hardcoded secrets', 'show validation middleware'), placing this at 3: checkpoints exist but there is no sequence connecting them to the described patterns, so it does not reach the 'clear sequence with most checkpoints' anchor at 4.

3 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ are absent) and no references to any external files, so all ~183 lines live in a single SKILL.md. Section headers are clear, so it is above the minimal-structure anchor at 2, but content that naturally belongs in per-technology reference files (PostgreSQL, MongoDB, Redis, Consul, RabbitMQ patterns) is inlined, and at well over 50 lines the simple-skill exception for a 5 does not apply — matching the 'content that should be separate is inline' anchor at 3.

3 / 5

Total

12

/

20

Passed

Description

75%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 solid description that explicitly pairs a specific what with a use-when clause and uses natural trigger vocabulary in third-person voice. Its main weakness is coverage mismatch: the when-clause triggers (APIs, server logic, auth) only span part of the declared scope (databases, microservices, caching are untriggered).

Suggestions

Extend the when-clause to mirror the full what-clause, e.g. 'Use when designing APIs, implementing server logic or authentication, integrating databases (PostgreSQL, MongoDB, Redis), or building microservices and caching layers.'

Replace the vague filler 'modern backend patterns' with concrete terms or drop it in favor of naming the frameworks users actually mention (REST, FastAPI, Express).

Trim 'database integration' or narrow it to specific technologies to reduce trigger overlap with the sibling moai-domain-database skill.

DimensionReasoningScore

Specificity

The description lists several specific capability areas — 'API design, database integration, microservices architecture, and modern backend patterns' — which matches the anchor for several specific actions with minor gaps. It falls short of 5 because 'modern backend patterns' is generic filler and the capabilities are topic areas rather than concrete actions; it is above 3 because it names the domain plus four distinct coverage areas rather than only 1-2.

4 / 5

Completeness

Both 'what' ('Backend development specialist covering API design, database integration, microservices architecture, and modern backend patterns') and 'when' ('Use when designing APIs, implementing server logic, authentication, or authorization') are explicitly present, satisfying the what+when requirement. It misses 5 because the when-clause's triggers cover only APIs, server logic, and auth — omitting database, microservices, and caching work that the what-clause claims — so the 'when' could be more complete.

4 / 5

Trigger Term Quality

Natural terms users would say are present: 'designing APIs', 'server logic', 'authentication', 'authorization', 'database integration'. It is not 5 because common variations are missing from the description (REST, endpoints, auth, backend development as a trigger phrase); it is clearly above 3 since multiple relevant natural keywords appear rather than only some.

4 / 5

Distinctiveness Conflict Risk

'Backend development specialist' carves a clear niche with distinct triggers, but 'database integration' and 'microservices architecture' overlap with closely related sibling skills (the body itself lists 'moai-domain-database' and 'moai-foundation-core' as companions), matching the 'mostly distinct; minor overlap risk' anchor rather than the minimal-conflict anchor at 5.

4 / 5

Total

16

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

modu-ai/moai-adk

Path

.claude/skills/moai-domain-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.