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
67%
Does it follow best practices?
Impact
91%
1.62xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./teams-channel-post-writer/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
bbf87f3
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.