Tessl • The management layer for AI agent skills

Blog Docs Log inGet started

SkillPublic

remote

SSH tunnels, ngrok, and remote access management

Quality

59%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./src/skills/bundled/remote/SKILL.md

Quality

Content

61%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is well-organized and highly actionable as an API reference, but it is a monolithic single file with no progressive disclosure and lacks validation checkpoints around destructive tunnel operations. Splitting the API reference into reference files and adding verify steps would raise the weaker dimensions.

Suggestions

Move the full TypeScript API reference into a separate REFERENCES.md and keep SKILL.md as a concise overview with a one-level-deep pointer.

Add an explicit validate-then-close step for /remote close-all and /remote close <id> (e.g. list and confirm before closing).

Fix the SSH key example to expand '~' (e.g. use os.homedir()) so the snippet is truly copy-paste runnable.

Dimension	Reasoning	Score
Conciseness	The body is a lean API reference with section headers, code blocks, a comparison table, and best practices, with almost no concept-explanation padding; minor trimming/file-splitting could take it to 5.	4 / 5
Actionability	It provides concrete, copy-paste-ready TypeScript snippets and chat commands covering create/list/status/close events across tunnel types, with only small gaps (e.g. fs.readFileSync on a '~' path won't expand).	4 / 5
Workflow Clarity	This is a reference catalog rather than a sequenced workflow, and destructive/batch operations like /remote close-all have no validate-before-act checkpoint, so workflow clarity is capped at 3 per the destructive-operation rule.	3 / 5
Progressive Disclosure	No bundle files exist and the entire 'Complete API Reference' is inlined in SKILL.md with no references to separate files, matching the 'content that clearly belongs in separate files is inlined' anchor despite decent section headers.	2 / 5
	Total	13 / 20 Passed

Description

40%Weight 40%Scale 1-5

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 identifies a clear niche but is too terse: it states a domain with a generic verb and omits any explicit 'when to use' trigger guidance. Adding concrete actions and a Use-when clause would lift specificity and completeness.

Suggestions

Add concrete actions, e.g. 'Create and manage SSH tunnels, ngrok, Cloudflare, and localtunnel exposures, plus port forwarding.'

Append an explicit trigger clause, e.g. 'Use when exposing a local port, setting up a tunnel, or forwarding ports remotely.'

Include common synonyms users say (port forwarding, expose port, Cloudflare tunnel) to improve trigger-term coverage.

Dimension	Reasoning	Score
Specificity	The description names the domain ('SSH tunnels, ngrok, and remote access management') but offers only the generic action word 'management' rather than concrete operations like creating or closing tunnels, matching the 'names domain but actions are minimal/generic' anchor.	2 / 5
Completeness	It gives only a vague 'what' and no 'when'/Use-when trigger clause, matching the 'vague what and no when' anchor; the explicit-trigger guideline also caps completeness at 3, and this falls below that.	2 / 5
Trigger Term Quality	It includes natural terms a user would say ('SSH tunnels', 'ngrok', 'remote access') but misses common variations and synonyms such as port forwarding, exposing a port, Cloudflare, or webhooks.	3 / 5
Distinctiveness Conflict Risk	The SSH/ngrok/remote-access niche is mostly distinct with only minor overlap risk against adjacent networking skills, though it lacks explicit trigger phrases that would push it to 5.	4 / 5
	Total	11 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: alsk1992/CloddsBot
Path: src/skills/bundled/remote/SKILL.md
Revision: c930628

Reviewed: 1 month ago

Discovery Implementation Validation

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.

remote

Table of Contents

Is this your skill?