CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/pdf-accessibility-checker

Test PDF accessibility (PDF/UA conformance) - tagged-PDF structure (StructTreeRoot), alternative text on images (Alt), reading-order, language metadata (Lang), document title, heading hierarchy. Use veraPDF / PAC (PDF Accessibility Checker) / pdfix / Adobe Acrobat Pro headless; map each finding back to WCAG 2.1 PDF Techniques (PDF1 - PDF23). Use when a product ships customer-facing PDFs into a context that mandates PDF/UA - US Section 508, EU Directive 2016/2102, or a public-sector tender - and each file must be proven tagged before release.

Quality

89%

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

Overview
Quality
Evals
Security
Files

Quality

Content

81%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 high-quality, highly actionable body: executable checks for every PDF/UA requirement, real-world gotchas documented inline, and a fail-closed CI gate. Weaker spots are the undefined reading-order helper and placeholder install paths, plus a slightly padded intro paragraph.

Suggestions

Ship the pytest functions as a scripts/pdf_ua_checks.py bundle file (or provide the missing extract_text_with_structure_order implementation) so all code is copy-paste executable.

Provide a concrete auto-install.xml example or exact installer invocation in Step 2 to remove the '<install-dir>' guesswork.

Trim the opening WCAG-principles paragraph to one line pointing at the [WCAG 2.1 spec] reference, since Claude already knows the principles.

DimensionReasoningScore

Conciseness

The body is dense and expert-level: non-obvious gotchas (pikepdf 'bool(), not is True' wrapper semantics, jq -e exit-status behavior, nested /K tree walking) earn their tokens, and tables carry information efficiently. It is not score 5 because the opening paragraph reciting WCAG principles and some Step 8 template prose restate knowledge Claude already has and could be trimmed.

4 / 5

Actionability

Mostly executable: verapdf install commands, the '--flavour ua1 --format json' CLI invocation, complete pytest functions, and a CI YAML gate with working jq logic. It is not score 5 because Step 8 calls an undefined 'extract_text_with_structure_order()' helper and Step 2 leaves '<install-dir>' and an unshown 'auto-install.xml' as placeholders — flagged as templates, but not copy-paste ready.

4 / 5

Workflow Clarity

Ten clearly sequenced steps (pick checker → install → run → parse → tagged → title/lang → alt → reading order → map techniques → CI gate) where each verification step is itself an assertion with a descriptive failure message, exit codes are documented, failures cite WCAG techniques, and the Anti-patterns table supplies fixes — explicit validation checkpoints plus error-recovery guidance. It is not score 4 because there are no validation gaps: the CI gate demonstrably fails on violations via jq -e.

5 / 5

Progressive Disclosure

Well-organized single-file skill with clear step sections, comparison tables, and well-signaled one-level-deep external references (markdown link definitions for WCAG, pikepdf, jq). It is not score 5 because no bundle structure exists: the reusable pytest functions (~90 lines of code) could plausibly live in a scripts/ file, keeping SKILL.md a leaner overview.

4 / 5

Total

17

/

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 description: third-person voice, concrete capability enumeration, named tools, and an explicit 'Use when' clause with concrete regulatory triggers. The only weakness is a few missing natural trigger terms such as the '.pdf' extension and 'screen reader'.

Suggestions

Add the '.pdf' file extension and 'screen reader' phrasing to the trigger terms (e.g., 'screen-reader accessible PDFs (.pdf)') to broaden natural-language matching.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'tagged-PDF structure (StructTreeRoot), alternative text on images (Alt), reading-order, language metadata (Lang), document title, heading hierarchy' — names four specific tools (veraPDF, PAC, pdfix, Acrobat Pro headless), and maps findings to 'WCAG 2.1 PDF Techniques (PDF1 - PDF23)'. This is comprehensive, concrete coverage matching the score-5 anchor; it is not score 4 because there are no minor gaps in capability coverage.

5 / 5

Completeness

It explicitly answers 'what' (test PDF/UA conformance with the six enumerated structural checks and named tools) and 'when' ('Use when a product ships customer-facing PDFs into a context that mandates PDF/UA - US Section 508, EU Directive 2016/2102, or a public-sector tender'). This matches the score-5 anchor: both what and when are explicit with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good keyword coverage including synonyms and regulatory triggers: 'PDF accessibility', 'PDF/UA', 'tagged', 'WCAG', 'Section 508', 'EU Directive 2016/2102', plus tool names users would mention. It falls between anchors 4 and 5 because a few natural terms are missing — the '.pdf' file extension, 'screen reader', and plain 'make PDFs accessible' phrasing — so it is not the comprehensive coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche — PDF/UA conformance gating in regulated release pipelines — with distinct triggers (Section 508, EU Directive, public-sector tender, 'proven tagged before release'). It would not fire for generic PDF extraction/editing or visual-regression tasks, matching the score-5 anchor for minimal conflict risk.

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.

Reviewed

On this page