CtrlK
BlogDocsLog inGet started
Tessl Logo

plugin-architecture-patterns

Design, implement, or diagnose Xberg plugin traits, typed registries, priority collisions, lifecycle, native extractors, and Alef-generated Python plugin bridges. Load for plugin-system work, not ordinary extractor parsing.

66

Quality

80%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 exceptionally dense, high-signal reference: correct-by-construction guidance expressed as exact identifiers, file paths, code patterns, and explicit anti-patterns ('there is no as_sync_extractor; writing one is a compile error'), with no filler. The main gaps are elided code bodies and the absence of a single unified, ordered workflow with validation checkpoints tying the sections together.

DimensionReasoningScore

Conciseness

Nearly every line carries project-specific, non-inferable facts (file paths like 'plugins/extractor/trait.rs', exact trait/enum names, collision semantics, PyO3 0.29 behavior) with zero padding and no explanation of Rust or plugin concepts Claude already knows — matching the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

The registration snippet, feature-gating example, PostProcessor impl, and InternalDocumentExtractor skeleton are concrete and near copy-paste ready, backed by exact identifiers ('ProcessingStage', 'processing_stage()', 'get_document_extractor_registry()'). The impl bodies are elided with '{ /* ... */ }' and the skeleton is scaffolding rather than a complete example, so it sits just below 'fully executable; copy-paste ready'.

4 / 5

Workflow Clarity

Content is organized topically rather than as a numbered pipeline, but the registration flow (acquire registry → write lock → register, with cfg feature-gating), the Critical Rules checklist, and the testing requirements ('Test lifecycle, collision/replacement, concurrent access, and failure paths with test doubles') supply clear sequence and concrete checkpoints like 'ensure_initialized() before first extraction' and the alef(skip) guard. It falls short of 5 because the implement → register → test flow is never unified into one explicit ordered walkthrough with validate/retry guidance.

4 / 5

Progressive Disclosure

No bundle files exist, and the ~145-line body is well-sectioned with headers, tables, and code blocks that make navigation easy; cross-skill pointers ('see wasm-constraints', 'see alef-generated-bindings') are clearly signaled inline. The Alef-bridge and registry-invariants sections are self-contained enough that they could live in separate reference files, and the skill is over the 50-line simple-skill threshold, so this is 'good structure; minor organization gaps' rather than fully optimal split.

4 / 5

Total

17

/

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, domain-anchored description with specific capability nouns, an explicit load trigger, and an explicit exclusion boundary. Its main weakness is that the trigger clause is terse and leans on jargon ('Xberg', 'Alef'), so it could name more natural user phrases and cover more of the plugin surface it actually supports.

Suggestions

Expand the trigger clause with natural user phrasing, e.g. 'Use when adding or debugging Xberg plugins, extractor traits, registries, priorities, or the Python plugin bridge' — concrete trigger phrases would lift completeness to the top anchor.

Include a couple of natural synonyms or common task phrasings ('add a new extractor', 'register a backend') alongside the technical nouns so users who don't say 'typed registries' or 'priority collisions' still match.

Mention the other plugin categories the skill covers (post processors, OCR/embedding/reranker backends, validators) to close the coverage gaps in specificity.

DimensionReasoningScore

Specificity

The description lists several specific concrete targets — 'Xberg plugin traits, typed registries, priority collisions, lifecycle, native extractors, and Alef-generated Python plugin bridges' — but the verbs ('Design, implement, or diagnose') are generic and coverage of the plugin surface (e.g., post processors, registration, the binding-facing vs. in-crate distinction) has minor gaps, matching the 'several specific actions; minor gaps' anchor rather than comprehensive.

4 / 5

Completeness

Both parts are present: a clear 'what' (the enumerated plugin-system subjects) and an explicit 'when' ('Load for plugin-system work, not ordinary extractor parsing'), which avoids the missing-trigger cap of 3. The 'when' clause is brief and could name more concrete trigger phrases (e.g., 'when the user mentions plugins, registries, or priorities'), so it sits at 'both present; when could be more explicit' rather than the 5 anchor.

4 / 5

Trigger Term Quality

Terms like 'plugin', 'registry', 'extractor', 'priority', and 'plugin bridges' are natural phrases a user working on this codebase would say, giving good keyword coverage. A few natural variations and synonyms are missing (e.g., 'extend', 'add a new extractor', 'OCR backend', 'post processor'), keeping it below the comprehensive-with-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The 'Xberg' qualifier plus the explicit negative boundary — 'not ordinary extractor parsing' — carves out a clear niche and actively prevents mis-triggering against an ordinary document-extraction skill, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 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

frontmatter_unknown_keys

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

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.