CtrlK
BlogDocsLog inGet started
Tessl Logo

picking-a-format

Use when choosing an output format for extracted documents — plain text, markdown, djot, HTML, JSON, or DocTags. Maps consumer (LLM, parser, archive) to the right `--format` / `--content-format` pair.

72

Quality

89%

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 picking-a-format in xberg-io/xberg

SKILL.md
Quality
Evals
Security

Quality

Content

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

Excellent body content: token-efficient structure (table + decision tree), fully executable examples covering the common consumer cases, unambiguous single-decision guidance, and correct deferral of exhaustive flag/configuration detail to clearly signaled one-level references. No weaknesses identified against the rubric anchors.

DimensionReasoningScore

Conciseness

The body is lean and efficient: a three-row knob table, a compact decision tree, and four short bash examples replace prose, with no explanation of concepts Claude already knows and every token earning its place.

5 / 5

Actionability

Fully executable, copy-paste-ready commands (e.g. `xberg extract paper.pdf --content-format markdown`, the batch-plus-jq pipeline, the metadata-only invocation) and concrete flag pairs in the decision tree cover the common cases.

5 / 5

Workflow Clarity

This is a simple single-decision skill and the decision tree makes the one action unambiguous (consumer → flag pair), meeting the simple-skill exception. Extraction is read-only, so the destructive/batch validation cap does not apply, and the body even flags that `maximum` token-reduction is lossy and should be verified.

5 / 5

Progressive Disclosure

A clear overview with detail appropriately deferred: the full flag set and configuration keys are pushed to well-signaled, one-level-deep references (`references/cli-reference.md`, `references/configuration.md`), keeping the SKILL.md body a navigable decision guide. No bundle files exist beyond the cited paths to check.

5 / 5

Total

20

/

20

Passed

Description

78%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 concise, well-structured description with an explicit "Use when" trigger, concrete flag names, and good natural keyword coverage. Its main limitation is thin action coverage — it describes a single mapping action rather than several specific capabilities. Third-person/trigger voice is used correctly.

Suggestions

Add one or two more concrete actions to broaden capability coverage, e.g. mention advising on token-reduction levels or comparing format trade-offs for specific consumers.

Include a couple of natural trigger variations users might say, such as "which output format" or "convert extraction output to markdown/JSON".

DimensionReasoningScore

Specificity

The description names the domain ("choosing an output format for extracted documents") and one concrete action ("Maps consumer (LLM, parser, archive) to the right `--format` / `--content-format` pair"), matching the 1-2 concrete actions anchor. It is more concrete than the generic level-2 anchor but does not list several specific actions required for a 4.

3 / 5

Completeness

It explicitly answers both: the "what" ("Maps consumer (LLM, parser, archive) to the right `--format` / `--content-format` pair") and the "when" ("Use when choosing an output format for extracted documents") with a concrete trigger phrase, exactly matching the anchor-5 pattern.

5 / 5

Trigger Term Quality

Good natural keyword coverage — "output format", "plain text", "markdown", "djot", "HTML", "JSON", "DocTags", "LLM", "parser", "archive" — terms a user would naturally say. A few natural variations (e.g. "which format", "convert to markdown") are missing, so it falls short of the comprehensive-synonym anchor at 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (extraction output-format selection tied to specific CLI flags) makes it mostly distinct with only minor overlap risk against generic format-conversion or markdown-rendering skills, fitting the anchor-4 example rather than the minimal-conflict anchor 5.

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: 2 missing

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.