CtrlK
BlogDocsLog inGet started
Tessl Logo

fusion-code-conventions

Applies and explains code conventions across TypeScript, React, C#, and Markdown. Enforces naming rules, file naming patterns, TSDoc and XML doc standards, inline comment intent (the *why*, not the *what*), code structure, error handling, async patterns, and dead code policy. Also enforces ADR and contributor doc decisions, and flags decisions that appear stale or misaligned with current tooling. USE FOR: convention questions, code review against project standards, applying naming rules, auditing intent comments, checking TSDoc completeness, enforcing recorded ADR decisions, and flagging stale architectural decisions. DO NOT USE FOR: security vulnerability scanning, performance profiling, runtime debugging, or generating net-new code without a review target.

69

Quality

85%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that excels across all dimensions. It provides highly specific capabilities, rich trigger terms across multiple relevant domains, explicit 'USE FOR' and 'DO NOT USE FOR' clauses that clearly delineate when to select this skill, and strong distinctiveness through its focused niche on code conventions and ADR enforcement. The third-person voice is used correctly throughout.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions: enforcing naming rules, file naming patterns, TSDoc/XML doc standards, inline comment intent, code structure, error handling, async patterns, dead code policy, ADR enforcement, and flagging stale decisions. This is highly specific and actionable.

3 / 3

Completeness

Clearly answers both 'what' (applies/explains code conventions, enforces naming rules, TSDoc standards, ADR decisions, etc.) and 'when' (explicit 'USE FOR' clause with trigger scenarios, plus a 'DO NOT USE FOR' clause that further clarifies boundaries). This is a thorough and explicit description.

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'code conventions', 'TypeScript', 'React', 'C#', 'Markdown', 'naming rules', 'TSDoc', 'code review', 'ADR', 'inline comments', 'dead code'. The 'USE FOR' clause adds additional trigger terms like 'convention questions', 'auditing intent comments', 'checking TSDoc completeness'. Good coverage of natural terms.

3 / 3

Distinctiveness Conflict Risk

The skill occupies a clear niche: code conventions and standards enforcement across specific languages, with ADR decision auditing. The 'DO NOT USE FOR' clause explicitly excludes security scanning, performance profiling, debugging, and net-new code generation, which sharply distinguishes it from other code-related skills.

3 / 3

Total

12

/

12

Passed

Implementation

70%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured orchestration skill with excellent progressive disclosure and clear workflow sequencing. Its main weakness is the lack of concrete examples — no sample findings report, no before/after code snippets showing convention violations, and no executable demonstration of the review process. The content is also slightly verbose in places, particularly the trigger list and precedence section.

Suggestions

Add a concrete example showing a convention violation, the rule it breaks, and the corrected version (e.g., a TypeScript naming violation with before/after code) to improve actionability.

Include a brief sample of the expected findings report format (Required/Recommended/Advisory with one entry each) so the output structure is unambiguous.

Trim the 'When to use' trigger list to 4-5 representative examples and remove overlap with the skill description to improve conciseness.

DimensionReasoningScore

Conciseness

The skill is generally well-structured and avoids explaining basic concepts, but includes some redundancy — the 'When to use' trigger list overlaps heavily with the YAML description, and the precedence section could be tighter. The agent routing table and step-by-step instructions are efficient, but the overall document could be trimmed by ~20% without losing clarity.

2 / 3

Actionability

The workflow is clearly described with specific file paths, agent references, and a classification scheme. However, there are no concrete code examples showing what a convention violation looks like, what a corrected version looks like, or what the output report format should be. The guidance is specific but not executable — it describes what to do rather than showing it.

2 / 3

Workflow Clarity

The four-step workflow is clearly sequenced: classify/route → apply conventions → present findings (with a clear severity taxonomy: Required/Recommended/Advisory) → apply corrections only with user approval. The safety constraint of requiring explicit confirmation before mutations serves as a validation checkpoint, and the parallel agent activation is well-specified.

3 / 3

Progressive Disclosure

The skill is an excellent overview that delegates to well-organized one-level-deep references: language-specific agents in `agents/`, authoritative convention docs in `references/`, and persona-specific follow-up files in `assets/`. Navigation is clear via the agent table and explicit file paths. Content is appropriately split between the overview and referenced files.

3 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

10

/

11

Passed

Repository
equinor/fusion-framework
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.