CtrlK
BlogDocsLog inGet started
Tessl Logo

cpp-coding-standards

C++ coding standards based on the C++ Core Guidelines (isocpp.github.io). Use when writing, reviewing, or refactoring C++ code to enforce modern, safe, and idiomatic practices.

83

1.11x
Quality

77%

Does it follow best practices?

Impact

97%

1.11x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.kiro/skills/cpp-coding-standards/SKILL.md

The canonical home for this skill is cpp-coding-standards in affaan-m/ECC

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable — executable DO/DON'T examples, explicit anti-pattern lists, and a closing checklist — with clear section organization. Its weaknesses are token efficiency (720 lines restating Core Guidelines knowledge Claude already has) and zero progressive disclosure: everything is inlined in SKILL.md with no reference files.

Suggestions

Trim SKILL.md to a lean overview (cross-cutting principles, When to Use, and the quick-reference checklist) and move the per-section rule tables and full code listings (Rule of Five, RAII FileHandle, ThreadSafeQueue) into one-level-deep reference files like references/rules.md and references/examples.md.

Reduce reliance on reproducing Core Guidelines content Claude already knows: keep the rule IDs with one-line summaries and DO/DON'T contrasts, and cut complete canonical implementations (e.g., the full Buffer copy/move assignment) that Claude can generate on demand.

For conciseness, convert long anti-pattern bullet lists that restate well-known guidance (e.g., raw new/delete, malloc/free) into a single compact table keyed by rule ID.

DimensionReasoningScore

Conciseness

The body is ~720 lines with essentially no prose padding, but much of it restates the C++ Core Guidelines — rule-summary tables (P.*, F.*, C.*...), full Rule of Five and RAII implementations — that Claude already knows well. Anchor 3 fits: mostly efficient per-section, but the full Buffer/FileHandle listings and rule inventories could be tightened or trimmed since Claude can generate canonical RAII code itself.

3 / 5

Actionability

Concrete, executable code throughout: complete DO/DON'T examples ("explicit Buffer(std::size_t size)...", "std::scoped_lock lock(from.mutex_, to.mutex_)", "cv_.wait(lock, [this] { return !queue_.empty(); })") plus explicit anti-pattern lists per section. Code is copy-paste ready and covers the common cases, matching the anchor-5 example.

5 / 5

Workflow Clarity

Not a step-sequence skill but a reference standard; its structure (When to Use / NOT to Use → Cross-Cutting Principles → per-area rules with DO/DON'T → "Quick Reference Checklist: Before marking C++ work complete") provides a clear usage sequence with a terminal checklist checkpoint. Not 5 because there are no intermediate validation/feedback checkpoints (e.g., how to check compliance incrementally); not 3 because the closing checklist is an explicit verification step and the organization is coherent.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so all ~720 lines are inlined in SKILL.md. Section headers are clear, but the deep-dive material — full Rule of Five and RAII implementations, per-section rule tables — clearly belongs in one-level-deep reference files with a lean overview, matching anchor 3 ("content that should be separate is inline"). Not 4 because there is no reference-file split or navigation to slower-loading detail at all.

3 / 5

Total

15

/

20

Passed

Description

83%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 that clearly names its source (C++ Core Guidelines), scopes itself to C++, and provides an explicit 'Use when' clause with three concrete trigger tasks. The only weakness is mild overlap with generic code-review/refactoring skills and the slightly buzzwordy "modern, safe, and idiomatic practices" tagline.

DimensionReasoningScore

Specificity

Quotes: "C++ coding standards based on the C++ Core Guidelines (isocpp.github.io)" names a concrete, authoritative source, and "writing, reviewing, or refactoring C++ code" lists three specific user tasks. Not 5 because "enforce modern, safe, and idiomatic practices" leans on generic adjectives rather than concrete capabilities; not 3 because multiple concrete actions are named beyond a bare domain label.

4 / 5

Completeness

Quotes: what — "C++ coding standards based on the C++ Core Guidelines (isocpp.github.io)"; when — "Use when writing, reviewing, or refactoring C++ code". Both are explicit and the when clause carries concrete trigger phrases, matching the anchor-5 example pattern almost exactly. Not 4 because the 'when' is already as explicit and specific as the rubric's best example.

5 / 5

Trigger Term Quality

Quotes: "C++", "writing, reviewing, or refactoring C++ code" — natural phrases users would say, plus the recognizable "C++ Core Guidelines" and "isocpp.github.io". Not 5 because it lacks common variations like ".cpp", "C++17/20", "style guide", or "lint" that users might use; not 3 because coverage of the core natural terms is good, not partial.

4 / 5

Distinctiveness Conflict Risk

Quotes: "C++ coding standards" and "refactoring C++ code" — a clear language-scoped niche with distinct triggers. Not 5 because "reviewing... C++ code" and "refactoring" overlap with generic code-review/refactoring skills, a minor conflict risk with closely related skills; not 3 because the explicit C++ restriction keeps it far more distinct than a broad domain claim.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (724 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
affaan-m/ECC
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.