CtrlK
BlogDocsLog inGet started
Tessl Logo

backend-dev-guidelines

You are a senior backend engineer operating production-grade services under strict architectural and reliability constraints. Use when routes, controllers, services, repositories, express middleware, or prisma database access.

40

Quality

38%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/backend-dev-guidelines/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

50%

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 adopts a persona-based framing ('You are a senior backend engineer') rather than describing concrete capabilities, which weakens specificity and completeness. It includes a 'Use when' clause with relevant but incomplete trigger terms focused on Express/Prisma stack components. The description would benefit from listing specific actions and broadening trigger term coverage to include common user phrasings.

Suggestions

Replace the persona framing with concrete action descriptions, e.g., 'Creates and maintains Express.js REST API endpoints, implements service-layer business logic, writes Prisma database queries and migrations.'

Expand trigger terms to include natural user phrases like 'API', 'REST endpoint', 'Node.js backend', 'database query', 'server-side logic', and 'CRUD operations'.

Strengthen the 'Use when' clause with more explicit scenarios, e.g., 'Use when the user needs to build or modify Express.js APIs, write Prisma schemas or queries, or implement backend service architecture.'

DimensionReasoningScore

Specificity

The description names the domain ('senior backend engineer operating production-grade services') and mentions some specific components (routes, controllers, services, repositories, middleware, prisma), but does not list concrete actions like 'create endpoints', 'write migrations', or 'implement CRUD operations'. It describes a role rather than specific capabilities.

2 / 3

Completeness

The 'what' is weak—it describes a persona ('senior backend engineer') rather than concrete actions. There is a 'Use when' clause listing trigger terms, but the 'what does this do' portion is vague ('operating production-grade services under strict architectural and reliability constraints' is more of a persona statement than a capability description).

2 / 3

Trigger Term Quality

Includes relevant technical keywords like 'routes', 'controllers', 'services', 'repositories', 'express middleware', and 'prisma database access' that users might mention. However, it misses common natural variations like 'API', 'REST', 'endpoint', 'database query', 'Node.js', 'backend', or 'server-side'.

2 / 3

Distinctiveness Conflict Risk

The mention of Express middleware and Prisma provides some specificity to a particular tech stack, which helps distinguish it. However, broad terms like 'routes', 'controllers', 'services', and 'repositories' could overlap with many backend-related skills in different frameworks or languages.

2 / 3

Total

8

/

12

Passed

Implementation

27%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is a comprehensive but overly verbose backend guidelines document that tries to cover too much ground in a single file. While it provides useful code examples and clear architectural rules, it suffers from explaining concepts Claude already understands, lacks executable completeness in key areas (BaseController, asyncErrorWrapper), and would benefit significantly from being restructured into a concise overview with supporting reference files.

Suggestions

Cut the BFRI section entirely or reduce it to 3-4 lines — it adds ~30 lines of abstract scoring that Claude can reason about without a formula.

Split into a concise SKILL.md overview (~50 lines) with references to separate files: ARCHITECTURE.md (layers + examples), PATTERNS.md (code templates), CHECKLIST.md (validation checklist).

Provide complete, copy-paste-ready implementations for BaseController and asyncErrorWrapper since they are referenced repeatedly but never defined.

Remove explanatory text that restates obvious engineering principles (e.g., 'Each layer has one responsibility', 'Enables mocking and testing') — Claude already knows why DI and layering matter.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~250+ lines. It explains concepts Claude already knows (layered architecture, DI, what controllers do), includes a custom scoring framework (BFRI) that adds significant overhead, repeats 'When to Use' twice, and pads with motivational framing ('production-grade', 'non-negotiable'). The BFRI section alone is ~30 lines of content that could be replaced with a simple decision heuristic. Many sections state obvious engineering practices.

1 / 3

Actionability

The skill provides concrete code examples for routes, controllers, services, Zod validation, and error handling, which is good. However, many examples are incomplete fragments (e.g., BaseController is referenced but never defined, asyncErrorWrapper is used but not shown, unifiedConfig structure is not specified). The BFRI scoring system is abstract and not directly executable. Key implementation details like how to set up Sentry or the BaseController pattern are missing.

2 / 3

Workflow Clarity

The validation checklist at the end provides a clear sequence of checks, and the layered architecture flow is explicit. However, there are no feedback loops or error recovery steps for the development workflow. For a skill involving database operations and migrations (mentioned in scope), the absence of validation-fix-retry patterns caps this at 2. The BFRI assessment process lacks concrete steps for what to do when scores are borderline.

2 / 3

Progressive Disclosure

The entire skill is a monolithic wall of text with 13 numbered sections all inline. There are no bundle files, yet the content is long enough to warrant splitting (e.g., BFRI into its own reference, anti-patterns into a checklist file, code examples into a patterns file). References to other skills (Section 11) exist but are vague with no file paths. The skill would benefit enormously from being an overview that points to detailed sub-documents.

1 / 3

Total

6

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
sickn33/antigravity-awesome-skills
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.