CtrlK
BlogDocsLog inGet started
Tessl Logo

common-feedback-reporter

Pre-write skill violation audit. Checks planned code against loaded skill anti-patterns before any file write. Use when writing Flutter/Dart code, editing SKILL.md files, or generating any code where project skills are active. Load as composite alongside other skills. When a violation is detected and Auto-fixed: YES, also load +common/common-learning-log to record the mistake.

63

Quality

76%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/common/common-feedback-reporter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%

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 meta-skill that provides clear, actionable guidance for pre-write violation auditing. Its strengths are the concrete violation report format, explicit workflow with feedback loops, and practical examples. Minor weaknesses include slight redundancy between the checkpoint steps and the detection flow diagram, and a reference to a bundle file that doesn't exist.

Suggestions

Remove the detection flow diagram since it duplicates the checkpoint steps, or consolidate both into a single representation to improve conciseness.

Provide the referenced 'references/violation-examples.md' file in the bundle, or remove the reference if the examples section is meant to be self-contained.

DimensionReasoningScore

Conciseness

Generally efficient but has some redundancy — the detection flow diagram largely repeats the checkpoint steps above it. The anti-patterns section and pre-completion check add value but could be slightly tighter. Overall respects Claude's intelligence reasonably well.

2 / 3

Actionability

Provides a concrete, copy-paste-ready violation report template with specific fields, a clear root cause classification table, concrete examples (Flutter color, React class, SKILL.md line count), and explicit trigger conditions tied to specific tool names (write_to_file, replace_file_content, etc.).

3 / 3

Workflow Clarity

The workflow is clearly sequenced: check extension → identify skills → audit against anti-patterns → report if violation → fix immediately. Includes a pre-completion feedback loop ('Did I write code? Did I audit?') and explicit anti-patterns preventing workflow shortcuts. For a meta-skill like this, the validation checkpoints are well-defined.

3 / 3

Progressive Disclosure

References 'references/violation-examples.md' for more examples, which is good progressive disclosure structure. However, the bundle has no files, so the reference is unverifiable. The root cause guide table is inline but reasonably sized. The skill is moderately well-organized but the referenced file doesn't exist in the bundle.

2 / 3

Total

10

/

12

Passed

Description

75%

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 is functionally complete with clear 'what' and 'when' clauses, and occupies a distinct niche that minimizes conflict risk. However, the trigger terms lean heavily on internal/technical jargon rather than natural user language, and the specificity of concrete actions could be improved by listing what kinds of anti-patterns are checked or what the audit output looks like.

Suggestions

Add more natural trigger terms that users might actually say, such as 'before writing code', 'check for mistakes', 'validate against project rules', or 'code quality check'.

List 2-3 specific concrete actions or anti-pattern categories the audit checks for (e.g., 'checks for banned imports, incorrect naming conventions, prohibited patterns') to improve specificity.

DimensionReasoningScore

Specificity

It names the domain (pre-write skill violation audit) and describes the core action (checks planned code against loaded skill anti-patterns before any file write), but doesn't list multiple specific concrete actions beyond that single check. The mention of auto-fix and learning log recording adds some specificity but remains somewhat high-level.

2 / 3

Completeness

Clearly answers both what ('Checks planned code against loaded skill anti-patterns before any file write') and when ('Use when writing Flutter/Dart code, editing SKILL.md files, or generating any code where project skills are active'). Also includes additional conditional guidance about loading the learning log skill.

3 / 3

Trigger Term Quality

Includes some relevant keywords like 'Flutter/Dart code', 'SKILL.md files', 'code', 'anti-patterns', and 'violation', but these are more technical/internal terms than natural user language. Users are unlikely to say 'pre-write skill violation audit' — they'd more likely say 'check my code' or 'review before writing'. Missing common user-facing variations.

2 / 3

Distinctiveness Conflict Risk

This is a very specific niche — pre-write auditing against skill anti-patterns — that is unlikely to conflict with other skills like linters, code review tools, or general coding skills. The 'composite' loading instruction and specific trigger conditions make it clearly distinguishable.

3 / 3

Total

10

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

9

/

11

Passed

Repository
HoangNguyen0403/agent-skills-standard
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.