CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

backend-patterns

Backend architecture patterns, API design, database optimization, and server-side best practices for Node.js, Express, and Next.js API routes. Use when building or reviewing Node.js, Express, or Next.js API routes and their data access.

56

Quality

71%

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/backend-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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.

A well-organized, code-heavy pattern catalog with mostly executable TypeScript examples and good PASS/FAIL contrasts. Its weaknesses are length and duplication (twin cache-aside examples, generic textbook patterns), stubbed method bodies in a few examples, and a fully monolithic structure with no progressive disclosure into reference files.

Suggestions

Split the catalog: keep a concise overview of each pattern (one short example plus when to use) in SKILL.md and move the full implementations (RBAC, logging, queue, transactions) into references/*.md files linked with 'See [X.md](X.md)' so detail is loaded on demand.

Remove the duplicate caching example (the 'Cache-Aside Pattern' section restates 'Redis Caching Layer') and trim textbook patterns Claude already knows (repository/service layer rationale, exponential backoff) to the project-specific deltas.

Fill or remove the stubbed code paths ('// Other methods...', empty vectorSearch/execute bodies) so every example is copy-paste executable, and add explicit validation checkpoints (e.g. verify job completion, check RPC error returns before proceeding) to the database and batch-operation examples.

DimensionReasoningScore

Conciseness

The ~560-line body is mostly code rather than prose, but it duplicates content (two near-identical cache-aside examples in "Redis Caching Layer" and "Cache-Aside Pattern"), spends many lines on textbook patterns Claude already knows (repository/service layer, retry backoff, structured logging), and closes with filler ("Remember: Backend patterns enable scalable, maintainable server-side applications..."). Not 4-5 because the duplication and generic-pattern padding are avoidable; above 2 because there is little conceptual over-explanation and code dominates over narration.

3 / 5

Actionability

Concrete, near-executable TypeScript throughout: a full repository implementation, working middleware wrapper (withAuth), complete RBAC HOF, retry helper, and Supabase RPC transaction with SQL. Not 5 because several examples are stubbed ("// Other methods...", empty vectorSearch body, empty execute in JobQueue, "// Job execution logic"), so they are not copy-paste runnable in those spots; clearly above 3 since the gaps are minor relative to the volume of complete code.

4 / 5

Workflow Clarity

This is a pattern catalog rather than a sequenced workflow: "When to Activate" gives selection triggers, and the Rate Limiting section adds a good guardrail, but there is no ordered process, and database/batch operations (the N+1 batch fetch, the transaction pattern, the in-process JobQueue) lack explicit validate/recover checkpoints. The guideline capping workflow clarity at 3 for batch/database operations without validation applies; above 2 because PASS/GOOD vs FAIL/BAD contrasts in the database sections do give implicit checkpoints.

3 / 5

Progressive Disclosure

The body has clear hierarchical section headers (API Design, Database, Caching, Error Handling, Auth, Rate Limiting, Jobs, Logging) that aid navigation, but everything — including full RBAC, logging, and queue implementations — is inlined in one monolithic 560-line SKILL.md with no references/ or scripts/ files and no pointer files. Not 2 because structure is present and nothing is buried; not 4-5 because content that clearly belongs in separate reference files is inlined.

3 / 5

Total

13

/

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 names a concrete tech stack, several capability areas, and an explicit 'Use when...' trigger in third person. It sits just below the top tier because the trigger clause repeats the stack instead of naming task-level trigger phrases, and "server-side best practices" is mild filler.

DimensionReasoningScore

Specificity

"Backend architecture patterns, API design, database optimization, and server-side best practices" lists several specific capability areas (architecture, API design, DB optimization) with a concrete tech scope (Node.js, Express, Next.js API routes). Not 5 because "server-side best practices" is generic padding and the actions named are domains rather than the multiple concrete actions of the top anchor; clearly above 3 since more than 1-2 areas are named.

4 / 5

Completeness

Both parts are present: the "what" ("Backend architecture patterns, API design, database optimization...") and an explicit "Use when building or reviewing Node.js, Express, or Next.js API routes and their data access" trigger clause. Not 5 because the "when" largely restates the tech stack rather than naming concrete trigger phrases or tasks (e.g. caching, N+1 fixes, auth middleware); comfortably above 3 since the trigger clause is explicit, not implied.

4 / 5

Trigger Term Quality

"Node.js, Express, Next.js API routes", "building or reviewing", and "data access" are natural terms a user would say. Not 5 because common variations like "backend", "REST API", "endpoint", or "server-side" (outside the one "server-side best practices" phrase) are missing; well above 3 given the stack is named twice with concrete framework keywords.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (backend/server-side patterns for a specific stack), distinguishable from frontend or tooling skills. Not 5 because "API design" and "best practices" could overlap with sibling skills like an api-design or code-review skill, and the trigger covers "reviewing" broadly; clearly above 3 since the stack and data-access scope are specific.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (563 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository

affaan-m/ECC

Path

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