CtrlK
BlogDocsLog inGet started
Tessl Logo

feature-flag-policy

Cargo feature flags for crates/xberg — ORT-incompatible targets (WASM, Android x86_64 emulator), type-only and tract inference companion features, WASM/Android-safe variants, PDF backend, mutually-exclusive ORT variants, platform-conditional deps, aggregate feature sets, and build profiles. Load when adding, wiring, or debugging a Cargo feature, or when reasoning about what compiles on WASM/Android/Windows/macOS-intel targets.

71

Quality

88%

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

76%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 high-signal reference document: every line carries repo-specific policy that Claude could not infer, with exact commands, tables, and failure consequences. Its weaknesses are structural rather than informational — the 'add a feature' workflow is never sequenced, key content is duplicated between prose and tables, and the single file is starting to accumulate content that could live in reference files.

Suggestions

Add a short numbered 'Adding or changing a feature' workflow near the top that sequences the existing guidance: check WASM/Android compatibility against the ORT-incompatible list, decide on type-only/tract companions, update every relevant aggregate (with the full→windows-target parity consequence), then run `task verify:feature-parity` before finishing.

Remove the duplication between the inline wasm-target/android-target composition in the ORT-incompatible-targets section and the Aggregate Sets table — state each set's membership exactly once and cross-reference it.

Move the CI parity-guard detail (guarded-pairs table, UNGUARDED rationale, script mechanics) into a reference file (e.g. references/feature-parity.md) and keep a two-line summary plus the command in SKILL.md, restoring a lean overview page.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious repo facts ("no pyke prebuilt" for the x86_64 emulator, the jsDelivr 50 MB cap, "opt-level=2 still SIGBUS'd in go:e2e", "pdf_oxide" rejected not aliased) and explains nothing Claude already knows — matching the score-5 anchor's assumption of competence. It falls one notch below 5 due to verbatim duplication: the wasm-target composition ("no-ort-target + excel-wasm + ocr-wasm + layout-tract + auto-rotate-tract + ner-candle-wasm ... no tree-sitter") appears both inline and again in the aggregate table, and the long android-target member list is inlined in two places.

4 / 5

Actionability

Guidance is fully concrete and executable: the exact CI command (`task verify:feature-parity` / `python3 scripts/ci/check-feature-parity.py crates/xberg/Cargo.toml`), exact feature algebra (`pdf = ["pdf-native"]`), exact config location (`core/config/pdf.rs`), a table of guarded pairs with allowed deltas, and explicit consequences ("adding a feature to `full` without adding it to `windows-target` fails CI"). Per the rubric's instruction-only note, the absence of code is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

The primary use case promised by the description — adding or wiring a feature — is a multi-step process (assess WASM/Android safety, pick type-only/tract companions, update the relevant aggregates, run the parity guard, check profile implications), but the body never assembles these into a sequence. All the pieces, including a real validation mechanism, are present yet scattered across sections, matching the score-3 anchor ('sequence present but checkpoints missing or implicit') rather than score 4's clear sequence.

3 / 5

Progressive Disclosure

No bundle files exist, so this is a single-file skill; its section headers (ORT-Incompatible Targets, PDF Backend, ORT Variants, Platform-Conditional, Aggregate Sets, CI parity guard, Build Profiles) make it navigable and every repo-file pointer (crates/xberg/Cargo.toml, scripts/ci/check-feature-parity.py) is real and clearly signaled. It sits at score 4 rather than 5 because at 115 lines some self-contained blocks — the CI parity-guard tables and the long aggregate member lists — are inlined where a one-level-deep reference file would keep the overview leaner, and the under-50-line simple-skill exception does not apply.

4 / 5

Total

16

/

20

Passed

Description

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

An exemplary skill description: third-person, specific, and complete, pairing a comprehensive 'what' enumeration with an explicit 'Load when...' trigger clause covering the natural phrasings a user of this repo would say. No padding or buzzwords despite the breadth.

DimensionReasoningScore

Specificity

The description enumerates multiple specific, concrete capability areas — "ORT-incompatible targets (WASM, Android x86_64 emulator)", "type-only and tract inference companion features", "WASM/Android-safe variants", "PDF backend", "mutually-exclusive ORT variants", "platform-conditional deps, aggregate feature sets, and build profiles" — comprehensively mirroring every section of the body. It is well above the score-4 anchor ('several specific actions; minor gaps') because coverage is complete for the skill's scope with no vague filler.

5 / 5

Completeness

Both 'what' (first sentence enumerating the feature-flag policy scope) and 'when' ("Load when adding, wiring, or debugging a Cargo feature, or when reasoning about what compiles on ... targets") are explicit with concrete trigger phrases. This is the exact structure of the score-5 anchor example.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are covered: "adding, wiring, or debugging a Cargo feature", "reasoning about what compiles on WASM/Android/Windows/macOS-intel targets", plus synonyms ("feature flags" / "Cargo feature") and platform keywords. It matches the score-5 anchor's comprehensive coverage including synonyms; the score-4 anchor ('a few natural terms missing') understates the breadth.

5 / 5

Distinctiveness Conflict Risk

The niche is sharply distinct — "crates/xberg", ORT vs tract inference, Android x86_64 emulator, jsDelivr-scale WASM constraints — terms no other generic Cargo or feature-management skill would claim. Minimal conflict risk, matching the score-5 anchor.

5 / 5

Total

20

/

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: 1 missing, 1 deeper-than-1-level

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.