Guide technical communication for software developers. Covers email structure, team messaging etiquette, meeting agendas, and adapting messages for technical vs non-technical audiences. Use when drafting professional messages, preparing meeting communications, or improving written communication.
86
81%
Does it follow best practices?
Impact
95%
1.04xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
77%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid description that clearly articulates specific capabilities and includes an explicit 'Use when' clause. The main weaknesses are moderate trigger term coverage (missing common user phrasings) and some overlap risk with general writing/communication skills. The developer-focused framing helps but could be more distinctive.
Suggestions
Add more natural trigger terms users would say, such as 'Slack', 'write an email', 'how to phrase', 'tone', 'PR description', or 'code review comments'
Strengthen distinctiveness by emphasizing the developer-specific context more explicitly in the 'Use when' clause, e.g., 'Use when developers need help with Slack messages, PR descriptions, or explaining technical concepts to stakeholders'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'email structure, team messaging etiquette, meeting agendas, and adapting messages for technical vs non-technical audiences' - these are distinct, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('email structure, team messaging etiquette, meeting agendas, adapting messages') AND when ('Use when drafting professional messages, preparing meeting communications, or improving written communication'). | 3 / 3 |
Trigger Term Quality | Includes some natural keywords like 'email', 'meeting agendas', 'professional messages', but missing common variations users might say like 'Slack message', 'write an email', 'communication tips', 'how to phrase', or 'tone'. | 2 / 3 |
Distinctiveness Conflict Risk | While it specifies 'technical communication for software developers', terms like 'professional messages' and 'written communication' are broad and could overlap with general writing or business communication skills. | 2 / 3 |
Total | 10 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured communication skill with strong actionability through concrete templates and examples. The progressive disclosure is excellent with clear references to supplementary materials. Main weakness is moderate verbosity - some sections explain concepts that could be assumed or trimmed, and the 'When to Use' section with keywords adds little value.
Suggestions
Remove the 'When to Use This Skill' section entirely - the skill title and overview already convey this, and keyword lists don't help Claude
Trim explanatory sentences like 'Effective communication isn't about proving how much you know' - Claude understands communication principles
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains useful frameworks but includes some unnecessary explanation (e.g., 'Effective communication isn't about proving how much you know'). The 'When to Use This Skill' section with keywords is padding. Tables and examples are helpful but could be tighter. | 2 / 3 |
Actionability | Provides concrete, copy-paste ready templates (email structure, meeting summary format), specific examples in tables, and clear before/after comparisons. The guidance is immediately usable without interpretation. | 3 / 3 |
Workflow Clarity | For an instruction-only skill about communication, the workflows are clear: What-Why-How framework, email structure template, meeting before/during/after sequence, and the final checklist provide unambiguous guidance. No destructive operations requiring validation loops. | 3 / 3 |
Progressive Disclosure | Well-organized with clear sections, appropriate use of tables for quick reference, and explicit one-level-deep references to supplementary files (email-templates.md, meeting-structures.md, jargon-simplification.md). Navigation is straightforward. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
3027f20
Table of Contents
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.