CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sem-code-review

Find named code entities, inspect callers, and review changed functions with the locally installed Ataraxy Sem CLI. Use for code discovery or Git change review when Sem is available.

Quality

89%

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

90%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 excellent, tightly written single-file skill: fully executable commands, lean Sem-specific guidance, explicit safety boundaries (sem check hazard, no auto-install, scoped edits), and thoughtful validation/fallback handling. The only improvements are structural - adding a few section headers and making the implicit workflow order explicit.

Suggestions

Add 2-3 short section headers (e.g. 'Queries', 'Diff and review', 'Boundaries') so the headerless prose blocks are scannable at a glance.

Make the implicit workflow order explicit (1. verify sem --version, 2. choose the smallest query, 3. fall back to text search when results are incomplete, 4. report with source locations) so the checkpoints are ordered rather than implied.

DimensionReasoningScore

Conciseness

The body is lean with zero padding: every sentence adds non-obvious, Sem-specific knowledge (version pinning vs GNU sem, env prefixes, disambiguation flags, the sem check execution hazard). It fully assumes Claude's competence and every token earns its place, matching the 5 anchor; the 4 anchor's 'minor instances of over-explanation' are absent.

5 / 5

Actionability

The five ready-to-run commands in the code block are complete and executable as written (env prefix, --json, concrete --budget value), and the surrounding prose gives specific flags (--in, --file) and a concrete diff pattern (BASE..HEAD substitution). This matches 'copy-paste ready commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

There is a clear implicit sequence (version check -> smallest query -> fallbacks -> report with source locations) plus validation and fallback guidance (sem --version gate, empty-result-is-not-proof, fall back to text search), fitting 'clear sequence with most checkpoints present'. Not 5 because the flow is presented as principles rather than an ordered sequence, so checkpoints are implicit; not 3 because the version check and fallback guidance are explicit.

4 / 5

Progressive Disclosure

This is an under-50-line single-file skill with no bundle files, and all content appropriately lives inline in one coherent flow. Structure is good but the body mixes query guidance, fallback strategy, review reporting, and safety constraints with no section headers beyond the H1, which is a minor organization gap per the 4 anchor; not 5 because the simple-skill exception still presumes well-organized sections.

4 / 5

Total

18

/

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 strong description that explicitly answers both what and when with concrete, third-person actions anchored to a specific tool. Keyword coverage is good but could add common synonyms like "diff" and "impact analysis" to broaden natural triggering.

DimensionReasoningScore

Specificity

"Find named code entities, inspect callers, and review changed functions" lists three concrete actions plus the specific tool (Ataraxy Sem CLI), matching the 'several specific actions; minor gaps' anchor. Not 5 because capabilities the skill actually supports (diff impact analysis with --tests, commit-range diffs) are not mentioned; not 3 because coverage exceeds 1-2 actions.

4 / 5

Completeness

The what is concrete ("Find named code entities, inspect callers, and review changed functions with the locally installed Ataraxy Sem CLI") and the when is explicit with concrete trigger tasks ("Use for code discovery or Git change review when Sem is available"). Both are explicitly and clearly answered, matching the 5 anchor.

5 / 5

Trigger Term Quality

Natural developer phrases like "callers", "code discovery", and "Git change review" are present and would be said by users, but common variations such as "diff", "impact", "symbol", or "who calls this function" are missing. This fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

Being tied to the specific Ataraxy Sem CLI gives it a clear niche, but "Git change review" overlaps with generic code-review skills and the built-in review domain. Minor overlap risk with closely related skills fits the 4 anchor; not 5 because a plain "review my changes" request could plausibly trigger it.

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

Ataraxy-Labs/sem

Path

integrations/agent-plugin/skills/sem-code-review/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.