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.

63

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/documentation/professional-communication/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

The body is highly actionable — templates, before/after examples, and jargon translations a model can use directly — with a clear before/during/after meeting sequence and a validation checklist. Its main weakness is token efficiency: generic writing lessons Claude already knows, an inconsistent date/version footer, and a ~290-line body that duplicates reference material, plus one orphaned bundle file that breaks navigation.

Suggestions

Cut the 'Writing Clarity Principles' section (active/passive voice, filler words) and 'Three Golden Rules' — these are writing fundamentals Claude already knows; keep only the skill-specific 'So What?' framing if anything.

Delete the 'Last Updated' / 'Version History' block (which is also internally inconsistent: 'Last Updated: 2025-12-22' vs 'v1.0.0 (2025-12-26)') — time-sensitive metadata penalizes conciseness and adds no capability.

Move 'Mindset' and 'Anti-Patterns' above the footer, add a pointer to the orphaned `references/remote-async-communication.md` (e.g., in the team-messaging or 'Additional Tools' section), and slim the inline email template now that `references/email-templates.md` exists.

DimensionReasoningScore

Conciseness

Several sections teach writing fundamentals Claude already knows — 'Active Voice Over Passive Voice' ('A bug was identified by the team' → 'The team identified a bug'), 'Eliminate Filler Words' ('At this point in time' → 'Now'), and 'Three Golden Rules' — which is padding, matching 'noticeably verbose; several unnecessary explanations or padded sections'. It cannot score 3 because the padding is compounded by time-sensitive information outside any deprecated section ('Last Updated: 2025-12-22', 'v1.0.0 (2025-12-26)') — dates the rubric explicitly says should penalize conciseness — plus a ~290-line body in a skill with four reference files.

2 / 5

Actionability

The body is dominated by concrete, copy-paste-ready artifacts: a full email structure template with bracketed placeholders, a meeting summary format with action-item syntax, before/after 'No Hello' chat examples, and a four-row jargon translation table — with common cases covered (status update, request, escalation, FYI). For an instruction-only skill this matches the 'fully executable; copy-paste ready; specific examples cover the common cases' anchor, and the minor abstract advice ('Read the room') doesn't drop it to 4 given the depth of concrete material.

5 / 5

Workflow Clarity

Processes are clearly sequenced — the meeting section runs Before (agenda elements) / During (facilitation) / After (summary format), and the closing eight-item checklist ('Clear purpose — Can the recipient understand intent in 5 seconds?') acts as an explicit pre-send validation checkpoint, matching 'clear sequence with most checkpoints present'. It is not a 5 because there is no end-to-end drafting workflow tying calibration → structure → checklist together, and no error-recovery/feedback loop; it is above 3 because checkpoints are explicit rather than implicit and the skill involves no destructive or batch operations requiring a cap.

4 / 5

Progressive Disclosure

References are well-signaled inline at the point of need ('**For templates**: See `references/email-templates.md`', '**For structures by meeting type**: See `references/meeting-structures.md`'), one level deep, and summarized in an 'Additional Tools' section — matching 'good structure; most content appropriately placed; references mostly clear'. It is not a 5 because the 305-line `references/remote-async-communication.md` bundle file is never referenced anywhere in the body (orphaned, undiscoverable), the inline email template duplicates content that lives in `references/email-templates.md`, and the 'Mindset' and 'Anti-Patterns' sections are stranded after the 'Version History' footer, separated by a horizontal rule.

4 / 5

Total

15

/

20

Passed

Description

83%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 that clearly states what the skill covers and gives an explicit, concrete 'Use when...' trigger clause. The main residual weaknesses are a generic opening verb and slightly thin natural-language trigger coverage (e.g., no mention of status updates or chat/Slack phrasing in the when-clause).

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — 'email structure, team messaging etiquette, meeting agendas, and adapting messages for technical vs non-technical audiences' — matching the 'several specific actions; minor gaps in coverage' anchor. It falls short of a 5 because the opening verb 'Guide technical communication' is generic and coverage of the listed sub-topics (e.g., status updates, reports, which appear in the body) is incomplete.

4 / 5

Completeness

It explicitly answers both questions: 'what' via 'Covers email structure, team messaging etiquette, meeting agendas, and adapting messages...' and 'when' via the concrete trigger clause 'Use when drafting professional messages, preparing meeting communications, or improving written communication.' This matches the top anchor's pattern of clear what + explicit when with concrete trigger phrases, parallel to the rubric's own good example ('Generate descriptive commit messages... Use when the user asks for help writing commit messages...').

5 / 5

Trigger Term Quality

Trigger phrases like 'drafting professional messages', 'preparing meeting communications' plus the topic terms 'email' and 'meeting agendas' give good natural keyword coverage, matching the 'good keyword coverage; a few natural terms missing' anchor. It is not a 5 because common user phrasings such as 'status update', 'chat/Slack message', or 'translate this for my manager' are absent from the trigger clause.

4 / 5

Distinctiveness Conflict Risk

The developer-communication niche (email structure, team chat etiquette, meeting agendas, audience adaptation) is mostly distinct with only minor overlap risk against closely related writing/feedback skills — matching the 'mostly distinct; minor overlap risk' anchor. It is not a 5 because the broad trigger 'improving written communication' could fire for general writing or documentation skills.

4 / 5

Total

17

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

Total

15

/

16

Passed

Repository
pantheon-org/tekhne
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.