CtrlK
BlogDocsLog inGet started
Tessl Logo

coding-standards

适用于TypeScript、JavaScript、React和Node.js开发的通用编码标准、最佳实践和模式。

45

Quality

48%

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 ./docs/zh-CN/skills/coding-standards/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

51%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 a richly actionable coding-standards reference with many concrete PASS/FAIL code examples across the TS/JS/React/Node stack, but it is somewhat verbose (re-explaining well-known principles), has no multi-step workflow with validation checkpoints, and inlines everything in one file with no progressive disclosure.

Suggestions

Trim or remove the KISS/DRY/YAGNI/readability principles block and basic naming aphorisms — Claude already knows these; keep only the project-specific conventions.

Move detailed reference material (API design conventions, code-smell catalog, JSDoc guide) into separate files under references/ and link to them from SKILL.md to enable progressive disclosure.

Add a short applied workflow with validation checkpoints (e.g., 'lint → type-check → review against these standards → fix → re-verify') so the standards can be executed as a process, not just browsed.

DimensionReasoningScore

Conciseness

The body is mostly concrete PASS/FAIL code examples that earn their tokens, but it includes unnecessary explanation of concepts Claude already knows — the KISS/DRY/YAGNI/readability principles block and aphorisms like '代码被阅读的次数远多于被编写的次数' — and the PASS/FAIL doubling on basic naming examples could be tightened. It is not severely padded (score 2) because the bulk is actionable code, but it carries more than minor over-explanation.

3 / 5

Actionability

It provides extensive concrete, executable TypeScript/React snippets covering naming, error handling, async, types, components, hooks, API design, validation, memoization, and testing — mostly copy-paste ready. Minor gaps (placeholder '// Implementation' bodies in getMarket/searchMarkets and empty '() => { }' test bodies) keep it just below fully executable at score 5.

4 / 5

Workflow Clarity

This is a reference/standards document, not a sequenced process: sections are roughly ordered (principles → language → React → API → file org → comments → perf → testing → smells) but there are no defined operational steps or validation checkpoints for applying the standards, and validation is absent. It is above score 1 (content is coherent and has an activation list) but lacks the sequenced steps required for score 3.

2 / 5

Progressive Disclosure

The body is well-organized into a clear hierarchy of headers, but everything is inlined in a single ~530-line SKILL.md with no external references or bundle files — content that could be split out (detailed API design, code-smell catalog, JSDoc guide) lives inline. It is better than 'minimal structure' (score 2) due to the clear headers, but has no signaled one-level-deep references required for score 4.

3 / 5

Total

12

/

20

Passed

Description

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

The description clearly names its technology stack and content type but relies on generic abstract nouns ('standards, best practices, patterns') instead of concrete actions and lacks any 'Use when...' trigger guidance. It is recognizable but under-specified for reliable skill activation.

Suggestions

Replace abstract nouns with concrete actions, e.g. 'Enforces naming conventions, error-handling patterns, immutability rules, and React/TypeScript best practices across TS, JS, React, and Node.js code.'

Add an explicit trigger clause: 'Use when reviewing code quality, refactoring existing code, setting up linting/formatting/type-check rules, or onboarding contributors to coding conventions.'

Include natural synonyms users actually say ('code review', 'refactoring', 'linting', 'conventions') to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('TypeScript、JavaScript、React和Node.js开发') but the actions ('通用编码标准、最佳实践和模式') are abstract categories rather than concrete actions like 'enforce naming conventions' or 'review code'. It is not entirely vague (it specifies a stack) but the actions are minimal and generic, fitting score 2 rather than 3 which requires 1-2 concrete actions.

2 / 5

Completeness

There is a clear 'what' (coding standards/best practices/patterns for the stack) but no 'when' — there is no 'Use when...' clause or equivalent explicit trigger guidance, which per the rubric caps completeness at 3. It is above score 2 because the 'what' is not purely vague, but cannot reach 4 without any explicit 'when'.

3 / 5

Trigger Term Quality

It includes natural terms users say — the named technologies (TypeScript, JavaScript, React, Node.js) plus '编码标准' (coding standards) and '最佳实践' (best practices) — but misses common variations a user would naturally say such as 'code review', 'refactoring', 'linting', or 'conventions'. This matches 'some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

The specified tech stack (TS/JS/React/Node) gives it a somewhat specific niche, but '通用编码标准' (general coding standards) is a broad scope with real overlap risk against language- or framework-specific skills. It is not very broad (score 2) thanks to the named stack, but not mostly distinct (score 4) because general standards for a common stack overlaps several related skills.

3 / 5

Total

11

/

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (539 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.