CtrlK
BlogDocsLog inGet started
Tessl Logo

extraction-pipeline-patterns

Change or diagnose Xberg's core extraction orchestration, cache semantics, extractor fallback, post-processing, concurrency defaults, or format-wide quality invariants. Load for pipeline work, not a single parser's syntax.

64

Quality

76%

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 ./.ai-rulez/skills/extraction-pipeline-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 exemplary codebase-patterns skill body: dense with non-derivable project knowledge, cleanly sectioned, with a clearly sequenced pipeline flow, explicit critical rules, and honest boundary statements ('Treat streaming as an open gap', 'no hit-rate target is computed or enforced'). Weaknesses are minor — the cache section could be trimmed, and verification guidance lacks an explicit test command and feedback loop.

DimensionReasoningScore

Conciseness

Nearly every line is codebase-specific fact Claude cannot know (paths, function names, feature flags, cache key structure), with no filler and no explanation of known concepts — 'Bindings are separate crates, not features of crates/xberg' is typical of the lean, knowledge-dense style. It stops short of the 5 'every token earns its place' anchor because the cache bullet carries multi-clause reasoning ('the commit SHA plus a hash of any uncommitted diff (build.rs), so it IS a build fingerprint') that could be trimmed.

4 / 5

Actionability

Guidance is concrete and directly executable against the codebase: exact paths ('crates/xberg/src/core/pipeline/'), a runnable command ('scripts/sync_supported_counts.py verify'), precise rules ('Register above 50 to override a built-in'), and named entry points ('core::pipeline::run_pipeline(doc, config)'). Per the rubric's instruction-skill note, absent code snippets are not penalized when guidance is actionable; it is not a 5 because there are no copy-paste examples for the common cases (e.g., adding or modifying an extractor).

4 / 5

Workflow Clarity

The 'Flow' section gives a clearly sequenced four-step pipeline (Detect → Route → Extract → Post-process), and the Verification section mandates testing 'both success and failure paths' plus keeping the count test in sync with 'FORMATS'. It matches the 4 anchor 'clear sequence with most checkpoints present; minor validation gaps' — the validation guidance names what to check but no explicit test command or feedback loop (run → fail → fix → re-run) for arbitrary pipeline changes.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so the skill is judged on its own structure: eleven well-labeled sections with an appropriate overview/index role, and cross-navigation is one level deep via named sibling skills ('mime-detection-routing', 'plugin-architecture-patterns', 'feature-flag-policy', 'benchmark-workflow', 'test-corpus'). It matches the 4 anchor 'good structure; most content appropriately placed; minor organization gaps' — the extractor-module catalogue and features table are borderline content that could live in reference files if the skill grew.

4 / 5

Total

16

/

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 strong description: third-person-voice verbs, a specific named domain, six concrete capability areas, and an explicit positive-plus-negative trigger clause ('Load for pipeline work, not a single parser's syntax') that sharply bounds it against adjacent skills. The only weakness is that the 'when' clause and trigger vocabulary could be richer (synonyms, natural user phrasings).

DimensionReasoningScore

Specificity

Concrete verbs ('Change or diagnose') are applied to six precisely named capability areas ('extraction orchestration, cache semantics, extractor fallback, post-processing, concurrency defaults, or format-wide quality invariants'). This matches the 'several specific actions; minor gaps' anchor — the action set itself is only two verbs, short of the comprehensive coverage of the 5 anchor ('Extract text and tables from PDF files, fill forms, merge documents, convert pages to images').

4 / 5

Completeness

Both halves are explicit: the 'what' ('Change or diagnose Xberg's core extraction orchestration...') and the 'when' ('Load for pipeline work, not a single parser's syntax'), so the 3-cap for missing trigger guidance does not apply. It sits at the 4 anchor because the 'when' clause, while explicit and usefully negative, is comparable in brevity to the anchor example 'Use when working with PDF files' rather than the multi-trigger concreteness of the 5 anchor.

4 / 5

Trigger Term Quality

Terms a developer would naturally say — 'pipeline work', 'extraction', 'cache', 'fallback', 'post-processing', 'concurrency' — are all present, matching the 'good keyword coverage; a few natural terms missing' anchor (e.g., no file extensions or user-side synonyms like 'format support' or 'PDF extraction'). Not a 3: coverage is well beyond 'Works with PDF files'-level sparseness; not a 5: synonyms and extensions are absent.

4 / 5

Distinctiveness Conflict Risk

The description names the specific system ('Xberg's core extraction orchestration') and draws an explicit boundary ('not a single parser's syntax'), and the body confirms sibling skills (mime-detection-routing, plugin-architecture-patterns, format-specific-extraction) it is scoped apart from. This matches the 5 anchor 'clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

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.