CtrlK
BlogDocsLog inGet started
Tessl Logo

lsp

Use when Codex needs language-server diagnostics, definitions, references, symbols, or rename safety checks in the current workspace.

67

Quality

80%

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

The canonical home for this skill is lsp in code-yeongyu/lazycodex

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 efficient, well-structured body for a simple tool-listing skill: lean prose, concrete tool inventory, executable config example, and a useful error-recovery tip. The only meaningful gap is the absence of a worked tool-call example and an explicit prepare_rename-then-rename safety sequence, which keep actionability and workflow clarity just below top marks.

Suggestions

Add one concrete example tool call showing argument shape, e.g., a sample lsp.diagnostics or lsp.goto_definition invocation with file/line/character values.

Make the rename safety sequence explicit: 'Before lsp.rename, call lsp.prepare_rename at the position; only apply the rename if it reports valid.'

Note how to configure a new language server (edit .codex/lsp-client.json, then re-run lsp.status) so the status-tip recovery loop is complete.

DimensionReasoningScore

Conciseness

The ~31-line body is lean with zero padding: a one-line tool-invocation caveat ('lsp.*/mcp__lsp__* are tool-call names, not shell commands'), seven one-line tool descriptions, a minimal copy-paste config snippet, and a single closing tip. It assumes Claude's competence and never explains concepts Claude already knows — a clean match for anchor 5.

5 / 5

Actionability

Concrete tool names with parameter hints ('severity: "error"', 'from file, line, and character') and a complete, executable config JSON make the guidance mostly executable. However, there is no worked example of an actual tool call (argument shapes, a sample lsp.diagnostics or lsp.rename invocation), so it stops short of anchor 5's copy-paste-ready coverage of common cases.

4 / 5

Workflow Clarity

For a simple single-purpose skill the action is unambiguous, and an error-recovery pointer exists ('Use lsp.status first when diagnostics report a missing language server'). But the one genuinely multi-step flow — checking rename validity with lsp.prepare_rename before applying lsp.rename — is only implied by list order, not sequenced; this minor checkpoint gap places it at anchor 4 rather than 5.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (no references/, scripts/, or assets/ exist), and the body is organized into clear 'Tools' and 'Config' sections with nothing that belongs in a separate file. Per the simple-skill guideline, well-organized sections alone merit anchor 5.

5 / 5

Total

18

/

20

Passed

Description

75%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 solid description with an explicit 'Use when' trigger clause and five concrete capability keywords, written in third person. It falls short of top marks only on coverage breadth: no standalone what-statement, missing the 'LSP' abbreviation and common phrasings like 'go to definition', and a few trigger words generic enough to invite minor skill overlap.

Suggestions

Add a direct what-statement before the trigger clause, e.g., 'Provides language-server (LSP) tooling: diagnostics, go-to-definition, find-references, symbols, and rename safety checks.'

Include common user phrasings and synonyms as triggers: 'LSP', 'go to definition', 'find usages', 'rename a symbol', 'type errors'.

Qualify generic words to reduce conflict risk, e.g., 'language-server diagnostics' rather than bare 'diagnostics', and mention the concrete trigger 'when a language server is missing or misconfigured'.

DimensionReasoningScore

Specificity

The description names the domain and five concrete capabilities — 'language-server diagnostics, definitions, references, symbols, or rename safety checks' — but omits other common LSP actions (hover, completion, formatting, code actions), leaving minor gaps in coverage. This matches anchor 4 ('several specific actions; minor gaps') rather than anchor 5's comprehensive coverage.

4 / 5

Completeness

The 'when' is explicit and specific ('Use when Codex needs ... in the current workspace'), and the 'what' is derivable from the listed capabilities, but there is no direct capability statement (e.g., 'Provides language-server tooling for ...') — the what is embedded in the trigger clause rather than stated separately. Anchor 4 ('both present; one could be more explicit') is the best fit; not 5 because the what is implicit, not 3 because the when-clause is fully explicit.

4 / 5

Trigger Term Quality

Good natural keyword coverage ('diagnostics', 'definitions', 'references', 'symbols', 'rename', 'workspace') that users would plausibly say, but it misses common variations such as the abbreviation 'LSP', 'go to definition', 'find usages', and 'lint errors'. Fits anchor 4 ('good coverage; a few natural terms missing') more than anchor 5's synonym/extension completeness, and is clearly above anchor 3's missing-variants level.

4 / 5

Distinctiveness Conflict Risk

The 'language-server' scope plus 'rename safety checks' carves a clear niche with mostly distinct triggers, but the bare words 'diagnostics', 'references', and 'symbols' could cause minor overlap with lint/test or general code-search skills. Anchor 4 ('mostly distinct; minor overlap risk with closely related skills') fits better than anchor 5's minimal-conflict bar.

4 / 5

Total

16

/

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
code-yeongyu/oh-my-openagent
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.