CtrlK
BlogDocsLog inGet started
Tessl Logo

run-llms

Comprehensive guide for setting up and running local LLMs using Harbor. Use when user wants to run LLMs locally, set up or troubleshoot Ollama, Open WebUI, llama.cpp, vLLM, SearXNG, Open Terminal, or similar local AI services. Covers full setup from Docker prerequisites through running models, per-service configuration, VRAM optimization, GPU troubleshooting, web search integration, code execution, profiles, tunnels, and advanced features. Includes decision trees for autonomous agent workflows and step-by-step troubleshooting playbooks.

72

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Critical

Do not install without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

The body is highly actionable with well-sequenced, validated workflows and explicit agent-safety callouts (e.g. the harbor-logs-tails warning). Its weaknesses are token efficiency and progressive disclosure: it is a very long monolithic document with duplicated config/troubleshooting material that would benefit from being split into referenced files.

Suggestions

Move per-service CLI references, config tables, and the consolidated environment-variable table into separate one-level-deep reference files (e.g. references/ollama.md, references/vllm.md) and keep SKILL.md as a concise overview with signaled links, improving both progressive_disclosure and conciseness.

De-duplicate configuration data: the environment variables appear in both per-service 'Configuration' tables and the trailing 'Environment Variable Quick Reference' — keep only one location and cross-reference it.

Consolidate troubleshooting so each failure mode lives in one place (the playbooks) rather than being restated in the decision trees, per-service sections, and Common Workflows; have the other sections link to the playbook.

DimensionReasoningScore

Conciseness

The body is almost entirely actionable commands with no concept padding, but it is ~1300 lines with notable redundancy — the environment-variable tables appear both in per-service config sections and again verbatim in the bottom 'Environment Variable Quick Reference', and troubleshooting content repeats across decision trees, per-service sections, playbooks, and common workflows. Not a 1 because it avoids explaining things Claude already knows; not a 3 because the duplication and length could be tightened substantially.

2 / 3

Actionability

Throughout, guidance is concrete and copy-paste ready — e.g. 'harbor pull qwen3:4b && harbor up', 'harbor vllm args --max-model-len 4096', and explicit curl calls for the router API — matching the 'fully executable code/commands' anchor.

3 / 3

Workflow Clarity

Multi-step processes are clearly sequenced with explicit validation checkpoints: decision trees branch on FAIL/OK, setup waits for 'Healthy' output, vLLM startup waits for 'Application startup complete', and troubleshooting playbooks are numbered with verify-then-fix feedback loops (e.g. 'docker logs harbor.<service>' → apply fix → 'harbor restart').

3 / 3

Progressive Disclosure

The skill is a single ~1300-line monolithic SKILL.md with no bundle files and no references split out — per-service CLI lists, config tables, and env-var references that belong in separate one-level-deep files are all inline. It is well-organized with clear headers (better than the score-1 wall of text) but matches the score-2 anchor where 'content that should be separate is inline'; the under-50-line simple-skill exception does not apply.

2 / 3

Total

10

/

12

Passed

Description

100%

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 specific, trigger-rich, and complete, naming concrete capabilities and an explicit 'Use when' clause tied to tools users actually mention. Voice is appropriately third person with no over-claims. It is a strong, low-conflict skill description.

DimensionReasoningScore

Specificity

Names many concrete actions ("setting up and running local LLMs", "per-service configuration", "VRAM optimization", "GPU troubleshooting", "profiles, tunnels") rather than vague language, matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

Explicitly answers both what (Harbor-based local LLM setup covering Docker through advanced features) and when via an explicit "Use when user wants to run LLMs locally..." trigger clause, satisfying the 'clearly answers both what AND when' anchor.

3 / 3

Trigger Term Quality

Covers natural user-facing terms ("run LLMs locally", "Ollama", "Open WebUI", "llama.cpp", "vLLM", "SearXNG", "Open Terminal") that a user would actually say, matching the 'good coverage of natural terms' anchor.

3 / 3

Distinctiveness Conflict Risk

A clear niche (Harbor / local LLM infrastructure) anchored by named tools and specific triggers makes it unlikely to fire for unrelated skills; the trailing "or similar local AI services" adds minor breadth but does not meaningfully raise conflict risk.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1322 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
av/harbor
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.