CtrlK
BlogDocsLog inGet started
Tessl Logo

alef-generated-bindings

Alef-managed generated bindings in packages/* and binding crates — the regeneration workflow (task alef:generate / alef:verify), the alef.toml section layout, the core-side edits that break a regen, and the FFI bridge's JSON marshalling requirement. Load before editing anything under packages/* or a binding crate, before adding a trait method or extractor, or when regenerating or verifying Alef output.

78

Quality

98%

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

96%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, high-value body: all content is non-derivable project knowledge delivered as executable commands with a validated workflow and strong diagnostic guidance. The only weakness is that everything lives inline in SKILL.md rather than splitting the alef.toml layout and FFI-bridge details into one-level-deep reference files.

Suggestions

Move the 'Key alef.toml sections' enumeration into a references/alef-toml.md file and keep a 2-3 line summary with the non-negotiable facts (no rename mappings, no legacy tables) inline.

Consider moving the FFI-bridge marshalling detail (JSON marshalling, Default fallback, header-churn caveat) into references/ffi-bridge.md, linked from a one-line pointer in the main body.

DimensionReasoningScore

Conciseness

Every line is project-specific, non-derivable fact — exact commands, paths, hash files, error codes (E0639), and attribute forms — with zero padding or explanation of concepts Claude already knows. It matches 'lean and efficient; every token earns its place'; anchor 4 would require trimmable over-explanation, and none is evident.

5 / 5

Actionability

Guidance is fully executable throughout: "task alef:generate → alef all --clean", "alef verify --exit-code", "cargo check -p xberg-ffi", "cargo install --path . --force", the exact attribute "#[cfg_attr(alef, alef(skip))]" with placement guidance, and canonical task enumerations. This meets 'copy-paste ready commands covering the common cases' — anchor 5, not 4, since there are no gaps in the core workflow.

5 / 5

Workflow Clarity

The 6-step workflow is clearly sequenced with explicit validation checkpoints (alef:verify, e2e:generate then e2e:test) and an atomic-commit instruction, plus a diagnostic feedback loop ("Check this first when a regen dies") and a corrective path ("Fix alef.toml or the Rust source, then regenerate and re-verify"). The batch regen operation is validated, so the ≤3 cap for unvalidated batch operations does not apply.

5 / 5

Progressive Disclosure

The body is well-sectioned with clear headers (Workflow, Freshness check, alef.toml sections, breaking edits, FFI bridge), but ~85 dense lines are all inline with no bundle files — the alef.toml section enumeration and FFI-bridge marshalling detail would fit naturally in one-level-deep references/*. Not 5 because the <50-line simple-skill exception doesn't apply and no external references exist to signal; not 3 because structure and content placement are otherwise appropriate and navigable.

4 / 5

Total

19

/

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 description: it states concrete capabilities with exact task names and file paths, gives explicit load conditions in the user's natural phrasing, and occupies a niche with essentially no conflict risk. No changes needed.

DimensionReasoningScore

Specificity

The description enumerates four concrete capabilities with exact task names — "the regeneration workflow (task alef:generate / alef:verify)", "the alef.toml section layout", "the core-side edits that break a regen", and "the FFI bridge's JSON marshalling requirement" — with comprehensive coverage and no filler. It clearly matches the anchor-5 example rather than anchor 4, which requires minor coverage gaps that are absent here.

5 / 5

Completeness

Both 'what' (the four named topics) and 'when' ("Load before editing anything under packages/* or a binding crate, before adding a trait method or extractor, or when regenerating or verifying Alef output") are explicit and concrete, mirroring the anchor-5 example structure. Not 4, because the 'when' clause is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

Natural phrases a user would actually say are covered: "editing anything under packages/* or a binding crate", "adding a trait method or extractor", "regenerating or verifying Alef output", plus concrete artifacts (packages/*, alef.toml, task names). This matches the comprehensive anchor including file-path/glob variants; nothing obvious is missing within this niche domain.

5 / 5

Distinctiveness Conflict Risk

A clear niche — Alef-managed generated bindings for a specific workspace — with distinct triggers (alef:*, alef.toml, binding crates) and minimal realistic conflict with other skills. Anchor 5 fits; there is no overlap risk with broader document- or code-skills.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.