CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

blog-writing-guide

This skill enforces Sentry's blog writing standards across every post — whether you're helping an engineer write their first blog post or a marketer draft a product announcement.

Quality

71%

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/blog-writing-guide/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 a strong, opinionated, example-rich editorial standard: every rule is paired with concrete good/bad instances, and the review workflow is genuinely checkable. Its only real weaknesses are mild cross-section redundancy and the absence of any bundle split for the example banks.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows — every section is Sentry-specific opinionated guidance (voice, banned phrases, structure, byline policy) with concrete examples. Minor redundancy keeps it from a 5: 'Never say we're excited to announce' appears in both Banned Language and Non-Negotiable #3, and the performance-claim rule is duplicated in Technical Quality Standards and Non-Negotiable #5.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: verbatim banned phrases, paired good/bad openings ('Two weeks before launch, we killed our entire metrics product...' vs. 'At Sentry, we're always looking for ways...'), weak/strong heading and title examples with real numbers ('reduced our p99 error processing time from 340ms to 45ms — a 7.5× improvement'), a post-type table with byline rules, and a concrete feedback protocol ('Quote the weak passage, explain why it's weak, and rewrite it to show the standard'). Examples cover the common cases end to end.

5 / 5

Workflow Clarity

The review workflow is clearly sequenced with explicit checkpoints: Technical Review, Editorial Review, and Final Check checklists ('All technical claims accurate', 'Author byline is correct'), plus the 'Would I Share This?' gate and a numbered reader-question structure (1-4, plus 5-6 for deep-dives). It falls short of 5 because the writing side is presented as principles rather than an ordered procedure, and the review loop lacks an explicit fix-and-recheck cycle.

4 / 5

Progressive Disclosure

A single-file skill with no bundle files, organized into well-labeled sections (Voice, Banned Language, Opening, Structure, Headings, Titles, Post Types, Non-Negotiables, Review checklists) and no nested references. At 157 lines it exceeds the under-50-line simple-skill case, and the inlined good/bad example banks could live in references/ files, which is the minor gap keeping it at 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

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

The description identifies a clear, distinctive niche (Sentry blog standards) but is thin on substance: it names no concrete actions, omits explicit 'Use when...' trigger guidance, and slips into second person. It reads more like a mission statement than a capability statement.

Suggestions

State concrete capabilities in third person, e.g.: 'Reviews, edits, and drafts Sentry blog posts against the company's writing standards — voice, banned corporate language, technical depth, titles, and byline rules.'

Add an explicit trigger clause: 'Use when the user asks to write, edit, review, or draft a Sentry blog post, engineering deep dive, product announcement, or postmortem.'

Include natural trigger keywords users would actually say — 'blog post', 'draft', 'edit my draft', 'review this post', 'announcement' — to improve both trigger quality and completeness.

DimensionReasoningScore

Specificity

The description names the domain ('enforces Sentry's blog writing standards across every post') but offers only the generic action 'enforces standards' with no concrete capabilities (review a draft, apply banned-language checks, structure posts). The second-person clause 'whether you're helping an engineer...' further departs from the third-person voice guideline.

2 / 5

Completeness

The 'what' is vague — 'enforces... standards' never states what the skill does with a draft (write, edit, review) — and there is no explicit 'Use when...' trigger clause. The scenario clause ('whether you're helping an engineer write their first blog post or a marketer draft a product announcement') conveys applicability but only weakly, so the missing-trigger guideline caps this at 3.

3 / 5

Trigger Term Quality

Some relevant natural terms are present ('blog writing', 'blog post', 'product announcement', 'Sentry'), but common variations users would actually say — 'write a post', 'draft an article', 'edit/review my draft' — are missing. Keyword coverage is relevant but incomplete.

3 / 5

Distinctiveness Conflict Risk

'Sentry's blog writing standards' plus 'product announcement' carves a clear niche with distinct triggers and only minor overlap risk with generic writing/editing skills. It falls short of anchor 5 because no explicit trigger phrases are spelled out.

4 / 5

Total

12

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/blog-writing-guide/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.