SSH tunnels, ngrok, and remote access management
65
51%
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.
This description is too terse and lacks actionable detail. While it identifies the technology domain (SSH, ngrok, remote access), it fails to describe what specific tasks can be accomplished and provides no guidance on when Claude should select this skill. The description reads more like a topic label than a functional skill description.
Suggestions
Add specific actions the skill enables, e.g., 'Create SSH tunnels for port forwarding, configure ngrok to expose local servers, troubleshoot remote connection issues'
Add a 'Use when...' clause with trigger scenarios like 'Use when the user needs to expose a local service, set up port forwarding, access remote servers securely, or mentions ngrok/SSH tunneling'
Include additional natural trigger terms users might say: 'port forwarding', 'expose localhost', 'tunnel to remote server', 'secure connection'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description only names technologies (SSH tunnels, ngrok) without describing any concrete actions. It doesn't specify what operations can be performed - no verbs like 'create', 'configure', 'manage', or 'troubleshoot'. | 1 / 3 |
Completeness | Only partially addresses 'what' (lists technologies but no actions) and completely missing 'when' - no 'Use when...' clause or explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes some relevant keywords users might say ('SSH tunnels', 'ngrok', 'remote access') but misses common variations like 'port forwarding', 'localhost tunnel', 'expose local server', 'reverse proxy', or 'secure connection'. | 2 / 3 |
Distinctiveness Conflict Risk | 'Remote access management' is fairly generic and could overlap with VPN skills, server administration, or general networking skills. However, 'SSH tunnels' and 'ngrok' are specific enough to provide some distinction. | 2 / 3 |
Total | 6 / 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-structured API reference with excellent actionability and conciseness. The code examples are complete and executable, and the content respects Claude's intelligence by not over-explaining concepts. However, it could benefit from explicit workflow guidance for common scenarios and better progressive disclosure by splitting the detailed API reference into a separate file.
Suggestions
Add a workflow section showing the complete flow: create tunnel → verify connectivity → use → close, with explicit validation checkpoints
Split the detailed TypeScript API Reference into a separate REFERENCE.md file, keeping SKILL.md as a quick-start overview with links to detailed docs
Add error handling examples showing what to do when tunnel creation fails or disconnects unexpectedly
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, presenting commands and code examples without explaining what SSH tunnels or ngrok are. Every section delivers actionable information without padding. | 3 / 3 |
Actionability | Provides fully executable TypeScript code examples with complete function signatures, configuration options, and copy-paste ready commands. Both chat commands and API usage are concrete and specific. | 3 / 3 |
Workflow Clarity | While individual operations are clear, there's no explicit workflow for common multi-step scenarios like setting up a tunnel with authentication, or validation steps to verify tunnel connectivity before use. The use cases section shows outcomes but not verification steps. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but everything is in one file. The API reference section is quite long and could be split into a separate REFERENCE.md, with SKILL.md serving as a quick-start overview pointing to detailed docs. | 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.