CtrlK
BlogDocsLog inGet started
Tessl Logo

borg-live-debug

Live Borg debugging by exec-ing into the borg-web-ui Docker container. Use when debugging borg commands, writing tests against real borg output, developing borg 2.0 features, or verifying borg behavior before writing code.

68

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

A highly actionable, well-structured operational skill: nearly everything is executable, copy-paste-ready command guidance with a sensible debug-first workflow. The main improvements are trimming redundant table rows and rule restatements, and adding basic error-recovery guidance for failed borg commands.

DimensionReasoningScore

Conciseness

The body is dominated by executable commands, a dense comparison table, and env-var specifics with almost no explanation of concepts Claude already knows. It falls short of anchor 5 because of padding: the borg1/borg2 table repeats identical mappings (create, extract, prune, check, mount) where only rcreate/rdelete/compact differ, and the Rules section restates advice already given inline (e.g., capture stderr, use --json).

4 / 5

Actionability

Every section provides copy-paste-ready commands with concrete container names, user flags, env vars, and paths — including a complete throwaway-repo recipe for both borg and borg2, JSON output examples, and an executable Python snippet against the live app. This matches the anchor-5 'fully executable, specific examples cover the common cases' example.

5 / 5

Workflow Clarity

Steps 1-4 give a clear, headed sequence with a precondition checkpoint (verify the container is running before anything else). It is not anchor 5 because there are no error-recovery feedback loops — no guidance for what to do when a command fails (passphrase errors, missing repo, permission issues) — but it is above anchor 3 since the sequence is explicit with a real validation checkpoint, and the only destructive operation (rm -rf cleanup) is narrowly scoped to /tmp test repos with a stated rule.

4 / 5

Progressive Disclosure

No bundle files exist, and the single SKILL.md is well-organized with clear, well-signaled sections and no nested references. It is not anchor 5 (the skill exceeds 50 lines and the borg1/borg2 cheat sheet plus env-var reference are API-style content that could live in a reference file), and not anchor 3 because nothing is buried and structure is clean throughout.

4 / 5

Total

17

/

20

Passed

Description

82%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.

A strong description with an explicit and multi-condition 'Use when...' clause, a concrete named mechanism, and a clearly delineated niche. Its main weakness is thin action coverage (one mechanism rather than several concrete capabilities) and missing natural domain synonyms like 'backup', 'archive', or 'repository'.

Suggestions

Enumerate 2-3 more concrete capabilities in the 'what' portion (e.g., 'run borg/borg2 commands, inspect real output, create throwaway test repos') to lift specificity beyond a single action.

Add natural user vocabulary such as 'backup', 'archive', 'repository', or 'restore' to the trigger clause so users who ask in backup-domain terms rather than 'borg commands' still match.

Consider naming the docker/borg2 context in the 'what' clause even more precisely (e.g., mention borg2 rcreate/rinfo command differences) to sharpen distinctiveness from generic Docker-debugging skills.

DimensionReasoningScore

Specificity

The description names one concrete action — 'exec-ing into the borg-web-ui Docker container' — but does not list several distinct capabilities (running commands, inspecting output, creating test repos are only implied), matching the 'names domain and 1-2 concrete actions' anchor. It is above anchor 2 because the named action is specific (a named container and mechanism), not generic.

3 / 5

Completeness

It explicitly answers both questions: the 'what' is 'Live Borg debugging by exec-ing into the borg-web-ui Docker container' and the 'when' is a fully explicit 'Use when...' clause listing four concrete trigger conditions. This matches the anchor-5 example structure precisely; it is not anchor 4 because the 'when' needs no further specificity.

5 / 5

Trigger Term Quality

Natural phrases like 'debugging borg commands', 'writing tests against real borg output', and 'developing borg 2.0 features' give good coverage across debugging, testing, and development scenarios. It falls short of anchor 5 because common user terms for this domain — 'backup', 'archive', 'repository', 'restore' — are absent.

4 / 5

Distinctiveness Conflict Risk

The description targets a clear niche — the named 'borg-web-ui' container and 'borg 2.0' features — with distinct triggers that would not plausibly fire for other skills. Minimal conflict risk, matching anchor 5.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository
karanhudia/borg-ui
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.