CtrlK
BlogDocsLog inGet started
Tessl Logo

ai-assistant

Streaming chat assistant with conversation memory. Use as a general-purpose assistant for multi-turn conversations where streaming output and context retention matter.

52

Quality

58%

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 ./modules/skills/src/main/resources/META-INF/skills/ai-assistant/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 lean, well-sectioned, and appropriately scoped for a small persona-style skill with no bundle dependencies. Its substantive weakness is actionability: nearly all guidance is generic assistant behavior rather than concrete, specific directives, and the core 500-word rule is stated twice without any supporting detail (e.g., how to handle streaming, memory limits, or conversation summarization).

Suggestions

Convert generic bullets into concrete directives, e.g., 'When answering follow-up questions, reference prior turns explicitly by summarizing the relevant exchange first' or 'Stream responses in one pass without preamble like Certainly! or Sure!'.

Remove the duplicated conciseness rule (stated in both the intro paragraph and Guardrails) and keep it in one place with concrete parameters (word limit, when detail is allowed).

Add one concrete example exchange (user question followed by the expected concise, context-aware response format) so the intended behavior is unambiguous rather than implied by capability bullets.

DimensionReasoningScore

Conciseness

The body is short and free of padding or explanations of concepts Claude already knows, with every section earning roughly its place. It is not 5 because generic persona filler ('You are a helpful, concise assistant') and capability bullets like 'Answer general knowledge questions' and 'Explain technical concepts clearly' restate what any assistant does by default, so a few tokens could be trimmed.

4 / 5

Actionability

The only concrete, executable instruction is 'Keep responses under 500 words unless asked for more detail'; the rest is high-level direction ('Answer general knowledge questions', 'Explain technical concepts clearly', 'Acknowledge uncertainty rather than guessing') that describes rather than instructs, matching 'minimal concrete guidance; high-level hints but missing the specific steps to execute'. It is not 3 because there is no concrete example, template, or specific procedure at all, and it is above 1 because the 500-word limit is a real, measurable directive.

2 / 5

Workflow Clarity

There is no multi-step workflow to sequence, and the content does present a coherent single-purpose behavior (respond concisely, keep context, admit uncertainty), which sits between the rough, gap-filled guidance of anchor 2 and the unambiguous single action that the simple-skill exception would reward with a 5. The 'single action' here is only loosely defined — the body describes a persona and capability list rather than one unambiguous procedure — and the redundant repeat of the conciseness rule in both the intro and Guardrails blurs the core directive.

3 / 5

Progressive Disclosure

This is a short (under 50 lines) single-purpose skill with no bundle files (no references/, scripts/, or assets/ directories exist), and the body is organized into clearly headed sections ('Skills', 'Guardrails') with no inline content that belongs in a separate file. Per the rubric's simple-skill guideline, well-organized sections alone warrant a 5; there are no buried or nested references to penalize.

5 / 5

Total

14

/

20

Passed

Description

58%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 well-formed: third-person, concise, and it explicitly answers both what the skill does and when to use it. Its main weaknesses are limited concrete action coverage, a broad 'general-purpose' framing that raises conflict risk, and missing common trigger variations.

Suggestions

Replace or qualify 'general-purpose assistant' with concrete capability verbs (e.g., 'Streams chat responses token-by-token and retains conversation history across turns') to improve specificity and reduce overlap with other assistant skills.

Add natural trigger phrases and synonyms users would actually say, such as 'chat', 'chatbot', 'follow-up questions', or 'remember what we discussed earlier', to broaden the when-clause beyond 'multi-turn conversations where streaming output and context retention matter'.

DimensionReasoningScore

Specificity

The description names the domain ('Streaming chat assistant') and two capability areas ('conversation memory', 'streaming output', 'context retention'), which matches 'names domain and 1-2 concrete actions, but not comprehensive'. It does not reach 4 because it never enumerates several specific actions (no verb list like 'extracts, fills, merges'), and it is not a 2 because 'streaming output and context retention' are concrete features, not purely generic language.

3 / 5

Completeness

Both parts are present: the 'what' is 'Streaming chat assistant with conversation memory' and the 'when' is an explicit trigger clause 'Use as a general-purpose assistant for multi-turn conversations where streaming output and context retention matter'. This matches anchor 4 ('both what and when; when could be more explicit or specific') rather than 5, because the when-clause is broad and lacks concrete trigger phrases like 'when the user asks a follow-up question' or 'when the user wants responses remembered across turns'. The explicit 'Use as...' clause means it is clearly above 3.

4 / 5

Trigger Term Quality

Natural phrases like 'multi-turn conversations', 'conversation memory', 'streaming output', and 'context retention' are relevant keywords users might say, matching 'some relevant keywords but missing common variations or synonyms'. It is not 4 because common user-facing variations (e.g., 'chat', 'chatbot', 'remember previous messages', 'follow-up questions') are absent, and it is above 2 because the terms present go beyond generic filler.

3 / 5

Distinctiveness Conflict Risk

Phrases like 'general-purpose assistant' are broad and would overlap with many skills, but the qualifiers 'streaming output', 'multi-turn', and 'context retention' give it some specificity, matching 'somewhat specific but could still overlap with similar skills'. It is not 4 because the self-declared 'general-purpose' framing invites conflict with nearly any conversational or assistant skill.

3 / 5

Total

13

/

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.

Validation — 14 / 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

Total

14

/

16

Passed

Repository
Atmosphere/atmosphere
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.