본문으로 건너뛰기
cccskills
무료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(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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

GateCovers docs?
./tools/check.shNo (Rust primary gate stays separate)
CI job docs (mint validate) (Node 22)Yes — runs this script on push/PR
Local validate.shYes — 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

SymptomFix
npx not on PATHInstall Node/npm; mint runs via npx.
fails at fetch / offlineEnvironment has no network — retry where npx can reach the registry.
no docs/docs.json foundYou're not in the abi repo, or the docs site moved.
validation errorsFix the reported docs/docs.json/.mdx issue; re-run. Preview locally with npx mint@latest dev.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

donaldfilimon/abi192026년 10월 27일 업데이트

Validate ABI docs and external collateral against repo evidence and docs/contracts/external-claims-audit.mdx. Use when auditing claims, scanning docs for unsupported QPS/sharding/FHE/AES language, checking one claim before publish, or re-confirming the external-claims audit. Agent procedure only — not a CLI or slash command. Pair with abi-doc-claims-sync when editing docs.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

donaldfilimon/abi192026년 10월 27일 업데이트

Synchronize ABI Markdown and docs claims with executable behavior. Use before editing README, AGENTS.md, CLAUDE.md, GEMINI.md, docs/**/*.mdx, walkthroughs, changelogs, or any old ABI Markdown that mentions WDBX, MCP, GPU, clustering, compression, FHE, agents, or benchmarks.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

donaldfilimon/abi192026년 10월 27일 업데이트

Plan and execute ABI repo work from the TODO board, roadmap/spec docs, stable Rust 1.99.1 constraints, and validation gates. Use when the user asks to find ABI todos/roadmaps, organize a large implementation from tasks/todo.md, or decide the next safe work slice. Distinct from the goals skill — that skill owns the persistent ledger tasks/goals.md; this skill plans from the active board and north-star specs.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

donaldfilimon/abi192026년 10월 27일 업데이트

Validate ABI MCP JSON-RPC stdio and its custom loopback HTTP compatibility endpoint, including auth, limits, notifications, and shutdown.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

donaldfilimon/abi192026년 10월 27일 업데이트

Review ABI's 16 compiled-in plugin fixtures, manifest validation, manual bundled registry, and real CLI/MCP run dispatch without claiming dynamic loading.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

donaldfilimon/abi192026년 10월 27일 업데이트

donaldfilimon의 스킬 모두 보기

이 스킬의 문제 신고