CtrlK
BlogDocsLog inGet started
Tessl Logo

teams-channel-post-writer

Writes educational Teams channel posts about Claude Code features and best practices, using templates emphasizing concrete examples and underlying principles (e.g. context engineering). Use when writing a Teams post or announcement to teach colleagues Claude Code usage, announce a feature, share a tip, or document a lesson learned.

65

Quality

78%

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 ./teams-channel-post-writer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured skill body with a clear, checklist-validated workflow and accurate one-level-deep bundle references. Its main weaknesses are redundancy — three sections restate the description or the reference file's contents — and the absence of any inline example post to anchor the guidance.

Suggestions

Trim redundancy: collapse 'When to Use This Skill' and the 'Key Principles' section, since both restate the frontmatter description and the structure principles already in references/writing-guidelines.md.

Include a short inline excerpt of a filled-in post (e.g., a title + Normal/Better pair from the template) so the guidance is fully concrete without opening the asset file.

Shorten the Resources section to one line per file ('See references/writing-guidelines.md for tone, structure patterns, and the quality checklist') instead of re-summarizing their contents.

DimensionReasoningScore

Conciseness

The body doesn't explain concepts Claude already knows, but it has three redundant sections: 'When to Use This Skill' restates the frontmatter description, 'Key Principles' (Show don't tell / connect to principles / make it actionable / verify everything) duplicates content in references/writing-guidelines.md, and the Resources section re-summarizes the reference files' own contents. Fits 'mostly efficient but includes some unnecessary explanation or could be tightened'. Not 2 — the prose itself is tight and there's no padding or over-explanation.

3 / 5

Actionability

Guidance is concrete for an instruction-only skill: a 9-item fill-in structure with specific quantities ('3+ realistic, concrete prompts', '4 key benefits'), a 'Normal vs Better' pattern requirement, a ready-to-use template file, and a save step. Falls short of 5 only because no inline example or excerpt of a finished post is shown — the template lives entirely in the asset file — leaving minor gaps.

4 / 5

Workflow Clarity

The five-step workflow (Understand → Plan → Draft → Apply Guidelines → Save) is clearly sequenced and includes explicit validation checkpoints: a research checklist in step 1 and a quality-checklist review of the draft in step 4, mirroring the anchor's 'clear sequence with explicit validation steps... checklists for complex processes'. No destructive/batch operations, so no cap applies. Not 4 — the checkpoints are present, not merely implied.

5 / 5

Progressive Disclosure

Both referenced bundle files exist (references/writing-guidelines.md, assets/post-template.md), are one level deep, and match their descriptions. The body is organized into Overview / When to Use / Workflow / Key Principles / Resources. Kept at 4 rather than 5 because the 'Key Principles' section inlines guidance that belongs in (and partly duplicates) writing-guidelines.md — a minor organization gap where content that should live in the reference is inline.

4 / 5

Total

16

/

20

Passed

Description

82%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 well-crafted description with an explicit what + use-when structure and natural trigger phrases. Its only limitation is that the capability side rests on a single action (writing posts) rather than a broader set of concrete actions.

DimensionReasoningScore

Specificity

The description names the domain ('Writes educational Teams channel posts about Claude Code features and best practices') but only offers one concrete action — writing posts — plus a note that templates are used; no broader action coverage (e.g., drafting, editing, formatting). This matches 'names domain and 1-2 concrete actions, but not comprehensive'. Not 4, since several distinct specific actions are not listed; not 2, since the action and domain are clearly stated.

3 / 5

Completeness

Both questions are answered explicitly: 'what' via 'Writes educational Teams channel posts about Claude Code features and best practices, using templates...' and 'when' via the concrete 'Use when writing a Teams post or announcement to teach colleagues Claude Code usage, announce a feature, share a tip, or document a lesson learned.' This mirrors the anchor-5 example structure of explicit what + concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: 'writing a Teams post or announcement', 'announce a feature', 'share a tip', 'document a lesson learned', 'teach colleagues Claude Code usage'. Good keyword coverage that users would naturally say, but a few common variants are missing (e.g., 'channel message', 'share an update', 'Teams announcement') — fits 'good keyword coverage; a few natural terms missing', not the comprehensive synonym-level coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The niche is narrow and clearly scoped — writing educational Teams channel posts about Claude Code — with triggers ('Teams post', 'announcement', 'share a tip') that are unlikely to fire for other skills. Minimal overlap with general writing or documentation skills.

5 / 5

Total

17

/

20

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 — 16 / 16 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.