pdf-processor

Process PDFs - extract text, tables, and structured data from documents

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/research-tools/capabilities/pdf-processor/SKILL.md

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill is concise and reasonably structured, but its actionability is undermined by malformed JSON in the curl examples and its workflow lacks the validation/verification checkpoints expected for extraction operations.

Suggestions

Fix the broken JSON payloads in Steps 2–3 and the Example Usage block so the -d arguments are valid, copy-paste-executable objects.

Add explicit verification checkpoints (e.g., check the HTTP status / response shape before parsing, confirm table row counts against the source).

Validate that the "Discover More" search/details commands and the dangling `-d '{..."olostep"...` fragment are correct and complete.

Dimension	Reasoning	Score
Conciseness	The body is lean and instruction-first with no conceptual padding about what a PDF is; it jumps straight to setup and executable curl commands, assuming Claude's competence.	3 / 3
Actionability	It provides concrete curl commands, but several are malformed JSON (the -d payload is broken across Steps 2–3 and the examples, with stray quotes and missing braces), so they are not copy-paste executable as written.	2 / 3
Workflow Clarity	Steps are clearly sequenced (Step 1–4) but there are no validation or verification checkpoints despite operations fetching and transforming remote documents, which the rubric caps at 2 for missing feedback loops.	2 / 3
Progressive Disclosure	The single SKILL.md is a well-organized overview with clear sections and no bundle files, so for a self-contained skill the content is appropriately organized with no nested references.	3 / 3
	Total	10 / 12 Passed

Description

67%

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 is specific and clearly distinct, but it omits explicit "Use when..." trigger guidance and only partially covers natural trigger terms, capping its completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause such as "Use when the user mentions PDFs, invoices, reports, or needs to extract data from PDF documents."

Broaden trigger-term coverage to include forms, invoices, .pdf files, and "document extraction" to better match phrasing users would naturally say.

Dimension	Reasoning	Score
Specificity	Names multiple concrete actions — "extract text, tables, and structured data" — matching the anchor for listing several specific concrete actions.	3 / 3
Completeness	It clearly states what the skill does but lacks any "Use when..." clause or explicit trigger guidance, which per the guidelines caps completeness at 2.	2 / 3
Trigger Term Quality	Includes "PDFs" and "documents" but omits common natural variations users would say (forms, document extraction, .pdf, invoices); coverage is partial rather than complete.	2 / 3
Distinctiveness Conflict Risk	The PDF/data-extraction niche is clearly delimited and unlikely to overlap with other skills, matching the anchor for a clear niche with distinct triggers.	3 / 3
	Total	10 / 12 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: gooseworks-ai/goose-skills
Path: skills/research-tools/capabilities/pdf-processor/SKILL.md
Commit: 8866b2a

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.