CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

block-detector

Detect and catalog content blocks on web pages using Puppeteer browser automation with semantic analysis, bounding box capture, and CSS selector generation. Use when "detecting page blocks", "block analysis", "content block extraction", or "page structure detection".

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

Highly actionable with executable code throughout and a clear step sequence, though slightly verbose in places that restate the obvious and lacking explicit validation feedback loops for the batch detection operation.

Suggestions

Trim restated explanations Claude already knows (e.g., why direct children of <main> matter, the rationale after each selector list) to lift conciseness.

Add an explicit validation/retry checkpoint after detection (e.g., if blockCoverage < 0.6, re-run with relaxed heuristics) so the workflow has a feedback loop rather than just a note.

Consider moving the block-type inference table and heuristics into a reference file and linking to it, reducing SKILL.md body length while keeping the overview lean.

DimensionReasoningScore

Conciseness

Mostly efficient with executable code, but includes some unnecessary explanation Claude already knows (e.g., 'Prioritize elements that are direct children of <main> -- these are the most likely top-level content blocks' and restating the purpose of each selector list) and the Quick Reference table largely duplicates the description.

3 / 5

Actionability

Provides fully executable, copy-paste-ready Puppeteer and DOM code across all eight steps with concrete selectors, heuristics, and a complete TypeScript output interface and JSON example.

5 / 5

Workflow Clarity

Eight numbered steps plus a consolidated workflow are clearly sequenced with cleanup in a finally block, but detection is a batch/read operation lacking explicit validation checkpoints (the 10-block cap and coverage<0.6 heuristic are noted but no validate/retry loop is enforced).

4 / 5

Progressive Disclosure

Well-organized with clear section headers and a body that stays one level deep with no nested references, but the Quick Reference table repeats the description and some heuristics could live in a reference file; no bundle files are present.

4 / 5

Total

16

/

20

Passed

Description

92%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 strong, specific description with both clear capabilities and explicit trigger phrases in third-person voice. Minor room for additional synonyms/variations in trigger terms.

DimensionReasoningScore

Specificity

Lists multiple concrete actions in third person ('Detect and catalog content blocks', 'semantic analysis, bounding box capture, and CSS selector generation') with comprehensive capability coverage.

5 / 5

Completeness

Clearly answers both what ('Detect and catalog content blocks... using Puppeteer browser automation with semantic analysis, bounding box capture, and CSS selector generation') and when ('Use when...') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes four natural quoted trigger phrases users would say ('detecting page blocks', 'block analysis', 'content block extraction', 'page structure detection'), though it lacks synonyms or common variations like 'web page structure' or URL-based phrasing.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (web page block detection via Puppeteer) with distinct triggers that are unlikely to fire for unrelated skills.

5 / 5

Total

19

/

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

paolomoz/skills

Path

skills/block-detector/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.