CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-oss-logs

Find and read timestamped process logs from Code OSS dev builds, including main.log, renderer.log, extension host logs, and agenthost.log. For bundles produced by Export Agent Host Debug Logs, use agent-host-logs.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

90%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 body is a dense, high-signal reference: every section delivers repo-specific knowledge (log locations, directory semantics, probe-routing rules) with executable commands and a clear procedure. The only gaps are minor — no explicit validation checkpoint in the main procedure and a specialized cloud-sandbox section that could be split into a reference file.

DimensionReasoningScore

Conciseness

Nearly every token carries environment-specific knowledge Claude cannot know elsewhere (log root defaults per launch type, reload-vs-session timestamp semantics, the lint-hostile Boolean("true") flag, which log captures console probes per process); it never explains generic concepts, with only a trivial redundancy ("Do not check in this flag enabled" duplicating the code comment and step 6).

5 / 5

Actionability

Commands are copy-paste ready with appropriate placeholders (ls -lt "<user-data-dir>/logs" | head -5, rg -n "MY_PROBE|error" "<timestamp>", find "<timestamp>" -type f -size +0), the forwarding workflow names the exact file (src/vs/platform/log/common/log.ts) and code to change, and the use-case table maps concrete investigations to specific files.

5 / 5

Workflow Clarity

The 4-step Procedure is clearly sequenced with an implicit checkpoint ("The most recent folder sorted by modification time is usually the one the user cares about"), and the forwarding workflow ends with an explicit restore step, but the main procedure lacks a verify-you-found-the-right-run/session checkpoint, so it matches anchor 4 rather than the explicit validation loops of anchor 5.

4 / 5

Progressive Disclosure

With no bundle files, everything lives in a single SKILL.md that is well organized (root-dir table, directory tree, use-case table, commands, tips); at ~135 lines it exceeds the under-50-line simple-skill exception, and the specialized Cloud Sandbox Startup Failures deep-dive is niche enough that it could arguably live in a reference file, which is a minor organization gap.

4 / 5

Total

18

/

20

Passed

Description

70%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 specific, well-disambiguated description that clearly states what the skill does and names the concrete log files involved, but it lacks an explicit 'Use when...' trigger clause, which both caps completeness and leaves some natural trigger contexts uncovered. Adding trigger guidance would move it into the top tier.

Suggestions

Add an explicit 'Use when...' clause, e.g. "Use when debugging a Code OSS or Agents app dev run, or when the user mentions dev logs, renderer.log, agenthost.log, or a startup/extension/terminal failure."

Include common investigation contexts as trigger terms (startup failures, crashes, extension issues, Copilot/agent problems, MCP servers) so the skill fires when users describe symptoms rather than naming log files.

Consider naming one or two more actions beyond find/read (e.g. filtering with rg, correlating IDs across log files) to reflect the skill's full capability set.

DimensionReasoningScore

Specificity

"Find and read timestamped process logs from Code OSS dev builds" names two concrete actions and enumerates specific artifacts ("main.log, renderer.log, extension host logs, and agenthost.log"), which is more concrete than the anchor-3 example but stops short of the comprehensive multi-action coverage of anchor 5.

4 / 5

Completeness

The "what" is clear ("Find and read timestamped process logs from Code OSS dev builds"), but there is no "Use when..." clause; the second sentence ("For bundles produced by Export Agent Host Debug Logs, use agent-host-logs") is a disambiguation redirect, not a usage trigger, so the rubric's cap of 3 for a missing explicit trigger applies.

3 / 5

Trigger Term Quality

Natural terms a user would say are present — "Code OSS", "dev builds", and the exact log filenames (main.log, renderer.log, agenthost.log) — but common trigger contexts like "startup failure", "crash", or "Copilot/agent issues" are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous ("Code OSS dev builds" log files) and the description actively disambiguates from the sibling skill ("use agent-host-logs"), giving it distinct triggers with minimal conflict risk.

5 / 5

Total

16

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

microsoft/vscode

Path

.github/skills/code-oss-logs/SKILL.md

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.