CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mcp-startup-triage

Diagnose and classify MCP and Local Memory startup failures in this repo. Use this skill when codex mcp list, Codex startup, hook startup, mise trust, or Local Memory listener checks fail.

Quality

85%

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

85%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 well-structured instruction-only triage skill: concrete commands, a sequenced workflow with fail-fast validation and recovery guidance, and clean one-level-deep reference signaling to real bundle files. The one notable cost is token padding — the Table of Contents, Overview, and Philosophy sections restate other content and could be cut without losing anything.

Suggestions

Remove the 11-line Table of Contents and the Philosophy section; both restate the section list and the Workflow/Constraints content, trimming the body by roughly 15-20%.

Drop or merge the Overview section into 'When to use', since it duplicates the frontmatter description and the taxonomy summary already covered by references/failure-taxonomy.md.

DimensionReasoningScore

Conciseness

The operational sections are lean, but roughly a fifth of the body could be trimmed: the 11-line Table of Contents adds navigation tokens with no new information, the Overview restates the frontmatter description, and the Philosophy section ('Separate symptom from cause', 'Preserve operator trust by avoiding speculative config edits') repeats the Workflow and Constraints sections. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trimmings anchor at 4.

3 / 5

Actionability

The guidance is fully executable and copy-paste ready: exact commands ('bash scripts/codex-preflight.sh --repo-fragment local-memory --mode optional', 'codex mcp list', 'lsof -nP -iTCP:3002'), exact error strings to match ('connection closed: initialize response', 'No version is set for shim'), a concrete default repo root, and real referenced files (failure-taxonomy.md, contract.yaml, evals.yaml all exist). The Examples cover the common requests, matching the anchor for fully executable coverage rather than the minor-gaps anchor at 4.

5 / 5

Workflow Clarity

The five-step Workflow is clearly sequenced, the Validation section adds an explicit fail-fast feedback loop ('stop at the first failed gate and fix it before continuing') with three concrete gate commands, and the Failure mode section gives error-recovery behavior when classification is ambiguous (report competing hypotheses instead of speculative edits). This matches the anchor for explicit validation steps plus feedback loops; nothing is missing that would drop it to 4.

5 / 5

Progressive Disclosure

The body is a concise overview that delegates detail to three real, one-level-deep bundle files, each well-signaled with a 'Read when:' condition (failure-taxonomy.md for classification, contract.yaml for the machine-checkable contract, evals.yaml for routing/pressure-test cases), and the taxonomy file is also linked inline at the point of use. Verified bundle files contain no nested second-level references, matching the anchor for a clear overview with well-signaled one-level-deep references.

5 / 5

Total

18

/

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: it explicitly covers what and when with concrete, tool-specific trigger phrases in third person. Its only weaknesses are modest action coverage (just 'diagnose and classify') and a few natural trigger terms (error strings like 'initialize response') that live only in the body.

Suggestions

Expand the capability list in the description to name the distinct failure surfaces it separates, e.g., 'separates path drift, mise trust, handshake, auth, and Local Memory listener failures' to raise specificity.

Add the most recognizable user-facing error strings ('initialize response', 'port 3002', 'No version is set for shim') to the trigger clause so natural phrasings that only mention symptoms also match.

DimensionReasoningScore

Specificity

The description states 'Diagnose and classify MCP and Local Memory startup failures in this repo' — it names the domain clearly and gives exactly two concrete actions (diagnose, classify), matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list several specific actions (e.g., separating handshake, auth, trust, and listener failures), so it is not a 4.

3 / 5

Completeness

It explicitly answers both questions: what it does ('Diagnose and classify MCP and Local Memory startup failures in this repo') and when to use it ('Use this skill when codex mcp list, Codex startup, hook startup, mise trust, or Local Memory listener checks fail') with concrete trigger phrases — a clear anchor-5 match. Voice is third person, so no penalty applies.

5 / 5

Trigger Term Quality

Concrete trigger phrases are present: 'codex mcp list, Codex startup, hook startup, mise trust, or Local Memory listener checks fail' — natural terms an operator would say. A few natural terms users might emit are missing (e.g., the error strings 'initialize response', 'No version is set for shim', or port 3002, which appear only in the body), so it falls short of comprehensive synonym coverage at 5.

4 / 5

Distinctiveness Conflict Risk

The niche is highly specific — MCP and Local Memory startup failures gated on named tools (codex mcp list, mise trust, Local Memory listener) — giving distinct triggers with minimal overlap risk against generic debugging or config skills. It does not drift into broad territory that a 4-anchor ('minor overlap risk with closely related skills') would describe.

5 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

13

/

16

Passed

Repository

jscraik/diagram-cli

Path

.codex/skills/mcp-startup-triage/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.