免费在 GitHub 公开

docs-validate

Validate the Mintlify docs site (docs/docs.json + docs/**/*.mdx) via `npx mint@latest validate`, plus a stale-.md-reference scan. Local pre-push gate; CI job docs (mint validate) runs the same script on push/PR. Not part of ./tools/check.sh. User-invocable only.

中文简介正在准备中。当前显示原文说明。

donaldfilimon/abi星标 19(GitHub 19 + cccskills 0)

实测评分未实测

查看安装方法

包含的文件（2）

SKILL.md2.4 KB
validate.sh286 B

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

docs-validate — Mintlify docs gate

Driver: .agents/skills/docs-validate/validate.sh (paths relative to repo root). Runs npx mint@latest validate against docs/docs.json + docs/**/*.mdx, then scans for stale .md references (the .md→.mdx link rot fixed in #651). Evidence is the RESULT: line.

Run (user path)

.agents/skills/docs-validate/validate.sh

Prints RESULT: PASS (exit 0) or RESULT: FAIL (exit 1) with the validator output.

Gates

Gate	Covers docs?
`./tools/check.sh`	No (Rust primary gate stays separate)
CI job docs (mint validate) (Node 22)	Yes — runs this script on push/PR
Local `validate.sh`	Yes — run after editing `docs/` before push

Mintlify also builds the hosted site via its GitHub app. This skill is disable-model-invocation: true (user-only) because it shells out to npx (network + package fetch).

Gotchas

⚠️ mintlify needs an LTS node — it hard-fails on node 25+. On a too-new node (e.g. this repo's dev host runs node 26) mint validate refuses to run. The driver detects this and prints RESULT: SKIP (exit 3) with a hint to select an LTS node via nvm/fnm — that's an environment issue, not a docs error.
Needs network — npx mint@latest validate fetches the mint package on first run. Offline → it fails at fetch (a tooling/env failure, not a docs failure).
Mintlify config is docs/docs.json — the driver cds into docs/; run it from anywhere in the repo.
The stale-.md scan is a heuristic (nav/link entries ending in .md); treat hits as "verify these resolve," not hard failures — the mint validate result is authoritative.

Troubleshooting

Symptom	Fix
`npx not on PATH`	Install Node/npm; `mint` runs via `npx`.
fails at fetch / offline	Environment has no network — retry where npx can reach the registry.
`no docs/docs.json found`	You're not in the abi repo, or the docs site moved.
validation errors	Fix the reported `docs/docs.json`/`.mdx` issue; re-run. Preview locally with `npx mint@latest dev`.

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能

abbey-system-prompt

免费

Maintain the Abbey / Aviva / Abi Discord system prompts in the Rust abbey-bot (`src/ask.rs`) and keep the hosted Grok bots (Grok Bot Abbey, Aviva Grok) in step with them. Use when the user says "improve grok bots", "abbey prompt", "persona prompt", "ask.rs", "system prompt", "tip floor", asks to change how Abbey/Aviva/Abi speak on Discord, or after an abbey-bot PR merges and the hosted bot's tip floor needs bumping. Runs as /abbey-system-prompt.

中文简介正在准备中。当前显示原文说明。