CtrlK
BlogDocsLog inGet started
Tessl Logo

pdf-size

Use when auditing a site that publishes downloadable PDFs (reports, white papers, legal documents, manuals). Applies to any site where PDFs are linked as indexable content resources.

56

Quality

63%

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/pdf-size/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 lean, well-structured audit skill: the check procedure is specific with exact byte thresholds, and the single reference file is clearly signaled and one level deep. The main weaknesses are the duplicated 'Check'/'Code Review' sections and an unresolved mix of 10/15/60 MB figures that muddies which threshold applies.

Suggestions

Merge 'Check' and 'Code Review' into one procedure section — they repeat the same steps and thresholds almost verbatim.

Reconcile the size numbers: the title and Quick Reference cite 60 MB while the checks flag at 10/15 MB; state one threshold table or reuse the size-targets table from references/rule.md.

Trim or drop the 'Quick Reference' bullets that restate the Check/Fix/Explain sections, keeping only the non-repeated facts (e.g. the HTML landing page tip).

DimensionReasoningScore

Conciseness

Mostly efficient — no padded explanation of concepts Claude already knows — but the 'Check' and 'Code Review' sections duplicate the same procedure (find .pdf links, HEAD request, Content-Length, 10/15 MB thresholds), and the 'Quick Reference' bullets restate Check/Fix/Explain content. Not 2 because the body is short and free of known-concept filler; not 4 because the section-level duplication is noticeable and could be tightened.

3 / 5

Actionability

Concrete, executable-in-intent guidance: exact byte thresholds (10,485,760 and 15,728,640 bytes), named tools (Adobe Acrobat, Ghostscript, Smallpdf), a specific detection method (HEAD request + Content-Length), and a verification step (200 status, Content-Type: application/pdf). Not 5 because the body contains no copy-paste-ready command (the curl HEAD example lives only in references/rule.md); well above 3 because the instructions are specific enough to execute directly.

4 / 5

Workflow Clarity

The audit sequence is clear and unambiguous (find .pdf links → HEAD request → compare Content-Length → flag at explicit thresholds) with some checkpoints present (verify 200 status and Content-Type). Not 5 because there is no re-check feedback loop after compression and the title's 60 MB limit sits unresolved against the 10/15 MB check thresholds, creating threshold ambiguity; above 3 because the sequence and numbers are explicit rather than implicit.

4 / 5

Progressive Disclosure

The body is under 50 lines with well-organized sections and a single, clearly signaled one-level-deep reference — 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — which exists as a real file. The procedure stays appropriately inline while implementation detail is correctly deferred.

5 / 5

Total

16

/

20

Passed

Description

56%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 has an explicit, well-targeted trigger with good keyword variety, but it reads almost entirely as a trigger clause: the skill's concrete capabilities (checking linked PDF sizes, flagging files over crawl thresholds, recommending compression) are never stated. Adding a 'what' clause naming those actions would lift both specificity and completeness.

Suggestions

Add a capability clause before the trigger, e.g. 'Checks linked PDF file sizes via Content-Length headers and flags files above crawl-safe thresholds. Use when auditing a site that publishes downloadable PDFs...'

Include natural terms for the actual task — 'PDF file size', 'large PDFs', 'compress' — and the '.pdf' extension, which users referencing this rule would naturally say.

State the goal or threshold in the description (e.g. 'keeps linked PDFs under Googlebot's download limits') so the 'what' is explicit rather than inferred from 'auditing'.

DimensionReasoningScore

Specificity

The only action stated is the generic verb 'auditing' — the description never says what the skill actually does (check PDF file sizes, flag oversized files, recommend compression), matching the 'Names the domain but actions are minimal or generic' anchor. It is above 1 because the domain (a site publishing downloadable PDFs, with report/white paper/legal/manual examples) is clearly named, but below 3 because no concrete capability such as 'check size' or 'compress' is listed.

2 / 5

Completeness

The 'when' is explicit and strong ('Use when auditing a site that publishes downloadable PDFs... Applies to any site where PDFs are linked...'), but the 'what' is only weakly implied — the skill's actual function (checking linked PDF sizes against crawl limits) is never stated. Not 4 because anchor 4 presumes a serviceable 'what'; the what here is as weak as the when is strong, mirroring anchor 3's one-strong/one-weak shape.

3 / 5

Trigger Term Quality

Good natural keyword coverage — 'auditing a site', 'downloadable PDFs', 'reports, white papers, legal documents, manuals', 'PDFs linked as indexable content resources' — with useful document-type synonyms. It falls short of 5 because natural task phrases users would say are missing ('PDF file size', 'large PDFs', 'compress PDFs', 'crawl/indexing') and the '.pdf' extension never appears, but it is above 3 because the coverage is broad rather than sparse.

4 / 5

Distinctiveness Conflict Risk

The site-audit context ('auditing a site that publishes downloadable PDFs', 'linked as indexable content resources') is a clear niche that distinguishes it from general PDF-processing skills. It is not 5 because 'Applies to any site where PDFs are linked' broadens the trigger and leaves minor overlap risk with other SEO/crawl-audit skills, but it is well above 3.

4 / 5

Total

13

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.