CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

batch-extraction

Use when extracting from many files at once with shared config, bounded parallelism, per-file overrides, and error recovery. Covers the `batch` command, `--file-configs`, `--max-concurrent`, and output layout.

64

Quality

81%

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

The canonical home for this skill is batch-extraction in xberg-io/xberg

SKILL.md
Quality
Evals
Security

Quality

Content

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

An efficient, highly actionable command reference with excellent copy-paste examples and no wasted tokens. Its weaknesses are operational: the batch workflow lacks a concrete per-file validation command and retry loop (capping workflow clarity at 3), and its key reference target does not exist in the bundle.

Suggestions

Add a concrete validation step to the Error recovery section, e.g. a jq filter like `xberg batch ... | jq '.[] | select(.error != null)'` plus a retry recipe for failed files, to turn the implicit 'inspect results' checkpoint into an executable feedback loop.

Fix the dangling `references/cli-reference.md` pointer — either include the file in this skill's bundle or state explicitly (as done for the API references) that it lives in the sibling `xberg` skill, so navigation is unambiguous.

Clarify the sibling-skill API references with the same explicit location phrasing used elsewhere, and consider consolidating them into a single clearly-signaled 'Further reference' section for easier discovery.

DimensionReasoningScore

Conciseness

Every section delivers xberg-specific facts Claude would not know (default `--format json` vs `text`, layout concurrency limits of 1/2, `--output-dir` must exist, path-key matching rules) with zero padding or explanation of known concepts. This matches anchor 5 — lean, assumes competence, every token earns its place — and shows none of the over-explanation that would drop it to 4.

5 / 5

Actionability

Nearly every section contains copy-paste-ready commands: `xberg batch *.pdf`, a jq post-processing pipeline, a complete `--file-configs` JSON example, `mkdir -p` + `--output-dir`, a TOML config, and a runnable Python `extract_batch` snippet covering the common cases. The only nit is `await` shown at top level, which is the standard convention for illustrating async APIs and keeps it at anchor 5 rather than revealing a real gap.

5 / 5

Workflow Clarity

For a batch operation the rubric caps workflow_clarity at 3 without concrete validation, and this skill's checkpoint is implicit: "Inspect results for partial content and surfaced errors rather than relying on the process exit code alone" gives direction but no executable validation command (e.g., a jq filter for per-file errors) and no retry/fix loop for failed files. This fits anchor 3 (checkpoints missing or implicit); it does not reach 4 because the verification step lacks a concrete command, and is above 2 because error handling is at least explicitly addressed.

3 / 5

Progressive Disclosure

Sections are well-organized and the bulk flag detail is correctly deferred ("See `references/cli-reference.md` for the full `batch` flag set"), but the bundle contains no `references/` directory at all — that pointer is dangling, and the API references are ambiguously located "in the sibling `xberg` skill". Per the guideline to score against the actual bundle structure, this matches anchor 3 (references present but not clearly signaled/verifiable) rather than 4's 'references mostly clear'.

3 / 5

Total

16

/

20

Passed

Description

75%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 solid description with an explicit 'Use when' trigger, third-person imperative voice, and several concrete capability and flag keywords. It scores uniformly at 4: specific and well-triggered, but lacking the synonym/variation coverage and richer trigger phrasing of a top-scored description.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — "shared config, bounded parallelism, per-file overrides, and error recovery" plus the "`batch` command", "`--file-configs`", "`--max-concurrent`", and "output layout" — which matches the anchor for several specific actions with minor gaps. It is not 5 because coverage is incomplete (no file formats, no mention of the structured array output), and not 3 because it goes well beyond naming 1-2 actions.

4 / 5

Completeness

Both parts are present: the what ("shared config, bounded parallelism, per-file overrides, and error recovery. Covers the `batch` command...") and an explicit when ("Use when extracting from many files at once"). It matches anchor 4 rather than 5 because the 'when' relies on a single trigger clause without additional concrete trigger phrases or variations.

4 / 5

Trigger Term Quality

"Use when extracting from many files at once" is a natural phrase a user would say, and "batch" plus the concrete flag names give good keyword coverage. It falls short of 5 because common variations like "bulk", "folder/directory of documents", and file-type keywords are missing, but it clearly exceeds the 3 anchor's 'missing common variations' level.

4 / 5

Distinctiveness Conflict Risk

"many files at once" and the `batch` command clearly carve out a niche distinct from single-file extraction, but as a sibling of the broader `xberg` extraction skill there is minor overlap risk — a user asking to 'extract these PDFs' could plausibly need either skill. This fits anchor 4 (mostly distinct, minor overlap with closely related skills), not 5's minimal-conflict profile.

4 / 5

Total

16

/

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

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

15

/

16

Passed

Repository

xberg-io/xberg

Path

plugin/.hermes/package/src/xberg_hermes_plugin/skills/batch-extraction/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.