К основному содержанию
скилл CX Codex

verify-artifact — скилл для Claude Code: проверка файлов перед отправкой

Скилл verify-artifact проверяет целостность файла перед отправкой рецензенту или публикацией. Пересобирает из исходников, сверяет структуру и содержимое, ловит обрывы и расхождения нумерации.

MIT ★ 1 729 обновлён 2026-09-27

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pedrohcgs/claude-code-my-workflow --skill verify-artifact -a claude-code
Открыть на GitHub

Что делает verify-artifact

Скилл делает механическую проверку артефакта перед тем, как файл уйдёт из рук: пересобирает из исходников одной командой, проверяет размер и структуру, парсит (pdfinfo, pdftotext, JSON-парсер), считает страницы или записи, ищет незакрытые маркеры вроде ??, TODO, \ref{. Затем сверяет производный файл с исходником — перечисляет метки, номера разделов, таблиц, функций до и после трансформации.

Папки с облачной синхронизацией (Dropbox, iCloud, OneDrive) обезвоживают файлы: PDF может стать нулевым или обрезанным между сборкой и чтением. Скилл требует стейджить в локальную директорию и проверять там — Syntax Error: Couldn't find trailer dictionary на 70 КБ вместо 700 говорит об этом.

Просит получателя назвать имя файла, число страниц и версию в начале ответа — ловит старый кеш, неверное вложение или молчаливый откат к прошлой загрузке. Использует версионные имена (report_r6.pdf, а не report.pdf), чтобы система получателя не подсунула кешированную копию.

Какие задачи решает

  • проверить целостность PDF или CSV перед отправкой рецензенту
  • поймать обрыв содержимого в конце файла
  • сверить нумерацию разделов и таблиц после вырезания блока
  • убедиться, что файл из облачной папки не обезвожен
  • заставить получателя подтвердить, что он открыл нужную версию

Примеры запросов агенту

  • Пересобери paper.pdf из исходников, проверь размер и число страниц, посчитай незакрытые \ref{ и сверь нумерацию таблиц с paper.tex
  • Стейджи release.zip в локальную папку одной командой, проверь, что архив парсится, и сверь список файлов с манифестом
  • Проверь, что data_export.csv содержит все строки из исходной таблицы и не обрезан в конце

Как установить verify-artifact

1Через Skills CLI (Vercel)

npx skills add pedrohcgs/claude-code-my-workflow --skill verify-artifact -a claude-code

2Вручную: положить файлы

~/.claude/skills/verify-artifact/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/verify-artifact/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о verify-artifact

Как установить verify-artifact в Claude Code?

Выполни npx skills add pedrohcgs/claude-code-my-workflow --skill verify-artifact -a claude-code, затем открой ~/.claude/skills/verify-artifact/SKILL.md.

Что делает verify-artifact?

Пересобирает производный файл из исходников, проверяет его целостность (размер, структура, парсинг), сверяет нумерацию и метки с исходником, требует от получателя подтвердить имя и версию файла.

Зачем стейджить в локальную директорию?

Папки с облачной синхронизацией обезвоживают файлы между сборкой и чтением — PDF может стать нулевым или обрезанным. Локальная директория исключает это.

Исходный текст

SKILL.md · MIT
---
name: verify-artifact
description: Prove that the file you are about to send, publish, or hand off IS the thing you mean — before it leaves your hands. Rebuild from source, check integrity, diff the derived artifact against its source, and require the recipient to echo what they received. Use before sending a paper/PDF for review, shipping a release or replication package, handing files to a coauthor or collaborator, uploading anything to an external reviewer or model, or publishing. Prevents an entire review/QA cycle from being spent on defects that exist only in the artifact, not in the work.
allowed-tools: ["Read", "Grep", "Glob", "Bash", "Write"]
metadata:
  protocol: data-lineage
---


# Verify the artifact before it leaves

A review is only as good as the thing reviewed. If the artifact is corrupt, truncated, stale, or silently renumbered, a competent reviewer will return confident findings about defects **that do not exist in your work** — and you will spend a cycle chasing them. This is cheap to prevent and expensive to miss.

**Rule: never send a derived artifact you have not diffed against its source.**

## 1. Rebuild from source, in one shell invocation

Never send yesterday's build. Rebuild, then copy to the send location in the *same* command, so nothing can change underneath you.

Cloud-synced folders (Dropbox/iCloud/OneDrive) **dehydrate files**: a PDF can become 0 bytes or a partial copy between building and reading it. Symptoms: `Syntax Error: Couldn't find trailer dictionary`, a 70 KB file that should be 700 KB. Build-tool "up to date" messages are *not* evidence the file is intact — the tool checks timestamps, not content. Always stage to a local (non-synced) directory and verify there.

## 2. Integrity checks (mechanical, fast, non-negotiable)

- **Size and structure**: byte size in the expected range; page/record/row count as expected.
- **It parses**: open it with a real reader (`pdfinfo`, `pdftotext`, a JSON/CSV parser, `unzip -t`). A file that exists is not a file that works.
- **Sample the content**: first and last page/record actually contain what you expect — truncation shows up at the end.
- **Unresolved markers**: for documents, count `??`, `[cite]`, `TODO`, `XXX`, `\ref{` leftovers, "Chapter ??"; for code/data, NaNs, empty cells, placeholder values.

## 3. Diff the derived artifact against its source

This is the step people skip and the one that pays. If you produced the artifact by transforming, excerpting, compressing, or subsetting, then **enumerate what could have been lost** and check it:

- **Labels/anchors/IDs**: set of identifiers in source vs artifact. Anything defined in source and *referenced but missing* in the artifact is a break.
- **Numbering**: removing a numbered object silently renumbers everything after it, so a citation that was "Lemma 10" becomes "Lemma 6" — every downstream reference now points somewhere plausible and wrong. Check numbering stability, not just presence.
- **Counts**: sections, tables, figures, rows, functions, endpoints — before vs after.
- **Nested content**: excerpting a block can remove *statements* nested inside it, not just the prose you meant to cut.

If you cut anything, leave a visible in-artifact note saying so, so a reviewer does not read an omission as a gap.

## 4. Make the recipient prove what they got

Ask the reviewer (human or model) to **state, at the top of their response, the exact filenames, page/record counts, and version they are reviewing**. This catches stale caches, wrong attachments, and silent fallbacks to an older upload — failures that are otherwise invisible until the findings make no sense.

Use unique filenames per round (`report_r6.pdf`, not `report.pdf`). Repeated identical names invite the recipient's system to serve a cached earlier copy.

## 5. If findings look strange, suspect the artifact first

Before acting on a review, ask: could this finding be an artifact of what I sent? Signals: complaints about missing/undefined references, "sections appear truncated", "the proof ends mid-argument", numbering that does not match your copy, or objections to text you know is present. **Re-verify the artifact before you re-verify the work.** Applying "fixes" for artifact-induced findings actively damages correct material.

## Minimum checklist

1. Rebuild from source; stage to a local dir in the same shell command.
2. Verify it parses; check size, counts, first/last content.
3. Count unresolved markers — expect zero.
4. Diff identifiers/numbering/counts against source; note any deliberate omissions in the artifact itself.
5. Unique filename for this round.
6. Require the recipient to echo filename + counts.

## Cross-references

- [`verification-ladder.md`](../../references/verification-ladder.md) — rung 2 (existence → substantiveness → wiring → coherence)
- [`external-oracle-process.md`](../../references/external-oracle-process.md) §7 — cloud-synced files upload corrupt

© pedrohcgs · MIT · pedrohcgs/claude-code-my-workflow

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
verify sentimony Скилл verify проверяет выполнение всех обещаний и технических требований в проекте перед мержем или сдачей работы. Запускается при проверке состояния кода, когда нужно подтвердить готовность задачи. CX Codex +1 1 900установок ds-verify-loop aicodeking Скилл ds-verify-loop для Claude Code запускает проверку после правок и помогает исправлять причины ошибок по её выводу. Цикл заканчивается, когда проверка проходит или достигнут лимит попыток. CX Codex +1 589установок verify-counts ldayton Скилл verify-counts для Claude Code сверяет числовые утверждения в документации с реальными значениями и помечает устаревшие. Проверяет каждое утверждение командой: тесты через pytest, счётчики через Python и файловую систему. CX Codex +1 ★ 244звёзд репо verify-and-stop JuliusBrussee Скилл verify-and-stop подтверждает выполнение условий сдачи без раздувания правок. Помогает при финальной проверке тикета и точечном прогоне проверок. CX Codex +1 129 000установок principle-prove-it-works backnotprop Скилл principle-prove-it-works для Claude Code запрещает ассистенту закрывать задачу без проверки на реальном артефакте. Подключается перед сдачей работы. CX Codex +1 10 300установок verify-this cursor Скилл verify-this проверяет конкретное утверждение на локальных данных: снимает замеры до и после, сравнивает артефакты и выдаёт один вердикт. CX Codex +1 2 600установок

Из того же набора58

Весь набор →
visual-audit Скилл visual-audit ищет переполнение слайдов, шрифтовой разнобой и лишние плашки в Quarto и Beamer. Помогает проверить вёрстку презентаций до показа аудитории. CX Codex +1 ★ 1 729звёзд репо verify-claims Скилл verify-claims для Claude Code проверяет фактические утверждения в черновике через независимую верификацию. Проверяет цитаты, числа, данные исследований и заявления о публикациях. CX Codex +1 ★ 1 729звёзд репо validate-bib Скилл validate-bib сверяет ссылки в слайдах и документах с файлом библиографии. Находит пропущенные цитаты, дубликаты записей и ошибки в DOI. CX Codex +1 ★ 1 729звёзд репо vaccinate Скилл vaccinate проверяет, способен ли ревьюер или автоматический чекер находить ошибки, ради которых его запускают. Подходит для проверки контрольных процедур перед релизом или другим важным решением. CX Codex +1 ★ 1 729звёзд репо triage-inbox Скилл triage-inbox разбирает письма и календарь через MCP, раскладывает треды по категориям и предлагает одно действие на каждый. Ничего не отправляет само. CX Codex +1 ★ 1 729звёзд репо translate-to-quarto Скилл translate-to-quarto для Claude Code переносит лекции из LaTeX Beamer в Quarto RevealJS с сохранением структуры слайдов. Готовит учебные презентации к публикации в вебе без потери формул и графики. CX Codex +1 ★ 1 729звёзд репо teach-from-paper Скилл teach-from-paper для Claude Code превращает исследовательскую статью в план лекции, каркас слайдов, вопросы для обсуждения и набросок упражнений под заданный уровень аудитории. CX Codex +1 ★ 1 729звёзд репо syllabus Скилл syllabus превращает список тем или литературы в программу курса: описание, недели, цели, оценивание и политики. Пригодится преподавателям и ассистентам. CX Codex +1 ★ 1 729звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой