CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 with ready-to-use templates, checklists, and dev-contextualized examples, and its reference structure is sound. It loses points on efficiency — it re-explains generic writing principles Claude already knows and duplicates frontmatter content — and it fails to surface one of its four bundled reference files.

Suggestions

Cut or compress sections teaching concepts Claude already knows (active-vs-passive table, filler-word substitutions, "So What?" test) down to one-line reminders, and drop the keyword list and "When to Use" section that duplicate the frontmatter description.

Reference references/remote-async-communication.md from the body (e.g., in Team Messaging Etiquette or Additional Tools) so the whole bundle is discoverable.

Reconcile the stale metadata — "Last Updated: 2025-12-22" vs "v1.0.0 (2025-12-26)" — and consolidate the trailing Mindset/Anti-Patterns sections, which restate principles already covered earlier in the body.

DimensionReasoningScore

Conciseness

The body spends lines on concepts Claude already knows (the active-vs-passive table, the filler-word substitutions, the "So What?" test), the "When to Use This Skill" section and keyword list duplicate the frontmatter, and the trailing Mindset/Anti-Patterns sections restate earlier principles. Mostly efficient with some removable padding, so it sits at the midpoint anchor rather than clearly below it.

3 / 5

Actionability

Guidance is copy-paste ready: the email structure template, the meeting summary template, subject-line formulas, before/during/after meeting guidance, the "No Hello" chat example, and a pre-send checklist cover the common communication cases. The few abstract bits ("read the room") are a small fraction, so this matches the fully executable anchor rather than the minor-gaps anchor.

5 / 5

Workflow Clarity

The meeting workflow is clearly sequenced (before/during/after) and the Quick Reference checklist functions as pre-send validation, but the checklist is never wired into an explicit draft-to-check-to-send loop. This is a clear sequence with most checkpoints present and minor validation gaps, not the full feedback-loop anchor.

4 / 5

Progressive Disclosure

The three cited references (email-templates.md, jargon-simplification.md, meeting-structures.md) all exist, are one level deep, and are clearly signaled both inline and in the Additional Tools section. However, the bundled references/remote-async-communication.md is never mentioned anywhere in the body — an organization gap that keeps this below the well-split top anchor.

4 / 5

Total

16

/

20

Passed

Description

88%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 follows the what-and-when pattern with third-person voice and concrete capability areas. Its main weakness is trigger vocabulary: it omits the natural nouns users would actually say (email, Slack, agenda, status update), which slightly limits both discoverability and distinctiveness.

DimensionReasoningScore

Specificity

The description names four concrete capability areas — "email structure, team messaging etiquette, meeting agendas, and adapting messages for technical vs non-technical audiences" — comprehensive coverage of the skill's scope with no significant gaps, matching the top anchor. It is not 4 because the action list spans the full domain rather than leaving minor coverage gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the four stated coverage areas, and the "when" is a concrete "Use when..." clause with specific trigger phrases. It is not 4 because the when-clause is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

Triggers like "drafting professional messages, preparing meeting communications, or improving written communication" are natural, but common user phrasings such as "email", "Slack/message", "status update", and "agenda" are missing. It is not 5 because synonym and platform-specific term coverage is incomplete.

4 / 5

Distinctiveness Conflict Risk

"Technical communication for software developers" carves a mostly distinct niche with dev-contextualized triggers, but generic tail phrases like "improving written communication" leave minor overlap risk with general writing or feedback skills. It is not 5 due to that residual overlap, and not 3 because the domain and triggers are clearly targeted.

4 / 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

allowed_tools_field

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

Warning

Total

15

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/documentation/professional-communication/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.