CtrlK
BlogDocsLog inGet started
Tessl Logo

professional-communication

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

1.04x
Quality

81%

Does it follow best practices?

Impact

95%

1.04x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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'

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

10

/

11

Passed

Repository
softaworks/agent-toolkit
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.