near/nearcore / .claude/skills/update-generated
update-generated
VerifiedRegenerate the checked-in artifacts (OpenAPI spec, insta snapshots, protocol schema). Use when the user asks to update generated files, refresh snapshots, bump the OpenAPI spec, or fix a protocol-schema-check failure.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.6 KB |
SKILL.md
View on GitHub---
name: update-generated
description: Regenerate the checked-in artifacts (OpenAPI spec, insta snapshots, protocol schema). Use when the user asks to update generated files, refresh snapshots, bump the OpenAPI spec, or fix a protocol-schema-check failure.
allowed-tools: Bash, AskUserQuestion
---
Update the generated artifacts tracked in this repo. Run each step from the repo root, in order. Stop and report on any failure.
## 1. OpenAPI spec
Generate into a tmp file first; only overwrite the tracked file if the generator succeeded.
```
tmp=$(mktemp)
cargo run -p near-jsonrpc-openapi-spec > "$tmp"
```
- If `cargo run` exits non-zero, delete `$tmp` and stop with the error.
- On success, move `$tmp` to `chain/jsonrpc/openapi/openapi.json`.
## 2. Insta snapshots
```
cargo insta test --accept -p near-parameters -p near-primitives
```
Stop on failure.
## 3. Protocol schema
Run the check and capture the exit code without aborting:
```
set +e
cargo run -p protocol-schema-check
schema_status=$?
set -e
```
- **0** — schema is up-to-date, nothing to do.
- **1** — schema drift. The regenerated schema is at `${CARGO_TARGET_DIR:-target}/protocol_schema.toml`. Before copying:
1. Show the user the diff against the tracked file:
```
git diff --no-index tools/protocol-schema-check/res/protocol_schema.toml \
"${CARGO_TARGET_DIR:-target}/protocol_schema.toml"
```
2. Use AskUserQuestion with options "Accept and copy" / "Abort" to confirm.
3. Only on confirmation, copy the regenerated file over `tools/protocol-schema-check/res/protocol_schema.toml`.
- **Any other code** — report the failure and stop; do not copy.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |