CtrlK
BlogDocsLog inGet started
Tessl Logo

project-standards-reviewer

Always-on code-review persona. Audits changes against the project's own CLAUDE.md and AGENTS.md standards -- frontmatter rules, reference inclusion, naming conventions, cross-platform portability, and tool selection policies.

61

Quality

75%

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 ./.agents/skills/project-standards-reviewer/SKILL.md
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 lean, highly actionable instruction-only skill: every hunting category carries concrete examples, confidence bands and evidence rules act as quality gates, and the output is a strict JSON contract. Weaknesses are minor: some duplicated rule-matching guidance, an unstated end-to-end review order, and a findings schema that is referenced but neither bundled nor shown.

Suggestions

Include the findings schema inline or as a bundled reference file, and show one complete example finding (with rule quote, diff lines, and confidence) in the output section.

Deduplicate the rule-matching guidance between 'Standards discovery' and 'What you don't flag' into a single statement.

State the review sequence explicitly (read standards → read diff → match rules → check categories → calibrate → emit JSON) at the top of the body.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and assumes competence — no concept explanations or padding, e.g. "You audit code changes against the project's own standards files... not to invent new rules." Not a 5 because the rule-matching idea is duplicated ("A skill compliance checklist does not apply to a TypeScript converter change" appears in both Standards discovery and What you don't flag), which could be tightened.

4 / 5

Actionability

Concrete, executable guidance throughout: specific violation categories with inline examples ("TodoWrite" instead of "TaskCreate", "learnings-researcher" instead of the fully qualified name), numeric confidence bands (0.80+/0.60-0.79/below 0.60), a two-part evidence requirement with a drop rule, and a copy-paste JSON output block. Not a 5 because it says "matching the findings schema" without showing that schema, and the output example omits where the calibrated confidence value goes — a minor gap for an instruction-only skill.

4 / 5

Workflow Clarity

The sequence is coherent: standards discovery (two paths, one with numbered steps) → match rules to file types → hunt violations → calibrate confidence → apply exclusions → evidence check → JSON output. Checkpoints exist (confidence suppression rule, evidence drop rule, exclusion list). Not a 5 because the overall review order is implied rather than stated as an explicit step sequence, and there is no verify/re-check loop before emitting findings.

4 / 5

Progressive Disclosure

Well-organized sections (discovery, hunting list, calibration, exclusions, evidence, output) with no bundle files to disclose; at ~72 lines of compact persona guidance, nothing clearly belongs in a separate file, so it sits just outside the under-50-line 5 exception. The one buried reference — "matching the findings schema" with no path or included schema — keeps it at 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

75%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 focused, third-person description that names a distinct niche (project-standards compliance auditing) with a concrete category list. Its main weakness is trigger phrasing: 'Always-on' conveys activation mode but no explicit 'Use when...' clause or natural synonym coverage.

Suggestions

Add an explicit trigger clause, e.g. 'Use when reviewing diffs in a repository that has CLAUDE.md or AGENTS.md standards files.'

Broaden natural trigger synonyms such as 'project conventions', 'repo standards', or 'PR review' to improve keyword coverage.

DimensionReasoningScore

Specificity

"Audits changes against the project's own CLAUDE.md and AGENTS.md standards" names the domain and one concrete action, then enumerates five specific check areas ("frontmatter rules, reference inclusion, naming conventions, cross-platform portability, and tool selection policies"). Falls short of 5 because there is only one verb (audits) and coverage is a category list rather than multiple distinct concrete actions; clearly above 3's '1-2 concrete actions'.

4 / 5

Completeness

The 'what' is clear and concrete; the 'when' is present via "Always-on code-review persona", which is explicit trigger guidance (so the missing-'Use when' cap of 3 does not apply), but it is less explicit and specific than a full 'Use when reviewing changes against project standards...' clause. Fits anchor 4 exactly: both present, 'when' could be more explicit.

4 / 5

Trigger Term Quality

Strong natural terms users would actually say: "CLAUDE.md", "AGENTS.md", "code-review", "frontmatter", "naming conventions", "portability". Missing common variations and synonyms ("conventions", "review my PR", "project rules", "agent standards"), so it does not reach 5's comprehensive synonym coverage; well above 3's partial keyword set.

4 / 5

Distinctiveness Conflict Risk

Auditing against a project's own standards files (CLAUDE.md/AGENTS.md) is a clear niche distinct from general code review. Minor overlap remains with generic code-review skills, since "code-review persona" could fire on any review request; not the minimal-conflict clear-niche case of 5.

4 / 5

Total

16

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

12

/

16

Passed

Repository
udecode/plate
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.