CtrlK
BlogDocsLog inGet started
Tessl Logo

ov-ensure-coding-style

Detect and fix clang-format, clang-tidy, and copyright header violations in an OpenVINO C++ codebase. Use when the user complains about code style or formatting, asks to clean up changes, fix linting, add a copyright header, or when a style check or linting CI job is failing. Do not use for build errors, compilation failures, linker errors, test failures, runtime crashes, accuracy issues, or CMake config problems.

68

Quality

86%

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

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 concise, well-structured two-step workflow with a genuine feedback loop and a user-confirmation checkpoint, but it is critically dependent on a single external documentation file outside the skill bundle for the actual fix commands and validation criteria. Inline or bundling that content would make the skill self-contained and actionable end-to-end.

Suggestions

Inline the core check/fix commands (e.g., how to invoke clang-format and clang-tidy on the changed files and how copyright headers are verified) so the skill remains actionable if the external doc path is unavailable or the repo layout differs.

Move the critical fix-order and tool instructions into a references/ file inside the skill bundle and link to it with a stable relative path instead of ../../../docs/dev/coding_style.md, which breaks if the skill is relocated.

Add an explicit validation step with the exact command that determines whether "all checks pass" (e.g., the CI style-check invocation), so the fix loop's exit condition is concrete rather than delegated.

DimensionReasoningScore

Conciseness

The ~25-line body is lean and efficient with zero padding: every line is an instruction ("Iteratively detect and fix all clang-format, clang-tidy, and copyright violations introduced by the current branch's changes"), assuming Claude's competence with git and CMake. Matches the 5 anchor — every token earns its place.

5 / 5

Actionability

Step 1 is concrete (executable "git diff --name-only <ref_commit> | grep -v '^thirdparty' | tee /tmp/changed_files.txt" and exact user-facing prompts), but the actual clang-format/clang-tidy/copyright check-and-fix commands — the core of the skill — are entirely delegated to an external file outside the skill bundle. This fits the 3 anchor (some concrete guidance but incomplete, missing key details) rather than 4, whose "minor gaps" standard this central omission exceeds.

3 / 5

Workflow Clarity

Clear two-step sequence with an explicit confirmation checkpoint ("Do not proceed until the user replies") and a check-fix-repeat feedback loop with a stated exit condition ("Repeat the full cycle until all checks pass"). Fits the 4 anchor — clear sequence, most checkpoints present — but the concrete validation commands defining "all checks pass" are external rather than inline, keeping it below the 5 anchor.

4 / 5

Progressive Disclosure

Well-organized sections with a single, clearly signaled, one-level-deep reference ("Read that file before proceeding") that appropriately keeps repo tool instructions out of the body. However, the sole reference points outside the skill bundle (../../../docs/dev/coding_style.md; no references/ files exist), so the skill is not self-contained and the path is fragile if the repo layout or skill location changes — a minor organization gap consistent with the 4 anchor.

4 / 5

Total

16

/

20

Passed

Description

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

An exemplary description: concrete capabilities, explicit natural-language triggers for both what and when, a niche domain, and negative boundaries that prevent mis-triggering. The only weakness is modest keyword synonym coverage (missing "reformat", "lint", and file extensions).

DimensionReasoningScore

Specificity

"Detect and fix clang-format, clang-tidy, and copyright header violations in an OpenVINO C++ codebase" names the domain and multiple concrete, comprehensive actions. It fits the 5 anchor (multiple specific concrete actions, comprehensive coverage) rather than 4, which requires minor coverage gaps — all three tool categories are explicitly enumerated.

5 / 5

Completeness

It explicitly answers what ("Detect and fix clang-format, clang-tidy, and copyright header violations in an OpenVINO C++ codebase") and when ("Use when the user complains about code style or formatting, asks to clean up changes, fix linting, add a copyright header, or when a style check or linting CI job is failing") with concrete trigger phrases, plus explicit negative boundaries.

5 / 5

Trigger Term Quality

Natural phrases like "complains about code style or formatting", "clean up changes", "fix linting", and "style check or linting CI job is failing" give good keyword coverage, but common synonyms (e.g., "reformat", "run clang-format/clang-tidy", "lint") and file extensions (.cpp, .hpp) are missing, matching the 4 anchor rather than comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (OpenVINO C++, specific named tools) with distinct triggers, and the "Do not use for build errors, compilation failures, linker errors, test failures..." exclusion list actively minimizes conflict with adjacent skills. Minimal conflict risk.

5 / 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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
openvinotoolkit/openvino
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.