Answer weather queries with a fixed demo response.
67
58%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Critical
Do not install without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./examples/claudecode/.claude/skills/weather-query/SKILL.mdQuality
Discovery
32%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 brief and identifies the domain (weather) and a basic action (answering with a demo response), but it lacks explicit trigger guidance ('Use when...'), natural keyword variations, and multiple concrete actions. It would benefit from more specificity about when to invoke the skill and what kinds of weather queries it handles.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about weather, forecasts, temperature, or current conditions.'
Include natural trigger term variations such as 'forecast', 'temperature', 'weather report', 'current weather', '.weather'.
Clarify the scope more concretely, e.g., 'Returns a hardcoded demo weather response for testing purposes. Does not call real APIs.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain ('weather queries') and a single action ('answer... with a fixed demo response'), but does not list multiple concrete actions or elaborate on capabilities. | 2 / 3 |
Completeness | It describes what the skill does but lacks any explicit 'Use when...' clause or trigger guidance, and per the rubric a missing 'Use when' clause caps completeness at 2. Additionally, the 'what' is minimal, so this falls to a 1. | 1 / 3 |
Trigger Term Quality | Includes 'weather queries' which is a natural keyword, but misses common variations like 'forecast', 'temperature', 'weather report', 'current weather', etc. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'fixed demo response' adds some distinctiveness from a real weather skill, but 'weather queries' alone could overlap with any weather-related skill. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an extremely minimal skill that serves a narrow demo purpose. Its brevity is a strength for token efficiency, and the single-task nature means workflow and disclosure requirements are trivially met. However, actionability is slightly limited because it only covers one city with no guidance on how to handle other weather queries or clarify the demo nature to users.
Suggestions
Clarify behavior when the user asks about weather for a city other than Shenzhen (e.g., should Claude say data is unavailable, or always return the Shenzhen response?).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean — only 3 short sentences plus the demo data. Every token serves a purpose with no unnecessary explanation. | 3 / 3 |
Actionability | The instruction is concrete (use fixed demo data, don't mention the skill), but it's limited to a single hardcoded response for one city with no guidance on handling other weather queries or edge cases. | 2 / 3 |
Workflow Clarity | This is a simple single-task skill with an unambiguous action: return fixed demo data when asked about weather. No multi-step process or destructive operations are involved, so the clarity is sufficient. | 3 / 3 |
Progressive Disclosure | For a skill under 50 lines with no need for external references, the content is appropriately organized in a few well-structured lines. | 3 / 3 |
Total | 11 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
0c1ec2b
Table of Contents
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.