CtrlK
BlogDocsLog inGet started
Tessl Logo

add-diagnostic-parser

Use when adding a compiler or tool output parser for the Problems panel. Touches src/diagnostics/<name>.ts, src/diagnostics/build.ts, package.json (cmake.enabledOutputParsers), and package.nls.json. Triggers: "add parser", "new diagnostic parser", "parse compiler output".

67

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, actionable recipe with executable code, a clear step sequence, and a verification checklist. The main gaps are placeholder code in the stateful-parser example and a broken "See also" reference link.

Suggestions

Replace the placeholder comments in the multi-line/stateful parser example with a concrete (even if minimal) FIRST_LINE_REGEX and diagnostic-completion check so it is copy-paste executable like the single-regex example.

Fix or remove the "See also: ../copilot-instructions.md" link — the target file does not exist relative to the skill, so the reference is currently broken.

Consolidate the overview file table and the "Currently registered parsers" table to remove redundancy and tighten the token budget.

DimensionReasoningScore

Conciseness

The body is mostly lean code, tables, and a checklist rather than padded prose explaining concepts Claude already knows; minor instances could be trimmed (e.g., slight redundancy between the overview table and the "Currently registered parsers" table, and commented base-class contract), so it is efficient but not maximally so.

4 / 5

Actionability

Provides a fully executable single-regex parser example with a real regex and doHandleLine, plus concrete registration, package.json, test, and changelog snippets. The multi-line/stateful example relies on placeholders ("/* ... build partial diagnostic ... */") rather than complete code, which is a minor gap keeping it at 4.

4 / 5

Workflow Clarity

A clear six-step sequence (create parser, register, update package.json, update nls, tests, changelog) with an explicit verification checklist including "yarn compile succeeds" and tests passing. The validate→fix→retry feedback loop is implied by the checklist rather than spelled out as an explicit retry loop, so it does not reach 5; no destructive/batch cap applies since the task is additive.

4 / 5

Progressive Disclosure

Well-organized into clearly headed sections for a coherent single-process skill where inlining is justified, with no monolithic wall of text. The only external reference ("See also: ../copilot-instructions.md") does not resolve to an existing file, and no bundle files are provided, which leaves minor organization gaps below 5.

4 / 5

Total

16

/

20

Passed

Description

87%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, specific description that clearly answers both what the skill does and when to trigger it, with concrete file targets and natural trigger phrases. Minor room to broaden trigger synonym coverage.

DimensionReasoningScore

Specificity

Names a concrete domain (adding a compiler/tool output parser for the Problems panel) and lists four specific files touched (src/diagnostics/<name>.ts, build.ts, package.json cmake.enabledOutputParsers, package.nls.json). It is essentially one action with implementation locators rather than multiple distinct actions, so it sits at 4 rather than 5.

4 / 5

Completeness

Explicitly states what the skill does (adding an output parser touching named files) and when to use it, including a dedicated "Triggers:" list with concrete phrases — matching the anchor that requires both an explicit what and concrete trigger phrases.

5 / 5

Trigger Term Quality

Provides three natural trigger phrases ("add parser", "new diagnostic parser", "parse compiler output") plus a "Use when" clause, giving good coverage; they are variations on one phrase rather than diverse synonyms or file extensions, keeping it below 5.

4 / 5

Distinctiveness Conflict Risk

Targets a narrow, codebase-specific niche (CMake Tools diagnostic parsers, named source paths) with distinct trigger phrases, giving it a clear niche and minimal overlap with other skills.

5 / 5

Total

18

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
microsoft/vscode-cmake-tools
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.