askit-build-sampleslisted
Install: claude install-skill product-on-purpose/agent-skills-toolkit
# askit-build-samples
## Purpose
Author and validate the evidence a skill carries, following the builder pattern ([../../docs/reference/builder-pattern.md](../../docs/reference/builder-pattern.md)). `create` generates a skill's samples (at least 3 golden examples plus at least 1 anti-example, Standard sec 7.2) under `examples/`, and its triggering eval set (at least 20 `{query, should_trigger}` cases, sec 8.3) plus any chain/hook behavior cases under `evals/` in the eval-set format the G3 `library-regression` check and the `askit-evaluate` behavioral mode consume. `validate` detects drift: a sample or eval that no longer matches the skill's current behavior is an error, not a silent staleness. Format and the example-threads convention are in [references/samples-format.md](references/samples-format.md).
## When to use
When generating samples or an eval set for a skill, or checking existing samples and evals for drift after a behavior change.
## create mode
1. Read the target skill (its description, triggers, and behavior).
2. Generate `examples/` golden samples (>= 3 realistic input/output pairs) and an anti-example (>= 1 case the skill should NOT handle), per sec 7.2.
3. Generate `evals/<name>.eval.json`: a triggering set of >= 20 `{query, should_trigger}` cases (fires when it should, silent when it should not, sec 8.3), plus `{given, expect}` behavior cases for any chain the skill participates in (so the G3 check finds coverage).
## validate mode
1. Re-run the samples an