CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

chat-customizations-editor

Use when working on the Chat Customizations editor — the management UI for agents, skills, instructions, hooks, prompts, MCP servers, and plugins.

71

Quality

89%

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

The canonical home for this skill is chat-customizations-editor in microsoft/vscode

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.

An excellent engineering skill body: dense, codebase-specific, and fully executable, with explicit verification steps, CI regression gates, and a diagnostic feedback loop for layout debugging. It falls just short of top marks because detailed catalogs are inlined in a single long file rather than split into references, and validation checkpoints sit adjacent to rather than inside the workflows they guard.

Suggestions

Split catalog material into bundle references (e.g. references/fixtures.md for the fixture-ID catalog and per-type mock requirements) so SKILL.md stays a lean overview with well-signaled one-level-deep pointers.

Embed validation inline in each workflow — e.g. after 'update all five layers' add 'then run npm run typecheck-client && npm run valid-layers-check' — and add a verify step to the add-a-new-tab-fixture template.

DimensionReasoningScore

Conciseness

The body is uniformly dense and codebase-specific — folder paths, interface names, exact commands, and failure modes ('Without all three, built-in regrouping silently doesn't run') — with no explanation of concepts Claude already knows and no padded sections. Every section carries non-inferable product knowledge, matching the lean/efficient anchor.

5 / 5

Actionability

Guidance is copy-paste ready throughout: exact commands ('./scripts/test.sh --grep ...', 'npm run typecheck-client && npm run valid-layers-check'), full executable playwright eval snippets, a realistic fixture-creation code template, exact mock member names ('onDidChangeFeedback ... as Event.None'), and a symptom/root-cause/fix table covering the common layout bugs — matching the fully-executable anchor.

5 / 5

Workflow Clarity

Multi-step processes are clear and mostly validated: the five-layer sync table acts as a checklist with explicit verification ('verify both core and sessions registrations compile') and typecheck commands, and the layout-debugging flow is a genuine feedback loop (diagnostics, root-cause table, fix patterns). It stops short of anchor 5 because checkpoints sit beside rather than embedded within each workflow (typecheck lives in a separate Testing section) and sub-processes like adding a fixture lack a verify step — anchor 4's 'most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

Sections are well organized with clearly signaled one-level-deep pointers (the spec 'AI_CUSTOMIZATIONS.md — read for ownership and interface contracts', plus the component-fixtures, sessions, and launch skills). However, no bundle files exist and the ~190-line body inlines catalog material (the 11-row fixture-ID table, mock requirements, debugging cookbook) that could be split into reference files to keep SKILL.md closer to an overview — anchor 4's 'most content appropriately placed; minor organization gaps'.

4 / 5

Total

18

/

20

Passed

Description

86%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, concrete description: it names the exact feature, enumerates the full scope of managed item types, uses natural trigger vocabulary, and includes an explicit 'Use when' clause. The only gaps are the absence of explicit action verbs and a single-condition when-clause, which hold specificity and completeness just below top marks.

Suggestions

Add 1-2 explicit action verbs, e.g. 'Builds and debugs the Chat Customizations editor — the management UI for...' to strengthen specificity of capabilities.

Broaden the when-clause with user-mention trigger variants, e.g. '...or when the user mentions the customizations editor or its agent, skill, hook, or MCP server lists.'

DimensionReasoningScore

Specificity

The description identifies the exact feature ('the Chat Customizations editor') and enumerates its complete scope ('agents, skills, instructions, hooks, prompts, MCP servers, and plugins'), which is concrete and comprehensive. It falls short of anchor 5 and the full anchor 4 because it lists no explicit action verbs — only the generic 'management' / 'working on' — whereas anchor 4 requires 'several specific actions'.

4 / 5

Completeness

Both parts are explicit: the what ('the management UI for agents, skills, instructions, hooks, prompts, MCP servers, and plugins') and the when ('Use when working on the Chat Customizations editor'). It sits below anchor 5 because the when-clause is a single trigger condition, whereas the anchor-5 exemplar adds user-mention trigger variants ('or when the user mentions PDFs, forms...').

4 / 5

Trigger Term Quality

It contains the natural vocabulary a user would say when needing this skill: 'Chat Customizations editor', 'management UI', and all seven item names ('agents, skills, instructions, hooks, prompts, MCP servers, plugins'). File extensions are not applicable to a code-area skill, and no relevant natural synonyms are missing, matching the comprehensive anchor.

5 / 5

Distinctiveness Conflict Risk

The description is anchored to a uniquely named feature ('the Chat Customizations editor'), giving it a clear niche with minimal conflict risk. The broad item-type words (skills, prompts, agents) are subordinated to the specific editor context rather than standing alone as generic triggers.

5 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

posit-dev/positron

Path

.github/skills/chat-customizations-editor/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.