monitoring
System health monitoring, alerts, and error tracking
55
45%
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.
The description is too terse and high-level, reading more like a category label than a functional skill description. It lacks explicit trigger guidance ('Use when...'), concrete actions, and natural keyword variations that would help Claude reliably select this skill from a large pool. The domain is identifiable but insufficiently detailed for disambiguation.
Suggestions
Add an explicit 'Use when...' clause with trigger scenarios, e.g., 'Use when the user asks about server health, uptime checks, error logs, alerting rules, or system metrics.'
List specific concrete actions the skill performs, e.g., 'Checks CPU/memory/disk usage, parses error logs, configures alert thresholds, tracks error rates and patterns.'
Include natural keyword variations users might say, such as 'logs', 'metrics', 'uptime', 'server status', 'incidents', 'observability', 'dashboards'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (system health) and some actions (monitoring, alerts, error tracking), but these are fairly high-level and don't list concrete specific actions like 'check CPU usage', 'parse log files', or 'configure alert thresholds'. | 2 / 3 |
Completeness | Describes what the skill does at a high level but completely lacks any 'Use when...' clause or explicit trigger guidance, which per the rubric caps completeness at 2, and the 'what' is also quite weak, so this falls to 1. | 1 / 3 |
Trigger Term Quality | Includes some relevant keywords like 'health monitoring', 'alerts', and 'error tracking' that users might say, but misses common variations like 'logs', 'uptime', 'metrics', 'dashboards', 'incidents', 'CPU', 'memory', 'disk space', or 'observability'. | 2 / 3 |
Distinctiveness Conflict Risk | Somewhat specific to system health and monitoring, but 'alerts' and 'error tracking' could overlap with logging skills, incident management skills, or general DevOps skills. Not generic enough to be a 1, but not clearly carved out either. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a comprehensive and actionable API reference for a monitoring service with concrete, executable TypeScript examples and clear chat commands. However, it suffers from being a monolithic document that would benefit from progressive disclosure, and it lacks workflow guidance for responding to alerts or troubleshooting degraded states. The best practices section adds little value for Claude.
Suggestions
Split the detailed TypeScript API reference into a separate REFERENCE.md file, keeping only a quick-start example and chat command summary in SKILL.md
Add a troubleshooting/response workflow: when an alert fires, what steps should be taken to diagnose and resolve the issue (with validation checkpoints)
Remove the 'Best Practices' section - these are generic monitoring principles Claude already knows, not actionable skill-specific guidance
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient with concrete code examples, but includes some unnecessary verbosity like extensive console.log formatting patterns and the 'Best Practices' section with generic advice Claude already knows (e.g., 'avoid alert fatigue', 'prevent alert spam'). The health check example with all the console.log statements is more verbose than needed. | 2 / 3 |
Actionability | The skill provides fully executable TypeScript code examples with concrete configuration objects, method calls, and event handlers. Chat commands are specific and copy-paste ready. The API surface is well-documented with real types and return values. | 3 / 3 |
Workflow Clarity | The content is organized as an API reference rather than a workflow, which is appropriate for its purpose. However, there's no guidance on what to do when alerts fire, no error recovery workflow, and no validation steps for configuration changes. For a monitoring skill, a troubleshooting/response workflow would be valuable. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of API reference content (~180 lines) with no references to external files. The chat commands, TypeScript API, alert types, configuration, and best practices are all inlined. The API reference sections could be split into separate files with the SKILL.md serving as a concise overview. | 1 / 3 |
Total | 8 / 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 | |
- Repository
- alsk1992/CloddsBot
- Commit
e71a5f6
- 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.