CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

68%

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 ./plugins/antigravity-bundle-full-stack-developer/skills/backend-dev-guidelines/SKILL.md

The canonical home for this skill is backend-dev-guidelines in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 lean, concrete, actionable doctrine with code examples for every rule and both a pre-implementation risk gate and a final validation checklist. Its main weaknesses are editing sloppiness (duplicated 'When to Use', skipped numbering, boilerplate closing line) and the absence of any bundle files to house the referenced-but-undefined helpers.

Suggestions

Provide minimal implementations (or a references/ file) for BaseController, asyncErrorWrapper, and unifiedConfig so the code examples are self-contained and copy-paste ready.

Remove the duplicated 'When to Use' section and the boilerplate closing sentence ('This skill is applicable to execute the workflow or actions described in the overview.'), and fix the section numbering that skips 2.

Add an explicit feedback loop, e.g., 'If BFRI < 3 after implementation, refactor and re-score before merging', and trim the 'Skill Status' section.

DimensionReasoningScore

Conciseness

The body is rule-dense with short code blocks, tables, and no explanations of concepts Claude already knows. Minor trimmable padding exists: the "When to Use" section appears twice (once after BFRI and again at the end with the boilerplate line "This skill is applicable to execute the workflow or actions described in the overview."), plus a low-value "Skill Status" section. Not 5 because of these duplications and filler; not 3 because the bulk is lean and every section carries rules.

4 / 5

Actionability

Concrete TypeScript examples cover route delegation, BaseController pattern, Sentry capture, unifiedConfig import, Zod parsing, constructor DI, asyncErrorWrapper usage, plus a canonical directory tree and naming table. Not 5 because the examples are not copy-paste ready — BaseController, asyncErrorWrapper, and @/config/unifiedConfig are referenced but never defined; not 3 because nearly all guidance is executable code rather than pseudocode or high-level hints.

4 / 5

Workflow Clarity

A workable sequence exists: BFRI feasibility assessment (with an interpretation table that gates action, e.g., "Redesign before coding" for BFRI < 0) → implementation under the doctrine → the final Operator Validation Checklist ("[ ] BFRI ≥ 3 ... [ ] No anti-patterns present"). Not 5 because there is no explicit feedback/re-assessment loop (e.g., re-score BFRI after refactoring) and the sequence is implicit across topic sections; not 3 because both a pre-implementation gate and a final validation checkpoint are present.

4 / 5

Progressive Disclosure

A single ~340-line SKILL.md with no references/, scripts/, or assets/ bundle files; sections are headed and navigable, but everything lives inline. Organizational flaws are visible: section numbering jumps from 1 to 3, "When to Use" is duplicated, and the undefined helper implementations (BaseController, asyncErrorWrapper, unifiedConfig) that would naturally live in reference files are simply absent. Not 4 because there are no references at all and the SKILL.md carries the full load; not 2 because the sections are clearly headed and the file is easy to navigate.

3 / 5

Total

15

/

20

Passed

Description

51%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 has a strong, explicit trigger clause with good natural backend keywords, but the capability statement is a second-person persona sentence with no concrete actions. Rewriting it in third person with 2-3 stated capabilities would lift both specificity and completeness substantially.

Suggestions

Replace the second-person persona ("You are a senior backend engineer...") with a third-person capability statement, e.g., "Enforces a layered routes → controllers → services → repositories architecture for Node.js/Express/Prisma backends."

State 2-3 concrete capabilities in the description (e.g., Zod input validation, Sentry error capture, unified config access, repository-wrapped Prisma access) so the 'what' is explicit, not just the 'when'.

Add natural trigger synonyms such as "API endpoints", "Node.js", "REST", and "Express" to broaden keyword coverage.

DimensionReasoningScore

Specificity

The 'what' portion ("You are a senior backend engineer operating production-grade services under strict architectural and reliability constraints") names the domain but states no concrete capability actions — a persona statement rather than a list of what the skill does, matching anchor 2. The rubric's judging guidelines mandate a 1-point specificity penalty for second-person voice ("You are a senior backend engineer..."), reducing it to 1.

1 / 5

Completeness

The 'when' is explicit and specific, but the 'what' is only a vague persona — it never states capabilities (e.g., enforcing layered architecture, Zod validation, Sentry capture, unified config). Falls between anchor 3 (weak half of what/when) and anchor 4 (both solidly present); the persona-style 'what' keeps it at 3. Not 2 because an explicit 'Use when...' clause is clearly present.

3 / 5

Trigger Term Quality

"Use when routes, controllers, services, repositories, express middleware, or prisma database access" provides good natural keyword coverage a backend developer would actually say. Not 5 because common variations are missing ("API", "endpoints", "Node.js", "REST", "backend"); not 3 because coverage goes well beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

"express middleware" and "prisma database access" carve a clear Node.js/Prisma backend niche with distinct triggers, mostly distinguishable from adjacent skills (e.g., frontend-dev-guidelines). Not 5 because "routes, controllers, services" are generic layered-architecture terms that could overlap with other backend-framework skills; not 3 because the niche is clearly defined.

4 / 5

Total

12

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/antigravity-bundle-full-stack-developer/skills/backend-dev-guidelines/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.