CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-templates

Composite pre-review gate for a template PR: (1) sync/duplication check, (2) semgrep static scan, (3) deploy e2e validation incl. crash cases. Use when reviewing or preparing a PR that changes templates or shared source (.scripts/source/, .claude/skills/). Repo-dev tool — NOT synced into templates. Distinct from Databricks' /review (Isaac Review).

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary operational skill body: executable commands with environment-specific prerequisites, ordered phases with validation checkpoints and recovery loops for each failure mode, and clean delegation to sibling skills instead of duplicating their detail. The only nit is mild duplication of the frontmatter in the opening paragraphs.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious environment facts Claude cannot know (pypi proxy because 'public pypi is TLS-blocked in this environment', 'storageState expires ~daily', server-side semgrep being authoritative), so nearly every token earns its place. It misses the 5 anchor only because the opening two paragraphs partly restate the frontmatter description and could be trimmed.

4 / 5

Actionability

Every phase provides copy-paste-ready commands with exact env vars, flags, and paths (e.g., the uvx semgrep invocations and the pytest command with '-p no:xdist'), plus exit-code interpretation, the results file location (logs/validation-report.md), and remediation steps. The few placeholders (<changed-template-dirs>, <shared-app-url>) are necessarily instance-specific, so this matches the 5 anchor rather than 4.

5 / 5

Workflow Clarity

Phases are explicitly ordered 'Run the phases in order: 1 → 2 → 3' with a stated reason (fast local gates before the ~1 hr deploy phase), and each phase has validation checkpoints plus feedback loops: drift → fix source and re-run sync; 'storageState invalid/expired' → recreate via auth_setup.py; semgrep false positive → documented suppression procedure. This matches the 5 anchor's explicit-validation/feedback-loop profile.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and none are needed: the ~73-line body is well-organized per phase and delegates depth to clearly-signaled sibling skills ('(See the sync-check skill)', 'Use the validate-templates skill') exactly one level deep. This matches the 5 anchor's clear-overview/well-signaled-one-level-references structure.

5 / 5

Total

19

/

20

Passed

Description

92%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 strong description: it names the domain, enumerates the three concrete gate phases, gives an explicit 'Use when' clause with concrete path-based triggers, and explicitly fences itself off from the similar-sounding /review skill. The only minor weakness is limited synonym breadth in trigger phrasing.

DimensionReasoningScore

Specificity

The description enumerates three concrete, distinct actions — '(1) sync/duplication check, (2) semgrep static scan, (3) deploy e2e validation incl. crash cases' — giving comprehensive coverage of the skill's scope. It fits the 5 anchor (multiple specific concrete actions) rather than 4, since there are no meaningful gaps for this domain.

5 / 5

Completeness

It explicitly answers both what ('Composite pre-review gate… (1) sync/duplication check, (2) semgrep static scan, (3) deploy e2e validation incl. crash cases') and when ('Use when reviewing or preparing a PR that changes templates or shared source') with concrete trigger conditions. This matches the 5 anchor; the explicit 'Use when' clause rules out the cap of 3 and the concreteness rules out 4.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'Use when reviewing or preparing a PR that changes templates or shared source' plus concrete path tokens (.scripts/source/, .claude/skills/) give good keyword coverage. It falls short of the 5 anchor because it lacks broader synonym variation users might phrase differently (e.g., 'PR review', 'template changes').

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (repo-dev template PR validation) and explicitly disambiguates from the nearest conflicting skill: 'Distinct from Databricks' /review (Isaac Review)' and 'Repo-dev tool — NOT synced into templates'. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

19

/

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

databricks/app-templates

Path

.claude/skills/review-templates/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.