remote
SSH tunnels, ngrok, and remote access management
54
43%
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/remote/SKILL.mdQuality
Discovery
22%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 lacks both concrete actions and explicit trigger guidance. While it names specific technologies (SSH tunnels, ngrok), it reads more like a topic label than a functional skill description. It needs verbs describing what the skill does and a 'Use when...' clause to guide skill selection.
Suggestions
Add concrete action verbs describing what the skill does, e.g., 'Sets up SSH tunnels, configures ngrok for exposing local services, and manages remote access connections.'
Add an explicit 'Use when...' clause with trigger scenarios, e.g., 'Use when the user needs to set up port forwarding, expose a local server, configure SSH tunnels, or troubleshoot remote access.'
Include additional natural trigger terms users might say, such as 'port forwarding', 'reverse tunnel', 'expose localhost', 'SSH config', or 'local server access'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names a domain (SSH tunnels, ngrok, remote access) but lists no concrete actions—no verbs describing what the skill actually does (e.g., 'create', 'configure', 'manage', 'troubleshoot'). | 1 / 3 |
Completeness | The description only loosely addresses 'what' (the domain) and completely lacks a 'when' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes some natural keywords users might say ('SSH tunnels', 'ngrok', 'remote access'), but misses common variations like 'port forwarding', 'reverse tunnel', 'expose localhost', 'SSH config', or 'tunnel setup'. | 2 / 3 |
Distinctiveness Conflict Risk | 'SSH tunnels' and 'ngrok' are fairly specific technologies that provide some distinctiveness, but 'remote access management' is broad and could overlap with general networking or sysadmin skills. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides comprehensive, actionable API reference material for tunnel management with good executable code examples and clear chat commands. However, it reads more like a complete API reference dumped into a single file rather than a well-structured skill — it lacks workflow sequencing with validation steps and could be more concise by splitting detailed API docs into a separate reference file. The best practices section is too generic and the content doesn't address error handling or verification workflows.
Suggestions
Add a validation/verification step after tunnel creation (e.g., check status, confirm URL is reachable) and include error recovery guidance for common failure modes
Split the detailed TypeScript API reference into a separate REFERENCE.md file and keep SKILL.md as a concise overview with quick-start examples and links
Remove or significantly trim the Best Practices section — items like 'close unused tunnels' and 'secure with auth' are obvious to Claude and waste tokens
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably structured but includes some unnecessary verbosity like console.log statements in every example, redundant comments, and the use cases section adds limited value. The tunnel types comparison table is useful, but the best practices section states obvious things Claude already knows. | 2 / 3 |
Actionability | The skill provides fully executable TypeScript code examples with concrete API calls, specific configuration options, and copy-paste ready chat commands. Each tunnel type has a complete, runnable example with all required parameters. | 3 / 3 |
Workflow Clarity | The skill covers individual operations well but lacks a clear sequential workflow for setting up and managing tunnels end-to-end. There are no validation checkpoints — for example, no guidance on verifying a tunnel is actually working after creation, no error recovery steps if tunnel creation fails, and no feedback loops for reconnection scenarios. | 2 / 3 |
Progressive Disclosure | The content is organized with clear sections and a comparison table, but it's a monolithic reference file (~150 lines of API details) that could benefit from splitting the full TypeScript API reference into a separate file while keeping the SKILL.md as a concise overview with chat commands and links to detailed references. | 2 / 3 |
Total | 9 / 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.