CtrlK
BlogDocsLog inGet started
Tessl Logo

teams-channel-post-writer

Creates educational Teams channel posts for internal knowledge sharing about Claude Code features, tools, and best practices. Applies when writing posts, announcements, or documentation to teach colleagues effective Claude Code usage, announce new features, share productivity tips, or document lessons learned. Provides templates, writing guidelines, and structured approaches emphasizing concrete examples, underlying principles, and connections to best practices like context engineering. Activates for content involving Teams posts, channel announcements, feature documentation, or tip sharing.

77

1.62x
Quality

67%

Does it follow best practices?

Impact

91%

1.62x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./teams-channel-post-writer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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 strong, well-crafted description that clearly defines a specific niche (educational Teams channel posts about Claude Code), lists concrete actions and deliverables, and provides explicit trigger conditions. It uses proper third-person voice throughout and includes natural keywords that users would employ when needing this skill. The description effectively distinguishes itself from generic writing or documentation skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: creating educational Teams channel posts, writing announcements, documentation, providing templates, writing guidelines, and structured approaches. Also specifies the domain clearly (Claude Code features, tools, best practices).

3 / 3

Completeness

Clearly answers both 'what' (creates educational Teams channel posts, provides templates and writing guidelines for Claude Code knowledge sharing) and 'when' with explicit triggers ('Applies when writing posts, announcements...', 'Activates for content involving Teams posts, channel announcements, feature documentation, or tip sharing').

3 / 3

Trigger Term Quality

Includes strong natural trigger terms users would say: 'Teams channel posts', 'announcements', 'knowledge sharing', 'productivity tips', 'feature documentation', 'tip sharing', 'lessons learned', 'Claude Code'. Good coverage of variations.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche combining Teams channel posts specifically for Claude Code internal knowledge sharing. The intersection of Teams posts + Claude Code education + internal knowledge sharing is very specific and unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is overly verbose for its purpose, spending many tokens on concepts Claude already understands (how to write educational content, what hooks and CTAs are, general writing advice). It lacks concrete examples of actual output—no sample post excerpt, no before/after comparison—which undermines its actionability despite having a reasonable workflow structure. The references to external files suggest good progressive disclosure intent, but without those files and with redundant inline content, the organization is only partially effective.

Suggestions

Cut the 'When to Use This Skill' section entirely (duplicates the description) and trim 'Key Principles' to 2-3 bullet points max—Claude already knows general writing advice.

Add a concrete example of a completed post (or at least a substantial excerpt) showing the 'Normal vs Better' pattern and the expected output format.

Add an explicit validation step in the workflow: after drafting, list 3-5 specific pass/fail criteria to check before saving, with a 'fix and re-check' loop.

Either provide the referenced bundle files (writing-guidelines.md, post-template.md) or inline the essential content from them—currently the skill depends on files that don't exist in the bundle.

DimensionReasoningScore

Conciseness

The skill is verbose and explains many things Claude already knows—how to plan content, what a hook is, what a call-to-action is, how to research a topic. The 'When to Use This Skill' section repeats the description. The 'Key Principles' section restates common writing advice (show don't tell, make it actionable, verify facts) that Claude inherently understands. Much of this could be cut to a fraction of its length.

1 / 3

Actionability

The skill provides a structured workflow and references templates/guidelines, but contains no concrete examples of actual post content, no sample prompts, no example output, and no executable code. The guidance remains at the level of 'fill in the template' and 'apply the writing guidelines' without showing what good output looks like inline.

2 / 3

Workflow Clarity

The 5-step workflow is clearly sequenced and includes a research checklist, but lacks validation checkpoints—there's no review/feedback loop after drafting, no criteria for when a post is 'good enough,' and no explicit step to verify the output against quality standards before sharing. Step 4 mentions reviewing against a checklist but doesn't define what happens if the draft fails the check.

2 / 3

Progressive Disclosure

The skill references external files (references/writing-guidelines.md, assets/post-template.md) with brief descriptions of their contents, which is good structure. However, no bundle files were provided, so these references are unverifiable. The main file also contains substantial inline content that overlaps with what the referenced files presumably cover, suggesting the split isn't clean.

2 / 3

Total

7

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
daymade/claude-code-skills
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.