chat-customizations-editor

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

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%

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 lean, reference-grade internal skill: it conveys only knowledge Claude lacks, gives executable commands and copy-paste snippets, sequences multi-step work with explicit validation gates, and keeps external references one level deep with clear navigation. It performs at the top of every dimension.

Dimension	Reasoning	Score
Conciseness	The body is dense with codebase-specific operational knowledge Claude cannot know (file paths, interface names, IPC layer names, scrollbar fade timing) and avoids explaining basic concepts, so every token earns its place.	3 / 3
Actionability	It provides fully executable, copy-paste-ready guidance: exact bash and npx commands, TypeScript fixture snippets, fixture ID patterns, and a symptom-to-fix diagnostic table.	3 / 3
Workflow Clarity	Multi-step processes are sequenced with explicit checkpoints: the five-layer API sync chain, the three numbered prerequisites for built-in grouping, and the debugging diagnostic flow with an error-recovery table.	3 / 3
Progressive Disclosure	External material is referenced one level deep and clearly signaled ('See the component-fixtures skill', 'see the launch skill', 'See the sessions skill') with well-organized headed sections and navigation tables; no nested references exist.	3 / 3
	Total	12 / 12 Passed

Description

75%

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 has an explicit 'Use when...' trigger and a clear, distinctive niche, scoring well on completeness and distinctiveness. It is held back on specificity and trigger-term quality because it enumerates managed object types rather than concrete actions or varied natural phrasings.

Suggestions

Add concrete actions to the description (e.g., 'create, edit, remove, and configure agents, skills, hooks, prompts, MCP servers, and plugins') to raise specificity.

Broaden the trigger phrasing to cover how users actually phrase the need (e.g., 'Use when adding or removing an agent, configuring MCP servers, or managing plugins').

Dimension	Reasoning	Score
Specificity	It names the domain (management UI) and an exhaustive list of managed item types (agents, skills, instructions, hooks, prompts, MCP servers, plugins), but does not list concrete actions (create/edit/delete/sync), so it falls short of the 'multiple specific concrete actions' anchor.	2 / 3
Completeness	It explicitly answers both halves: 'Use when working on the Chat Customizations editor' gives the explicit when-trigger, and 'the management UI for agents, skills, instructions, hooks, prompts, MCP servers, and plugins' states what it does.	3 / 3
Trigger Term Quality	The trigger 'Chat Customizations editor' plus the item keywords are relevant and non-generic, but phrasing is anchored on the editor object rather than the varied ways users phrase the need (e.g. 'add an agent', 'configure an MCP server'), missing common variations.	2 / 3
Distinctiveness Conflict Risk	The named 'Chat Customizations editor' scoped to a specific management UI with a bounded item list is a distinct niche unlikely to trigger for unrelated skills.	3 / 3
	Total	10 / 12 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning

	Total	15 / 16 Passed

Repository: posit-dev/positron
Path: .github/skills/chat-customizations-editor/SKILL.md
Commit: b87c504

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.