CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cpp-pro

Write idiomatic C++ code with modern features, RAII, smart pointers, and STL algorithms. Handles templates, move semantics, and performance optimization.

Quality

61%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/cpp-pro/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

38%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 core content (Focus Areas, Approach, Output) is a lean, sensible modern-C++ checklist, but it is wrapped in generic boilerplate and lacks any executable examples. Most seriously, progressive disclosure is broken: five real reference files are never surfaced, while the one referenced path points to a nonexistent file.

Suggestions

Fix the reference path and surface the real bundle: replace "open `resources/implementation-playbook.md`" with clearly signaled links to the actual files, e.g. "**Templates & concepts**: see [references/templates.md](references/templates.md); **Concurrency**: see [references/concurrency.md](references/concurrency.md)" for all five reference files.

Delete the boilerplate "Use this skill when" / "Do not use this skill when" / generic "Instructions" filler that merely restates the skill name, and keep only C++-specific guidance.

Add one short executable example or command (e.g. a sanitizer build flag like `g++ -fsanitize=address,undefined -std=c++20` or a canonical smart-pointer/RAII snippet) to make the guidance copy-paste actionable.

DimensionReasoningScore

Conciseness

Several sections are pure boilerplate padding: "Working on cpp pro tasks or workflows", "Needing guidance, best practices, or checklists for cpp pro", "The task is unrelated to cpp pro", and "Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes" add zero C++-specific information. It is above 1 because the Focus Areas/Approach/Output sections themselves are lean lists with no concept explanations, but the volume of generic filler fits "noticeably verbose; several unnecessary... padded sections".

2 / 5

Actionability

There is some concrete guidance — "Prefer stack allocation and RAII", "Follow the Rule of Zero/Three/Five", "Profile with tools like perf and VTune", "Unit tests using Google Test or Catch2" — but no code examples, commands, or specific patterns, and the one pointer to detailed examples ("open `resources/implementation-playbook.md`") is a broken path. It is above 2 because specific tools and rules are named, but below 4 because nothing is executable or copy-paste ready and key details are missing.

3 / 5

Workflow Clarity

The Approach section lists six numbered directives, giving a rough sequence, but validation is only a vague "Apply relevant best practices and validate outcomes" with no checkpoint or feedback loop. The skill is not destructive/batch so no cap applies, and it is not 4 because validation is absent rather than a minor gap; it is above 2 because the steps are defined and coherent, just checkpoint-less.

3 / 5

Progressive Disclosure

The bundle contains five reference files (build-tooling.md, concurrency.md, memory-performance.md, modern-cpp.md, templates.md), yet none are mentioned or linked anywhere in the body, and the single reference the body does give — `resources/implementation-playbook.md` — does not exist (wrong directory and filename). Real references are effectively buried/invisible and navigation is broken, matching "minimal structure; ... references are buried"; it is above 1 only because the body itself is sectioned and not a monolithic wall of text.

2 / 5

Total

10

/

20

Passed

Description

66%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, specific description in third-person voice that clearly names the modern-C++ domain and its key feature areas. Its main defect is the complete absence of a "Use when..." trigger clause, which both caps completeness and leaves invocation entirely implicit.

Suggestions

Append an explicit trigger clause, e.g. "Use when writing or reviewing C++ code, migrating legacy C++ to modern standards, or debugging memory/performance issues in C++ projects."

Include natural trigger variations users say, such as "C++11/14/17/20", "STL", "CMake", or "memory leaks", to strengthen trigger-term coverage.

Consider naming one distinguishing deliverable (e.g. "with CMake build files and sanitizer-clean output") to further separate it from generic coding-assistant skills.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — "RAII, smart pointers, and STL algorithms", "templates, move semantics, and performance optimization" — with only minor gaps. It falls short of 5 because these are topic nouns rather than multiple distinct concrete actions with comprehensive coverage, and it stays above 3 because more than 1-2 specific items are named.

4 / 5

Completeness

The "what" is clear ("Write idiomatic C++ code with modern features... Handles templates, move semantics, and performance optimization") but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is above 2 because the "what" is specific rather than vague, and below 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Natural user phrases like "C++", "smart pointers", "templates", "move semantics", "performance optimization", and "RAII" are present and would be said by users needing this skill. It is not 5 because common variations users actually say — standard versions (C++11/17/20), "STL", "CMake", "segfault/memory leak" — are missing from the description.

4 / 5

Distinctiveness Conflict Risk

Terms like "RAII", "move semantics", "smart pointers", and "STL algorithms" carve out a distinct modern-C++ niche with only minor overlap risk against general coding or C-programming skills. It is not 5 because the opening "Write idiomatic C++ code with modern features" is broad enough to overlap with any general C++ assistance skill.

4 / 5

Total

15

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/cpp-pro/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.