CtrlK
BlogDocsLog inGet started
Tessl Logo

multiline-description

This is a multiline description. It spans multiple lines. And should be normalized.

40

Quality

38%

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 ./packages/coding-agent/test/fixtures/skills/multiline-description/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 extremely concise and well-structured for a minimal test skill, earning top marks on conciseness, workflow clarity, and progressive disclosure. Its only weakness is actionability: it describes what the skill tests rather than giving concrete, executable guidance for performing the normalization.

DimensionReasoningScore

Conciseness

The body is only a heading and one sentence ('This skill tests that multiline YAML descriptions are normalized to single lines.') with no padding and no over-explanation of concepts Claude already knows, matching the lean score-5 anchor.

5 / 5

Actionability

It states a fact about what the skill tests but provides only a high-level hint with no concrete steps, commands, or examples for how normalization is performed, sitting just above the entirely-vague score-1 anchor.

2 / 5

Workflow Clarity

This is a simple single-purpose skill under 50 lines whose single action is unambiguous, and it involves no destructive or batch operation that would require validation, so the simple-skill exception yields a 5.

5 / 5

Progressive Disclosure

With under 50 lines, no need for external references, and a single well-organized section, the simple-skill exception for progressive disclosure applies and yields a 5.

5 / 5

Total

17

/

20

Passed

Description

0%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 is placeholder/test text rather than a real skill description: it conveys no capabilities, no trigger terms, no usage conditions, and no distinctiveness. It scores at the floor on every dimension.

Suggestions

Replace the placeholder description with the concrete action the skill performs (e.g., 'Normalizes multiline YAML frontmatter descriptions into single-line form').

Add an explicit 'Use when...' clause stating the natural trigger phrases a user would say to invoke this skill.

Include relevant keywords/synonyms users actually say so the skill is discoverable and distinguishable from others.

DimensionReasoningScore

Specificity

The description ("This is a multiline description. It spans multiple lines. And should be normalized.") names no domain and no concrete actions — it is pure placeholder/abstract language with no capability described, matching the score-1 anchor.

1 / 5

Completeness

It answers neither 'what does this do' (beyond placeholder self-reference) nor 'when should Claude use it' — there is no 'Use when...' clause and both what and when are extremely vague, matching the score-1 anchor.

1 / 5

Trigger Term Quality

There are no natural keywords a user would say to invoke this skill; the text is generic test scaffolding with no real trigger terms, matching the score-1 anchor.

1 / 5

Distinctiveness Conflict Risk

The description is entirely generic placeholder text with no distinguishing niche, so it would conflict with virtually any skill, matching the score-1 anchor.

1 / 5

Total

4

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Kiz8-Team/pi-cwl
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.