CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-host-logs

Analyze Agent Host debug log exports. Use when given an ah-logs or ahp-logs zip/folder, an Export Agent Host Debug Logs bundle, events.jsonl, AHP JSONL transport logs, Agent Host.log, remote-agenthost.log, or copilot-logs.

Quality

96%

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

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

An unusually dense, high-signal body: it assumes Claude's competence, teaches only non-obvious product behavior, and provides an executable extractor plus a concrete symptom-driven investigation workflow with explicit correlation keys and false-conclusion guards. The only structural improvement available is moving the deep-dive material into reference files to slim the main body.

Suggestions

Move the 'Copilot Session Refresh Failures' deep dive into a references/ file (e.g. references/refresh-failures.md) and keep a two-line pointer plus the most common symptom in SKILL.md, slimming the always-loaded body.

Consider splitting the 'What the Files Mean' table into a references/files.md cheat sheet if the skill grows, keeping the symptom-to-file decision list inline in 'How to Start'.

DimensionReasoningScore

Conciseness

Every section carries product-specific, non-inferable facts (ephemeral SDK events, '.1.jsonl' rotation, the ten-file/750 MiB retention limit, UTC vs. local timestamps, '_ahpLog.truncated') with no explanation of general concepts and no padding. Each token earns its place.

5 / 5

Actionability

Gives an executable command ('python3 .github/skills/agent-host-logs/scripts/extract.py "<archive>.zip"' — the script is present in the bundle), a symptom-to-file decision list, concrete correlation fields (turnId, interactionId, serverSeq, event id/parentId), and step-by-step nested host-logs.zip handling. The guidance is fully executable for an instruction-only skill.

5 / 5

Workflow Clarity

'How to Start' is a clear four-step sequence with a symptom-to-file decision table and an explicit iterate loop ('follow the same operation into the adjacent layer'), and verification guards are stated ('Warning or error severity alone does not prove causality. Look for the matching failed response...', 'correlate these with the SDK process log before concluding'). The only destructive act is safety-scoped ('delete only that exact folder when finished').

5 / 5

Progressive Disclosure

Sections are well organized and the single bundle file (scripts/extract.py) is clearly signaled and real, but at roughly 95 lines everything is inline: the file-meanings table and the 'Copilot Session Refresh Failures' deep dive are sizable chunks that could live in one-level-deep reference files. This is a minor organization gap between anchors 4 and 5, not a structural problem.

4 / 5

Total

19

/

20

Passed

Description

95%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 tight, exemplary description: it states one clear capability and pairs it with an explicit 'Use when' clause enumerating every concrete artifact name, command name, and file extension a user would encounter. The only limitation is that the action side rests on a single verb rather than a broader action list.

DimensionReasoningScore

Specificity

Only one capability verb is stated ("Analyze Agent Host debug log exports"), which alone matches anchor 3, but the enumeration of exact artifacts ("events.jsonl", "AHP JSONL transport logs", "Agent Host.log", "remote-agenthost.log", "copilot-logs") makes the scope concrete at the file level, placing it noticeably above the midpoint. Not 5 because the action list itself is not comprehensive.

4 / 5

Completeness

Explicitly answers both: what ("Analyze Agent Host debug log exports") and when ("Use when given an ah-logs or ahp-logs zip/folder, an Export Agent Host Debug Logs bundle, events.jsonl, ..."), with concrete trigger phrases throughout.

5 / 5

Trigger Term Quality

Covers the export name prefixes ("ah-logs or ahp-logs zip/folder"), the exact command name ("Export Agent Host Debug Logs bundle"), and precise file names and extensions (events.jsonl, Agent Host.log, remote-agenthost.log, copilot-logs) with synonyms (zip/folder, bundle) — these are exactly the terms a user holding such a bundle would say.

5 / 5

Distinctiveness Conflict Risk

The trigger terms are niche, product-specific artifact names (ahp-logs, remote-agenthost.log, copilot-logs) that no other generic log- or document-analysis skill would claim, giving a clear niche with minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

microsoft/vscode

Path

.github/skills/agent-host-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.