CtrlK
BlogDocsLog inGet started
Tessl Logo

ai-chat

Guidance for improving the Windmill AI chat (copilot), especially global mode — tools, prompts, and context-window discipline. Use when editing chat tools, system prompts, or tool-result shapes under frontend/src/lib/components/copilot/chat, or when changing how the chat manages its context window.

67

Quality

80%

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/ai-chat/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is tight, project-specific, and well-structured with an explicit before/after validation loop, but it stops short of giving the concrete benchmarking steps needed to fully execute its own core workflow.

Suggestions

Inline a minimal benchmark command or the essential ai-evals invocation shape so the workflow is executable without hopping skills.

Add a short before/after checklist or 'definition of done' (e.g. finalContextTokens delta reported) to make the validation step unambiguous.

DimensionReasoningScore

Conciseness

Lean and project-specific — per-iteration overhead, the shared-refactor regression trap, and 'finalContextTokens first' are non-obvious insights Claude would not already know, with no basic-concept padding.

3 / 3

Actionability

Concrete invariants are present ('return { success, message }', 'Strip dead params', optimize finalContextTokens first) with named files/functions, but the core benchmarking execution is deferred to the 'ai-evals' skill, leaving key steps unstated.

2 / 3

Workflow Clarity

A clear sequence with an explicit validation checkpoint is given: 'Run the affected mode before your change and after, same model(s), same cases', plus ordering ('window first, cumulative second').

3 / 3

Progressive Disclosure

Under 50 lines with four well-organized section headers and a single one-level-deep external reference (the 'ai-evals' skill), which fits the simple-skill allowance.

3 / 3

Total

11

/

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 well-targeted with a clear niche and explicit trigger guidance, but the leading 'Guidance for improving' phrasing is abstract and the trigger terms skew technical.

Suggestions

Lead with concrete verbs instead of the abstract 'Guidance for improving' (e.g. 'Tune copilot tools, prompts, and context-window usage...').

Add natural user-facing trigger phrases (e.g. 'the copilot is truncating', 'chat context is overflowing') alongside the technical ones.

DimensionReasoningScore

Specificity

Names the domain ('Windmill AI chat (copilot)... global mode') and several areas ('tools, prompts, and context-window discipline'), but 'Guidance for improving' is abstract rather than a list of multiple concrete actions.

2 / 3

Completeness

Clearly states what it does ('Guidance for improving the Windmill AI chat...') and provides an explicit 'Use when...' trigger clause covering both halves.

3 / 3

Trigger Term Quality

The 'Use when' clause covers relevant triggers ('editing chat tools, system prompts... tool-result shapes'), but leans on technical jargon like 'tool-result shapes' and 'context-window discipline' rather than terms a user would naturally say.

2 / 3

Distinctiveness Conflict Risk

Highly specific niche tied to a named product path ('frontend/src/lib/components/copilot/chat'), making conflict with other skills unlikely.

3 / 3

Total

10

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
windmill-labs/windmill
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.