CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-public-exposure

Review a change to a public repository for content written for an internal audience, or content a reader outside the company should not have. Use as one lens in a code review run.

Quality

87%

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

100%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 an exemplary instruction-only skill: dense, concrete criteria for what to flag, explicit surfaces to check beyond prose, a clear report/don't-report threshold with a sharp warning against ignore-rule pseudo-fixes, and a specified reporting format with enumerated fix options. Every dimension lands at the top anchor; the only conceivable improvement is a one-line worked example of a finding, which the current Reporting section already renders unnecessary.

DimensionReasoningScore

Conciseness

The ~40-line body is lean throughout: every section (Scope, Method, Threshold, Reporting) carries non-obvious instructions, no concept Claude already knows is explained, and the two-sentence opener ('Everything committed here is world-readable... a commit cannot be recalled once pushed') is load-bearing — it justifies the Threshold rule against ignore-rule fixes. This matches anchor 5 ('lean and efficient; every token earns its place') and is clearly above anchor 4, which requires trimmable over-explanation; nothing here is trimmable without losing a real criterion.

5 / 5

Actionability

As an instruction-only skill the guidance is fully executable: Scope enumerates concrete flag targets ('an issue tracker, chat workspace, wiki, or shared drive... a ticket identifier', 'Roadmap, pricing, customer names', 'A token, key, or internal hostname, including one appearing as an example value'); Method names exact surfaces ('example values, fixture and eval inputs, configuration fields, commented-out lines, and file and directory names'); Threshold gives positive criteria plus an explicit do-not-report list; Reporting specifies the output ('Name the file and line, and say who the content is addressed to') and enumerates the three permitted fixes. Per the rubric's code_vs_instruction note, absence of code is not penalized when guidance is this concrete — this matches anchor 5, and anchor 4 ('minor gaps') does not apply since a reviewer can act on every criterion without inference.

5 / 5

Workflow Clarity

This is a simple single-task skill (a review lens, not a multi-step or destructive/batch operation), so the simple-skill exception applies and the single action is unambiguous: read added lines as an outside reader ('someone evaluating the product, a competitor, a search engine'), apply the Scope categories, gate through the Threshold ('Report content that only makes sense to a reader inside the company, or that a reader outside it should not have'), and report per the Reporting format. The sections present this as a coherent sequence with no gaps; the destructive/batch cap at 3 is inapplicable since the skill only reports findings and never mutates anything.

5 / 5

Progressive Disclosure

The body is ~40 lines with well-organized sections (Scope, Method, Threshold, Reporting) and no bundle files (no references/, scripts/, or assets/ exist, and the body references none), so the under-50-lines guideline applies: well-organized sections alone merit 5. Content is appropriately self-contained — nothing here belongs in a separate file, and there are no nested or buried references, keeping it clearly above anchor 4.

5 / 5

Total

20

/

20

Passed

Description

67%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, honest description: it states a precise what in third person, includes an explicit use clause, and defines a genuinely distinct niche. Its main weaknesses are thin natural-language trigger coverage and a 'when' clause aimed at how the skill fits a review run rather than when a user needs it.

Suggestions

Broaden trigger vocabulary with phrases users naturally say, e.g. 'Use when a change is headed to a public repository, before publishing, or when checking for internal references, ticket IDs, or secrets in file contents.'

Make the 'when' clause more situation-specific rather than integration-focused — state the circumstances (repo is or will be world-readable) that call for the lens, not just that it slots into a code review run.

Consider naming one or two concrete content types (internal links, ticket identifiers, credentials) in the description so the what-coverage matches anchor 5 and further separates it from generic security review.

DimensionReasoningScore

Specificity

The description names the domain ('Review a change to a public repository') and two concrete review targets ('content written for an internal audience, or content a reader outside the company should not have'). It falls short of anchor 5's 'multiple specific concrete actions; comprehensive coverage' because it stays at the level of two broad review targets rather than enumerating the specific content types it flags (internal references, credentials, unreleased detail). It is clearly above anchor 3, which describes only 1-2 narrow actions with no framing of the review posture.

4 / 5

Completeness

The 'what' is clear ('Review a change to a public repository for content written for an internal audience, or content a reader outside the company should not have') and the 'when' is present as explicit trigger guidance ('Use as one lens in a code review run'), so the missing-'Use when' cap at 3 does not apply. It is not anchor 5 because the 'when' clause could be more concrete about the situations that call for this lens (e.g., a repo that is public or about to be published), leaving it at anchor 4 ('has both what and when; when could be more explicit or specific').

4 / 5

Trigger Term Quality

Relevant keywords are present — 'public repository', 'internal audience', 'code review', 'reader outside the company' — but natural variations a user would actually say are missing: 'before publishing', 'secrets', 'internal links', 'ticket references', 'external readers'. This matches anchor 3 ('some relevant keywords but missing common variations or synonyms'); it does not reach anchor 4's 'good keyword coverage' because the trigger phrasing is framed for a review-run integrator rather than the natural vocabulary of a user asking for this check.

3 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (public-exposure review of file contents) with a distinct trigger context (a lens within a code review run). It is not anchor 5 because the credentials/internal-details scope creates minor overlap risk with security-review or secret-scanning skills; it is clearly above anchor 3, which describes skills that could routinely trigger for the wrong task.

4 / 5

Total

15

/

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

tesslio/product-plugins

Path

review-lenses/review-public-exposure/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.