CtrlK
BlogDocsLog inGet started
Tessl Logo

q

Question

44

Quality

46%

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 ./skills/q/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

92%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 lean, well-structured behavioral skill with clear, actionable guidance and an implicit validation self-check. Its only weakness is the absence of worked examples contrasting good and bad answers.

DimensionReasoningScore

Conciseness

The body is three terse, non-redundant lines that assume Claude's competence and explain nothing Claude already knows, matching the anchor for lean and efficient content.

5 / 5

Actionability

The behavioral directives are concrete and executable ('say so plainly', 'do not shape the answer'), but no worked examples of good vs. bad answers are provided, leaving a minor gap versus fully copy-paste-ready guidance.

4 / 5

Workflow Clarity

This is a simple single-action skill with an unambiguous action and a built-in self-check ('If you do not know, say so plainly'), and it involves no destructive or batch operations that would cap the score.

5 / 5

Progressive Disclosure

Under 50 lines with no need for external references, the two well-organized bullets satisfy the simple-skill exception for well-structured content.

5 / 5

Total

19

/

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 a single generic word that conveys no capabilities, no trigger conditions, and no distinctiveness from other skills. Voice is correctly third-person, but there is essentially no usable content to route on.

Suggestions

Expand the description to state the concrete action, e.g. 'Answers a question supplied alongside this skill invocation honestly and without deference to the asker's perspective.'

Add an explicit 'Use when...' trigger clause so the skill is routed only when the user supplies a question for objective answering.

Include natural trigger terms (e.g. 'answer this question', 'give me the straight facts') to improve distinctiveness and routing.

DimensionReasoningScore

Specificity

The description is the single word 'Question', which names no concrete actions or capability domain — even more abstract than the anchor-2 example 'Processes PDF files'.

1 / 5

Completeness

'Question' supplies neither a clear 'what' (no actions described) nor any 'when'/use-trigger guidance, fitting the anchor for missing both what and when.

1 / 5

Trigger Term Quality

'Question' is a single maximally generic word rather than a natural trigger phrase a user would say to invoke this skill, matching the anchor for no usable natural keywords.

1 / 5

Distinctiveness Conflict Risk

'Question' is entirely generic and would overlap with virtually any skill, since answering questions is what every skill does.

1 / 5

Total

4

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

description_field

'description' is very short (8 chars), consider making it more detailed

Warning

Total

15

/

16

Passed

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