CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sem

Use sem for entity-level (function/class/method) code questions in any Git repo. Four questions, four verbs - where is it (sem find, sem grep), what does my change touch (sem impact), is it correct (sem check), what should a human review (sem certify). Trigger whenever the user asks where something is defined or called, what a change breaks or which tests to run, whether a change is correct, what changed in a commit or PR, or what to review; also use it proactively before refactors and in code review, where line-level git output is noisy.

Quality

96%

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

96%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 tool-usage reference: dense with non-obvious specifics, fully executable commands, explicit MCP-vs-CLI routing, and concrete output-rendering rules. Its only structural limitation is that it is a single inline reference with no progressive disclosure into bundle files, which is acceptable at this size but leaves minor room to split the CLI syntax into a reference file.

Suggestions

Move the '## CLI' block (full flag/syntax reference, ~30 lines) into a references/cli.md file and keep a 3-4 line quick-start in SKILL.md to improve progressive_disclosure while trimming inline tokens.

The 'Four questions, four verbs' table and the MCP table both enumerate the same verb set; consider merging the MCP-tool column into the single questions table to remove one redundant listing and boost conciseness.

DimensionReasoningScore

Conciseness

The body is lean and every section carries tool-specific facts Claude cannot know (MCP parameter combinations, CLI flags, exit codes, the GNU Parallel name conflict, legacy verb aliases). Not 4: there is no over-explanation of concepts Claude already knows to trim; the parallel MCP/CLI listings cover distinct invocation surfaces rather than padding.

5 / 5

Actionability

All guidance is copy-paste ready: complete CLI commands with flags and expected output shapes ("definition: type name file:line", "exit 0 pass, 1 fail, 2 could not decide"), MCP calls with concrete parameter values ("query: 'X', mode: 'context'"), and a worked ASCII-tree example. Not 4: the examples cover the common cases completely.

5 / 5

Workflow Clarity

Task-to-command mappings are unambiguous via two tables, with an explicit precedence rule ('If the agent has the sem MCP server... call those instead of running sem in a shell'), fallback behavior, and an install-conflict check. The skill is a lookup/reference skill with no destructive or batch operations, so no validation checkpoints are required. Not 4: the decision flow (MCP first, CLI fallback, version check) is fully explicit.

5 / 5

Progressive Disclosure

Sections are well-organized (questions table, MCP routing, CLI reference, output-formatting rules, install check) and nothing is a wall of text, but there are no bundle files or references at all — the full CLI syntax reference is inlined in a ~130-line SKILL.md. Not 5: the body exceeds the under-50-line simple-skill exception and the CLI reference block could live in a references file; not 3: structure is clear and content is appropriately dense, with nothing misfiled.

4 / 5

Total

19

/

20

Passed

Description

96%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 states concrete capabilities with commands, gives explicit and varied trigger phrases for both reactive and proactive use, and defines a clear niche. The only weakness is that a few triggers are broad enough to collide with general git and code-review skills.

DimensionReasoningScore

Specificity

The description names five concrete actions with their commands ("sem find, sem grep", "sem impact", "sem check", "sem certify") covering all four capability areas, matching the anchor 'Lists multiple specific concrete actions; comprehensive coverage'. Not 4: coverage is comprehensive rather than having minor gaps.

5 / 5

Completeness

It explicitly answers what ("entity-level (function/class/method) code questions in any Git repo. Four questions, four verbs...") and when ("Trigger whenever the user asks where something is defined or called...") with concrete trigger phrases. Not 4: the 'when' clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Natural phrases users would say are covered with synonyms: "where something is defined or called", "what a change breaks or which tests to run", "whether a change is correct", "what changed in a commit or PR", "what to review", plus proactive contexts ("before refactors and in code review"). Not 4: no common variation is noticeably missing.

5 / 5

Distinctiveness Conflict Risk

The niche (entity-level semantic code analysis, contrasted with 'line-level git output is noisy') is mostly distinct, but broad triggers like "what changed in a commit or PR" and "what to review" overlap with generic git/code-review skills. Not 5: minor overlap risk with closely related skills remains; not 3: the tool and its verbs are clearly differentiated.

4 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

Ataraxy-Labs/sem

Path

skills/sem/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.