System health monitoring, alerts, and error tracking
68
56%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./src/skills/bundled/monitoring/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.
This description provides a basic overview of the skill's domain but lacks the specificity and explicit trigger guidance needed for effective skill selection. It names three high-level capabilities without concrete actions and completely omits a 'Use when...' clause, making it difficult for Claude to know when to select this skill over others.
Suggestions
Add a 'Use when...' clause with explicit triggers like 'Use when the user asks about system status, server health, application errors, log analysis, or monitoring dashboards'
Expand trigger terms to include natural variations: 'logs', 'metrics', 'uptime', 'crashes', 'server issues', 'performance problems'
Make capabilities more concrete: instead of 'monitoring', specify 'check CPU/memory usage, analyze application logs, configure alert thresholds'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (system health) and lists three actions (monitoring, alerts, error tracking), but these are somewhat generic and don't describe concrete specific actions like 'check CPU usage' or 'parse log files'. | 2 / 3 |
Completeness | Only addresses 'what' at a high level with no 'Use when...' clause or explicit trigger guidance. Missing any indication of when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Contains some relevant keywords ('health monitoring', 'alerts', 'error tracking') but misses common variations users might say like 'logs', 'metrics', 'uptime', 'crashes', 'debugging', or 'system status'. | 2 / 3 |
Distinctiveness Conflict Risk | 'Error tracking' could overlap with debugging or logging skills; 'alerts' is generic. The combination provides some distinctiveness but 'system health' is broad enough to potentially conflict with infrastructure or DevOps skills. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
79%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-written API reference with excellent actionability and conciseness - the code examples are complete and the content respects Claude's intelligence. However, it functions more as a reference document than a skill, lacking workflow guidance for common scenarios (initial setup, debugging alert delivery) and could benefit from progressive disclosure by splitting into focused sub-documents.
Suggestions
Add a 'Quick Start' workflow section showing the complete sequence: create service → configure targets → start monitoring → verify alerts are working
Include validation steps to confirm monitoring is functioning (e.g., 'Send a test alert to verify targets are configured correctly')
Split into separate files: keep SKILL.md as a concise overview with links to CHAT_COMMANDS.md, API_REFERENCE.md, and TROUBLESHOOTING.md
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, presenting commands and code without explaining what monitoring is or how TypeScript works. Every section delivers actionable information without padding. | 3 / 3 |
Actionability | Provides fully executable TypeScript code examples that are copy-paste ready, complete with imports, configuration objects, and concrete usage patterns. Chat commands are specific and complete. | 3 / 3 |
Workflow Clarity | While individual operations are clear, there's no explicit workflow for setting up monitoring end-to-end, no validation steps to confirm monitoring is working correctly, and no troubleshooting guidance if alerts aren't being received. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but this is a monolithic reference document (~200 lines) that could benefit from splitting into separate files (e.g., CHAT_COMMANDS.md, API_REFERENCE.md, BEST_PRACTICES.md) with a concise overview in the main skill. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
2a8c94e
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.