CtrlK
BlogDocsLog inGet started
Tessl Logo

release-review

Review Orchard deployment manifests

50

Quality

63%

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 ./projects/skill-router/examples/skills/release-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

58%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 maximally lean but underspecified: it states two governing rules (cite source paths, stop without evidence) while leaving the entire review procedure — what to inspect in the manifests and how to format findings — undefined. As an instruction-only skill it lacks the concrete, specific guidance the rubric expects.

Suggestions

Specify what to check in Orchard deployment manifests (e.g., image tags, resource requests/limits, replica counts, env vars, secret references) as a short concrete checklist.

Add a brief sequenced workflow with the existing stop-rule as an explicit checkpoint, e.g., 1. Locate the manifest files, 2. Check each item on the checklist, 3. Report findings as file:line citations, 4. If evidence for a finding is missing, stop and say so.

Show a one-line example of the expected result format so 'Keep source paths in the result' has a concrete model to follow.

DimensionReasoningScore

Conciseness

The body is two lean directives under a heading ("Keep source paths in the result. Stop when evidence is missing.") with zero padding and no explanation of concepts Claude already knows — every token earns its place, matching anchor 5. It is not a 4 because there is nothing to trim; not even minor over-explanation is present.

5 / 5

Actionability

The body provides two high-level constraints ("Keep source paths in the result", "Stop when evidence is missing") but no concrete steps, commands, or specifics for what to check in the manifests or what the result looks like — matching anchor 2 ('Minimal concrete guidance; high-level hints but missing the specific steps'). It exceeds a 1 because the two directives are specific and unambiguous rather than vague abstraction, and falls short of 3/4 because no executable guidance or key review details are given.

2 / 5

Workflow Clarity

No review sequence is laid out — there is a termination rule ("Stop when evidence is missing") and an output constraint, but the many steps between (locate manifests, check what, in what order, how to report) are undefined, fitting anchor 2 ('many gaps; steps poorly defined'). It is above a 1 because the two rules are coherent and 'Stop when evidence is missing' acts as a partial checkpoint; it is not a 3+ because no sequenced workflow with checkpoints is present, and the single-action exception does not apply since the review action itself is ambiguous.

2 / 5

Progressive Disclosure

This is a simple skill under 50 lines with no bundle files (no references/, scripts/, or assets/ exist) and no content that belongs in separate files; the single heading plus directives is well-organized for its size, so per the rubric's simple-skill note it scores 5. There are no buried or nested references to penalize.

5 / 5

Total

14

/

20

Passed

Description

48%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 clearly states what the skill does and names a distinct domain, but it is bare-bones: one generic verb, no enumerated review actions, and no 'Use when...' trigger clause. It reads like a title rather than a discovery-oriented description.

Suggestions

Add a 'Use when...' trigger clause, e.g., 'Use when reviewing Orchard deployment manifests before a release, or when the user mentions Orchard deploys, rollouts, or manifest changes.'

List 2-3 concrete review actions after the verb, e.g., 'Review Orchard deployment manifests: check image tags, resource requests/limits, and replica counts; cite file paths for each finding.'

Include natural trigger variations and file types users would actually say (deploy, release, rollout, .yaml manifests) to improve trigger-term coverage.

DimensionReasoningScore

Specificity

"Review Orchard deployment manifests" names the domain (Orchard deployment manifests) but offers only a single generic action ("Review"), matching the anchor 'Names the domain but actions are minimal or generic' (cf. "Processes PDF files"). It is not a 1 because the domain is concretely named rather than pure abstraction, and not a 3 because no second concrete action (e.g., 'checks image tags and resource limits') is listed.

2 / 5

Completeness

The 'what' is clear ("Review Orchard deployment manifests") but there is no 'when' at all — no "Use when..." clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3. This matches anchor 3 ('Has a clear what but when is missing or only weakly implied'); it is not a 4 because the when-clause is entirely absent, not merely imprecise.

3 / 5

Trigger Term Quality

Relevant keywords exist ("Orchard", "deployment manifests") but common variations and synonyms are missing — no "deploy", "release", "rollout", "Kubernetes/Helm", or file extensions like .yaml. This fits 'Some relevant keywords but missing common variations or synonyms' (cf. "Works with PDF files"); it exceeds a 2 because the terms are natural domain phrases rather than generic filler.

3 / 5

Distinctiveness Conflict Risk

"Orchard deployment manifests" carves out a specific niche, so it is mostly distinct with only minor overlap risk against closely related skills (e.g., generic code-review or deployment skills) — matching anchor 4. It is not a 5 because the thin trigger set and generic verb "Review" leave some conflict risk with other review-oriented skills.

4 / 5

Total

12

/

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
rohitg00/ai-engineering-from-scratch
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.