CtrlK
BlogDocsLog inGet started
Tessl Logo

format-specific-extraction

Format-specific document extraction workflows

53

Quality

60%

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

Fix and improve this skill with Tessl

tessl review fix ./.ai-rulez/skills/format-specific-extraction/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 an exemplar of lean, actionable, format-by-format reference material with real APIs and explicit security validation sequencing. Its only gap is the absence of explicit error-recovery feedback loops and a few inline details that could be offloaded to references.

DimensionReasoningScore

Conciseness

The body is dense and reference-driven, assuming Claude's competence: exact APIs, file paths, and one-line pipelines with no padding or explanation of basic concepts, matching the 'every token earns its place' anchor.

5 / 5

Actionability

It gives fully executable, copy-paste-ready specifics — real crate calls (xberg_native_pdf::PdfDocument::from_bytes(content.to_vec())?), helper function names, feature flags, and exact file locations covering the common cases per format.

5 / 5

Workflow Clarity

Each format has a clear numbered sequence with a pipeline diagram, and the archive path enforces ZipBombValidator::new().validate() before extraction; it stops short of explicit validate-then-fix feedback loops, fitting 'clear sequence with most checkpoints present'.

4 / 5

Progressive Disclosure

Content is well sectioned by format with cross-skill pointers (mime-detection-routing, test-corpus) and a helper table; no bundle files exist so it is self-contained, though several inline registry/API details could arguably live one level deeper, leaving a minor organization gap.

4 / 5

Total

18

/

20

Passed

Description

31%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 is concise and names a clear niche, but it is too vague to be a strong trigger: no concrete actions, no 'Use when...' guidance, and few natural keywords. It would surface on direct format mentions but miss paraphrased requests.

Suggestions

Add concrete actions, e.g. 'Extract text, tables, and metadata from PDF, Office XML, archives, and structured files'.

Append an explicit trigger clause: 'Use when extracting content from a specific document format (PDF, DOCX, XLSX, PPTX, ZIP, JSON, EML...).'

Include natural synonyms and extensions users say (PDFs, .docx, spreadsheets, email) to improve trigger_term_quality.

DimensionReasoningScore

Specificity

The description names the domain (format-specific document extraction) but lists no concrete actions, only the generic phrase 'workflows', matching the score-2 anchor 'Processes PDF files' in form.

2 / 5

Completeness

It offers only a vague 'what' (extraction workflows) and no 'when'/'Use when...' clause, so per the guideline a missing explicit trigger guidance caps completeness at 3 and the weak what pushes it to 2.

2 / 5

Trigger Term Quality

It contains 'document extraction' and 'workflows' but no natural file extensions or user-facing synonyms; the language leans technical rather than the phrases users would naturally say.

2 / 5

Distinctiveness Conflict Risk

'Format-specific document extraction' is somewhat specific and unlikely to broadly conflict, but 'document extraction' overlaps with general/PDF extraction skills, fitting the score-3 anchor 'could still overlap with similar skills'.

3 / 5

Total

9

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
xberg-io/xberg
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.