CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

run-apichief

Run ApiChief in the EF Core repo to emit baselines, summaries, deltas, review files, or breaking-change checks. Use when refreshing `*.baseline.json`, preparing API review artifacts, or validating API changes.

73

Quality

92%

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

90%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 lean, highly actionable skill body: copy-paste-ready commands for every operation, a sensible default ('Default to `emit baseline`'), and careful handling of repo conventions (BOM, version-only diffs, baseline comments). The main improvements are adding an explicit feedback loop after baseline regeneration and splitting a small amount of detail into bundle files.

Suggestions

Add a validation feedback loop after 'emit baseline': e.g., re-run `check breaking` or the EFCore.ApiBaseline.Tests suite, and state what to do if the step-6 review uncovers unwanted changes (fix and regenerate).

Move the TFM-locating PowerShell block (step 4) into a `scripts/` bundle file (e.g., `scripts/find-tfm.ps1`) to slim the main body and make it reusable.

Trim the duplicated build guidance between steps 2 and 3 (the ApiChief build line appears twice) into a single callout.

DimensionReasoningScore

Conciseness

The body is dense and operational — a command table, environment init snippets, and copy-paste invocations — with no explanation of concepts Claude already knows. Every section (build, locate binary, run, review, report) earns its tokens; the Bash/PowerShell duplication is justified because both entry points are used, matching the anchor 'Lean and efficient; every token earns its place' rather than score 4's 'minor instances of over-explanation'.

5 / 5

Actionability

Every step provides fully executable commands: restore/activate/build lines, an msbuild TargetPath lookup, TFM selection pipeline, and concrete `& $dotnet $apiChief ...` invocations covering all five commands from the table. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'; there is no pseudocode or missing key detail that would justify score 4.

5 / 5

Workflow Clarity

A clear 7-step sequence with concrete commands per step and post-run checkpoints (step 6 reviews/cleans baseline changes, step 7 mandates reporting pass/fail and exit-code meanings; step 1 routes baseline-only requests to the EFCore.ApiBaseline.Tests suite). It falls short of score 5 because there is no explicit validate-and-retry loop after baseline regeneration — the review guidance is a checklist but never states what to do when a review uncovers a problem.

4 / 5

Progressive Disclosure

The skill is self-contained (no bundle files exist) and well-organized with a command table and clearly headed workflow sections, and its one reference (`eng/Tools/ApiChief/README.md`) is a well-signaled repo path. However, at ~130 lines it exceeds the 'simple skill' threshold where inline-only structure scores 5, and detail like the TFM-locating PowerShell block could plausibly live in a `scripts/` file — matching score 4's 'most content is appropriately placed; minor organization gaps' rather than score 5.

4 / 5

Total

18

/

20

Passed

Description

92%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-style imperative, concise, with concrete capability enumeration and an explicit 'Use when...' clause. The only gap is modest trigger-term coverage — a few natural synonyms (e.g., 'public API', 'API diff') would make it fully comprehensive.

Suggestions

Add one or two natural synonyms such as 'public API' or 'API diff' to the trigger phrases to broaden match coverage.

Mention the bare file pattern '.baseline.json' without glob syntax so users who type the extension verbatim still match.

DimensionReasoningScore

Specificity

The description enumerates five concrete actions — 'emit baselines, summaries, deltas, review files, or breaking-change checks' — giving comprehensive, non-generic coverage of the tool's capabilities. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; it is not score 4 because no meaningful capability gaps remain.

5 / 5

Completeness

It explicitly answers both questions: what ('Run ApiChief in the EF Core repo to emit baselines, summaries, deltas, review files, or breaking-change checks') and when ('Use when refreshing `*.baseline.json`, preparing API review artifacts, or validating API changes'). This is a direct match to the score-5 anchor with concrete trigger phrases, and clearly above score 4 where the 'when' is weaker or less specific.

5 / 5

Trigger Term Quality

Triggers like 'refreshing `*.baseline.json`', 'preparing API review artifacts', 'validating API changes', and 'breaking-change' are natural phrases a user would say. It falls short of score 5 because common synonyms and variations such as 'public API', 'API diff', or '.baseline.json' as a plain file mention are absent.

4 / 5

Distinctiveness Conflict Risk

It names a specific tool ('ApiChief') scoped to a specific repo ('EF Core repo') with distinct triggers, so it occupies a clear niche with minimal conflict risk against other skills. It is not score 4 because nothing in the phrasing overlaps with broader skills.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

dotnet/efcore

Path

.agents/skills/run-apichief/SKILL.md

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.