CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

backend-engineer

Plan, implement, and validate backend service changes. Use when patching or adding backend features in an existing API, data, auth, worker, or service codebase.

Quality

75%

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-platform/backend-engineer/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 is a well-organized, safety-conscious process contract with a clear sequenced workflow and explicit fail-fast validation, but it is held back by duplicated bullet lists, abstract directives instead of executable guidance, and progressive-disclosure references that point to files absent from the actual bundle (plus off-topic OpenAI-cookbook material).

Suggestions

De-duplicate the Execution Boundaries and Progressive Disclosure sections — each currently repeats overlapping bullets and lists the same reference files twice in different phrasings.

Replace abstract directives ('Take the smallest action that advances the confirmed goal') with concrete, executable guidance, such as how to locate and run the repo's real validation command.

Fix progressive-disclosure paths to reference files that exist in the skill's own bundle (e.g., references/contract.yaml, references/evals.yaml) and drop the off-topic OpenAI-cookbook lens-pack references that do not fit a generic backend skill.

DimensionReasoningScore

Conciseness

The body is mostly efficient bullet style with no beginner-concept padding, but it could be tightened: the Execution Boundaries section carries two overlapping bullet lists, and the Progressive Disclosure section lists the same lens-pack files twice in two different formats ('Read when:' bullets followed by near-verbatim 'For ...' bullets). This duplication is more than the minor trimming of anchor 4 but short of the several-padded-sections profile of anchor 2.

3 / 5

Actionability

Some concrete procedural guidance exists ("Inspect 2-3 focused surfaces", "rerun the exact failed command", "redact before sharing"), but there are no executable commands or examples, and directives like "Take the smallest action that advances the confirmed goal" are abstract. The off-topic OpenAI-cookbook lens-pack references and the Gotcha about 'External OpenAI or MCP patterns' misdirect rather than instruct, so it does not reach anchor 4's mostly-executable standard.

3 / 5

Workflow Clarity

The 5-step workflow is clearly sequenced with explicit validation checkpoints ("Stop at the first failed gate or blocker", "Rerun the relevant validation after fixes before claiming completion") and a fix-then-rerun feedback loop in the Failure Mode section, matching anchor 4's clear-sequence-with-checkpoints profile. Held below anchor 5 because steps 2-3 are abstractly phrased and no concrete validation commands are given.

4 / 5

Progressive Disclosure

The body is well-sectioned with headers and uses explicit 'Read when:' signaling, but scored against the actual bundle: the referenced paths (Infrastructure/references/software-literature-expert-lens-pack.md, openai-cookbook-expert-lens-pack.md, deferred-skill-context/backend-platform-backend-engineer/) do not exist in the bundle, whose references/ directory holds only contract.yaml, evals.yaml, and task-profile.json — none of which the body mentions. Combined with the duplicated disclosure lists, structure is present but navigation does not resolve, fitting anchor 3.

3 / 5

Total

13

/

20

Passed

Description

83%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 well-formed description following the what-plus-'Use when' pattern with explicit trigger surfaces and third-person voice. Main residual gaps are a thin set of natural trigger synonyms (endpoints, routes, database, refactor) and generic lifecycle verbs rather than enumerated concrete capabilities.

Suggestions

Add one or two natural trigger synonyms users would say, e.g. 'adding API endpoints/routes' or 'fixing backend bugs', to broaden keyword coverage.

Replace one generic lifecycle verb with a concrete capability (e.g., 'validate backend service changes' -> 'validate changes and assess rollback risk') to sharpen specificity.

DimensionReasoningScore

Specificity

Names three concrete actions ("Plan, implement, and validate backend service changes") and specific target surfaces ("API, data, auth, worker, or service codebase"), comparable to anchor 4's several-specific-actions coverage. Held below 5 because the verbs are generic lifecycle terms rather than fully enumerated concrete capabilities (e.g., no mention of endpoint/route work, migrations review, or rollback planning).

4 / 5

Completeness

Clearly answers both what ("Plan, implement, and validate backend service changes") and when ("Use when patching or adding backend features in an existing API, data, auth, worker, or service codebase") with explicit, concrete trigger phrases. This matches the anchor 5 example pattern of a what-statement followed by an explicit 'Use when...' clause.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "backend", "API", "auth", "worker", "service", "patching", "adding backend features" are terms a user would plausibly say. Missing common synonyms and variations a user might naturally use, such as "endpoints", "routes", "database", "bug fix", or "refactor", which keeps it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

The framing of patching/adding features in an existing backend codebase carves out a mostly distinct niche with minor overlap risk against closely related skills (dedicated auth, database, or API-design skills). Not anchor 5 because "API, data, auth, worker, or service" spans nearly the whole server-side domain, so a request touching one of those subdomains could plausibly trigger a more specific sibling skill.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jscraik/Agent-Skills

Path

Skills/backend-platform/backend-engineer/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.