CtrlK
BlogDocsLog inGet started
Tessl Logo

blog-writer

Blog post writing skill with structure templates and style guidelines. Guides the agent through writing well-structured, engaging technical blog posts with proper formatting, section flow, and reader engagement techniques.

60

Quality

70%

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 ./python/agents/agent-skills-tutorial/app/skills/blog-writer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 tight, well-sequenced instruction set with a clean single external reference and no wasted tokens. Its only real weakness is a handful of abstract polish directives and the absence of a concrete example of the promised structure templates.

DimensionReasoningScore

Conciseness

Every line is a directive ("Keep paragraphs to 2-3 sentences", "use fenced code blocks with language tags", "Start with a clear subheading (H2)") with zero concept explanation or padding; it assumes Claude's competence. This matches anchor 5 (lean, every token earns its place) — nothing here explains things Claude already knows.

5 / 5

Actionability

Concrete, executable rules throughout: a four-part outline schema (Hook/Context/Core sections/Takeaway), per-section directives, and a polish checklist, plus a concrete instruction to read `references/style-guide.md` for style rules. It stays at anchor 4 rather than 5 because a few directives are unverifiable abstractions ("Ensure consistent tone throughout", "Include code examples where relevant") and no sample outline or section template is shown despite the description promising 'structure templates'.

4 / 5

Workflow Clarity

The four steps (read style guide → outline → write sections → polish) are clearly sequenced, the outline acts as a pre-writing checkpoint, and the polish step includes verification ("Verify all code examples are complete and runnable"). Anchor 4 fits (clear sequence, most checkpoints); not 5 because there is no explicit feedback loop (verify → fix → re-verify) and no mid-writing checkpoints.

4 / 5

Progressive Disclosure

The body is a lean overview of well-organized sections with exactly one clearly-signaled, one-level-deep reference — "Use `load_skill_resource` to read `references/style-guide.md` for the writing style rules" — and that file exists in the bundle (references/style-guide.md is the only bundle file, so no nesting). This matches anchor 5 (clear overview, well-signaled one-level references, easy navigation); the under-50-lines exception also supports a top score.

5 / 5

Total

18

/

20

Passed

Description

53%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 clearly states what the skill does and stays concise in third person, but it lacks any 'use when' trigger clause and reads more like a capability summary than an action list. Distinctiveness is decent thanks to the specific blog-writing niche.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to write, draft, or edit a blog post, article, or technical write-up.'

Convert quality adjectives into concrete actions, e.g. 'Structures posts into hook, context, core sections, and takeaway; applies style rules from a style guide; formats code examples.'

Include natural synonyms users would say ('blog', 'article', 'draft', 'write-up') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Phrases like "Guides the agent through writing well-structured, engaging technical blog posts" and "proper formatting, section flow, and reader engagement techniques" name the domain and a couple of concrete facets, but they describe qualities of output rather than listing multiple distinct actions. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) better than anchor 4, which expects a list of several specific actions like 'extracts text, fills forms, converts pages'.

3 / 5

Completeness

The 'what' is clear (guides writing of well-structured, engaging technical blog posts with formatting and flow), but there is no 'Use when...' clause or equivalent trigger guidance, so completeness is capped at 3 per the judging guidelines ('when' is missing, only weakly implied by the topic). Not 4, which requires an explicit 'when'.

3 / 5

Trigger Term Quality

"Blog post writing" and "technical blog posts" are natural terms a user would say, but common variations like "article", "draft", or "write a post" are absent, matching anchor 3 (some relevant keywords, missing variations). Not anchor 4: coverage lacks the synonym breadth of examples like 'PDF files, forms, document extraction'.

3 / 5

Distinctiveness Conflict Risk

"Blog post writing skill" carves out a fairly distinct niche with minor overlap risk against general writing or documentation skills, matching anchor 4 (mostly distinct, minor overlap with closely related skills). Not 5: without explicit trigger phrases, it could still fire for adjacent prose-writing requests.

4 / 5

Total

13

/

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
google/adk-samples
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.