CtrlK
BlogDocsLog inGet started
Tessl Logo

tidb-bazel-prepare-gate

Use when deciding whether make bazel_prepare is required before build or test commands based on local file changes in TiDB.

68

Quality

85%

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

86%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 tight, executable gate skill: it gives exact inspection commands, concrete diff patterns to match, and an explicit run/skip decision with evidence reporting. Its only weaknesses are minor — slight duplication of the AGENTS.md policy pointer and the two `git diff -U0` command references, and full reliance on an external AGENTS.md section for the complete trigger-condition list.

DimensionReasoningScore

Conciseness

The body is lean — copy-paste git commands and short pattern examples with no concept explanations Claude already knows. It falls short of anchor 5 only through minor repetition: the policy pointer "`AGENTS.md` -> `Build Flow` -> ..." appears twice (Overview and Decision Rules), and the `git diff -U0 -- '*.go'` commands are restated twice in the Decision Rules section, which could be trimmed to a single reference.

4 / 5

Actionability

Everything is executable: a copy-paste-ready bash block of git inspection commands, concrete diff patterns to match ('+func TestXxx(t *testing.T) {' and added/removed import lines), and an explicit decision outcome ("If any condition matches, run `make bazel_prepare`" / "continue without ... and report the evidence"). This matches anchor 5 — fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

The sequence is clear — inspect local changes, compare against decision rules, then run or skip with evidence reporting — and the decision checkpoint is explicit. It does not reach anchor 5 because the full set of trigger conditions is delegated to an external location ("`AGENTS.md` -> `Build Flow` -> 'When make bazel_prepare is required'") rather than stated or summarized inline, leaving a minor validation gap if that section is unavailable or changed.

4 / 5

Progressive Disclosure

This is a short (under 50-line) single-purpose skill with no bundle files (no references/, scripts/, or assets/ directories exist) and no content that belongs in separate files. Per the simple-skill guideline, well-organized sections (Overview, Inspect Local Changes, Decision Rules) are sufficient for anchor 5.

5 / 5

Total

18

/

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 single-purpose gate description: it states both what it does and when to use it, uses third-person phrasing, names the exact make target and decision basis, and is tightly scoped to TiDB so conflict risk is minimal. The main improvement would be including the concrete trigger phrases (new test functions, import-section changes) that live only in the body.

DimensionReasoningScore

Specificity

The description names a concrete, single-purpose action — "deciding whether make bazel_prepare is required before build or test commands based on local file changes in TiDB" — with a specific make target, context (build/test), and input basis (local file changes). It stays above the anchor-3 example ('Names domain and 1-2 concrete actions, but not comprehensive') because the one action named is precisely scoped rather than generic, but it does not list multiple distinct actions, so it falls short of anchor 5.

4 / 5

Completeness

Both parts are explicitly present: what ("deciding whether make bazel_prepare is required") and when ("before build or test commands based on local file changes in TiDB"). It does not reach anchor 5 because the when-clause, while reasonably concrete, does not state the concrete trigger phrases users would say (e.g. new test functions or import changes), and the consequence of the decision is left implicit — matching anchor 4 ('when' could be more explicit or specific).

4 / 5

Trigger Term Quality

Natural trigger phrases a TiDB developer would actually say are present: "make bazel_prepare", "build or test commands", "local file changes", "TiDB". Coverage is good but misses common variations a user might mention, such as 'go test', 'compile', '_test.go', or 'imports', which appear only in the body — so it matches anchor 4 ('Good keyword coverage; a few natural terms missing') rather than 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — the TiDB-specific `make bazel_prepare` build gate — with triggers tied to a named make target and repository, making it highly unlikely to fire for any other skill. This matches anchor 5 ('Clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

17

/

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
pingcap/tidb
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.