CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

chunking

Use when splitting extracted text into chunks for LLM context windows or RAG ingestion. Covers chunk size, overlap, markdown/yaml/semantic chunkers, tokenizer-based sizing, and the standalone `chunk` command.

67

Quality

84%

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 chunking in xberg-io/xberg

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 dense, highly actionable command reference with executable examples for every mode and useful tool-quirk notes. Its main weaknesses are minor redundancy and deferred references that point at files absent from the bundle, which undermines navigation.

Suggestions

Ship the referenced files (references/configuration.md and references/cli-reference.md) in this skill's bundle, or remove/repair the pointers so the deferred detail is actually reachable.

State the overlap-clamp rule once (in Common Pitfalls) instead of twice, and trim the cross-language field-name blockquote to the two or three naming forms that matter for the Python/Node callers the skill targets.

Add a one-line verification cue after the chunking examples (e.g., check `chunk_count` or spot-check `chunks[0]`) so readers can confirm the resolved config and output shape.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — it never explains what chunking or RAG is, and the capitalized `chunker_type` and cross-language field-name notes document real tool quirks Claude cannot infer. Minor trimmable redundancy remains (the overlap-clamp rule appears both in "Inline during extraction" and "Common Pitfalls"), matching anchor 4 rather than 5.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with real flags cover the common cases: inline chunking (`xberg extract ... --chunk --chunk-size 1500 --chunk-overlap 300`), standalone from flag and stdin, each chunker type, tokenizer sizing, TOML config, and runnable Python via `ExtractionConfig`/`ChunkingConfig`. Matches anchor 5.

5 / 5

Workflow Clarity

Usage paths are unambiguous, "Picking parameters" gives clear decision guidance by use case, and "Common Pitfalls" documents error cases (rejection, clamping, missing feature, empty input). There is no checkpoint for verifying output (e.g., inspecting `chunk_count` or chunk contents) after running, a minor validation gap matching anchor 4 rather than 5; no destructive/batch cap applies.

4 / 5

Progressive Disclosure

Section structure is good and bulk detail is correctly deferred ("See `references/configuration.md` for the full `[chunking]` schema and `references/cli-reference.md` for every chunk flag"), but no `references/` directory exists in this bundle, so those pointers dangle — as do the pointers to a sibling skill's `references/python-api.md` and `references/rust-api.md`. Well-organized content with broken navigation fits anchor 3 rather than 4.

3 / 5

Total

16

/

20

Passed

Description

83%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 with an explicit "Use when..." trigger, concrete what-coverage, and natural chunking/RAG keywords. It is mostly distinct from sibling skills, with only minor overlap risk against the extraction skill it builds on.

DimensionReasoningScore

Specificity

Enumerates concrete capability areas — "chunk size, overlap, markdown/yaml/semantic chunkers, tokenizer-based sizing, and the standalone `chunk` command" — plus the action "splitting extracted text into chunks". It lists covered topics rather than multiple concrete actions and omits items like inline-during-extraction chunking, matching anchor 4 rather than 5.

4 / 5

Completeness

Explicitly answers both: what ("Covers chunk size, overlap, markdown/yaml/semantic chunkers, tokenizer-based sizing, and the standalone `chunk` command") and when ("Use when splitting extracted text into chunks for LLM context windows or RAG ingestion") with concrete trigger phrases. Clearly matches anchor 5; the when-clause is already explicit and specific, so 4's "could be more explicit" does not apply.

5 / 5

Trigger Term Quality

Good natural-term coverage: "chunks", "RAG ingestion", "LLM context windows", "chunk size", "overlap". A few common variations users would say are missing (e.g., "split documents", "embeddings", "vector store"), so it fits anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Chunking for RAG/LLM ingestion is a clear niche with distinct triggers, but there is minor overlap risk with a closely related document-extraction skill (chunking also runs inline during extraction), which fits anchor 4 better than anchor 5's "minimal conflict risk".

4 / 5

Total

17

/

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/plugins/xberg/skills/chunking/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.