CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

batch

Execute batch operations on multiple files in parallel. Automatically discovers files, splits into chunks, and processes with parallel worker agents. Use `/batch` followed by operation and file pattern. For many independent single-turn transforms (translate/rewrite/extract each file into a new file) that can wait minutes to hours, you may suggest the user type `/batch-api` themselves for the half-price asynchronous Batch API — you cannot invoke it, and it is not suited to in-place edits or tasks needing tool feedback.

Quality

71%

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 ./packages/core/src/skills/bundled/batch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 highly actionable, well-structured operational guide whose main weaknesses are a missing post-batch verification step (which caps workflow clarity) and duplicated constraint/repetition content that inflates token usage. Progressive disclosure is solid for a single-file skill, though the length invites splitting.

Suggestions

Add an explicit post-batch validation step (e.g., spot-check a sample of edited files, run relevant tests, or re-read modified files to confirm agent-reported successes) to lift the batch-operation workflow cap.

Deduplicate the chunking limits — the Constraints table repeats the Step 2 table and algorithm verbatim; keep one canonical location and reference it.

Collapse the three-fold repeated Example Invocation block into a single annotated example plus a note that N chunks mean N parallel calls, and move usage examples or the output-format template to a reference file to reduce SKILL.md size.

DimensionReasoningScore

Conciseness

Mostly efficient operational content, but the chunking limits are stated twice (the Step 2 table/algorithm and again verbatim in the Constraints table), and the Example Invocation block repeats the same agent call three times. Not 4 because the duplication is genuine tightening work; not 2 because there is no conceptual over-explanation — everything is operational.

3 / 5

Actionability

Concrete, usable guidance throughout: exact glob patterns, an explicit exclusion list, a numeric chunking table, a complete copy-paste agent prompt template, and three worked usage examples with flows. Not 5 because the Example Invocation Pattern uses illustrative `<Agent tool call>` pseudo-blocks rather than literal parameters, and template placeholders like [file1.ts] leave minor gaps for edge cases.

4 / 5

Workflow Clarity

The 5-step sequence is clearly ordered with some checkpoints (empty-match handling, >50/>100 file warnings, per-file failure continuation), but this is a batch operation with no post-run validation or verification step — no spot-check of edited files, test run, or re-read to confirm agent-reported success. The rubric's cap for batch operations without validation holds it at 3 despite the otherwise strong sequencing. Not 2 because steps are well defined with error-handling checkpoints, far above the anchor's 'validation absent and steps poorly defined'.

3 / 5

Progressive Disclosure

No bundle files exist and the body references none (no dangling references to nonexistent files), and sections are well organized with clear headers, tables, and templates. Not 5 because at ~296 lines, content that could live in a separate reference file (usage examples, output format template) is inlined; not 3 because structure and navigation are good and nothing is buried.

4 / 5

Total

14

/

20

Passed

Description

70%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 specific, well-bounded description with concrete actions and good trigger vocabulary, weakened by second-person voice and trigger guidance that primarily serves the sibling `/batch-api` command rather than stating explicitly when to use `/batch` itself.

Suggestions

Rewrite the description in third person to avoid the specificity penalty — e.g., replace "you may suggest the user type `/batch-api` themselves" with "suggest the user type `/batch-api` themselves".

Add an explicit 'Use when...' clause for this skill, e.g., "Use when applying the same operation to many files at once (e.g., 'add headers to all .ts files')".

Add natural trigger synonyms such as "bulk", "mass update", or "all files at once" to broaden keyword coverage.

DimensionReasoningScore

Specificity

Names the domain and concrete actions ("Automatically discovers files, splits into chunks, and processes with parallel worker agents"), matching anchor 4, but the second-person phrase "you may suggest the user type `/batch-api` themselves" triggers the rubric's third-person voice penalty, reducing the score by 1. It does not fall to 2 because the actions listed go beyond the generic single-action examples at that anchor.

3 / 5

Completeness

The 'what' is clear ("Execute batch operations on multiple files in parallel") and 'when' guidance exists ("For many independent single-turn transforms (translate/rewrite/extract each file into a new file) that can wait minutes to hours... not suited to in-place edits or tasks needing tool feedback"), but the when-clause is framed around when to suggest the sibling `/batch-api` rather than explicitly when to use `/batch` itself. Not 5 because the trigger guidance for this skill is indirect; not 3 because explicit applicability conditions and boundaries are present.

4 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say — "batch", "multiple files", "parallel", "translate/rewrite/extract", "file pattern" — but common synonyms like "bulk", "all files at once", or "mass update" are missing. Not 5 because coverage is not comprehensive; not 3 because it goes well beyond the sparse single-keyword examples at that anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche — parallel multi-file batch processing — with explicit boundaries ("not suited to in-place edits or tasks needing tool feedback"), but there is minor overlap/confusion risk with the closely related `/batch-api` skill referenced in the same description. Not 5 because the description itself invites ambiguity between two similar commands; not 3 because the framing is far more specific than generic file-processing skills.

4 / 5

Total

15

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

QwenLM/qwen-code

Path

packages/core/src/skills/bundled/batch/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.