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

sk-facts — скилл для Claude Code: проверка фактов

Скилл sk-facts для Claude Code проверяет фактические утверждения и сохраняет результаты исследования в реестр. Включается для поиска источника, проверки числа или лицензии изображения.

MIT ★ 204 обновлён 2026-11-09

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

Что делает sk-facts

Скилл ищет утверждения в docs/facts/facts.json, проверяет их по источникам и записывает факты в facts.json, а сведения об источниках — в sources.json. Для каждого утверждения фиксируются статус и оговорка; изображения, видео, шрифты и музыка получают записи с точной лицензией. Фактические строки в narration.json связываются с ID записей.

Перед записью нужно прочитать схему из docs/facts/README.md. Проверка запускается командами bun run facts и bun run lint <id>; для них требуется Bun. Непроверенное утверждение линтер блокирует, а спорное допускается с оговоркой.

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

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

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

  • Проверь, верно ли это утверждение, и найди первичный источник.
  • Добавь число в реестр фактов и укажи его оговорку.
  • Можно ли использовать это фото? Найди лицензию и запиши источник.

Как установить sk-facts

1Через Skills CLI (Vercel)

npx skills add howznguyen/shorts-kit --skill sk-facts -a claude-code

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

~/.claude/skills/sk-facts/SKILL.md

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

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

Вопросы о sk-facts

Как установить sk-facts в Claude Code?

Выполни npx skills add howznguyen/shorts-kit --skill sk-facts -a claude-code. Файл скилла устанавливается по пути ~/.claude/skills/sk-facts/SKILL.md.

Что делает sk-facts?

Скилл проверяет фактические утверждения, записывает их статус и источники в файлы реестра. Он также фиксирует лицензии медиафайлов и связывает факты со строками озвучки.

Как sk-facts проверяет готовый реестр?

bun run facts проверяет схему и ссылки на источники, а bun run lint <id> — записи фактов, используемые в видео. Для спорного факта нужна оговорка.

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

SKILL.md · MIT
---
name: sk-facts
description: Researches, verifies and records the factual claims of a short in the fact ledger (docs/facts/facts.json and sources.json), including the licence of every image, clip and dataset. Use when the user says "check this fact", "is this true", "find a source for", "research the topic", "add to the ledger", "where does this number come from", "can I use this photo", or when lint reports a missing or unverified fact. Step 2 of sk-pipeline, and the step to return to whenever a number changes.
---

# sk-facts: source, verify, record

**Announce:** "Using sk-facts for <topic>."

Rules: §9 (`docs/soul/07-facts.md`); schema in `docs/facts/README.md`. Read the
schema before writing the first record. The § wins over this file.

**Core principle: research that exists only in prose cannot be re-checked.** The
output of this skill is records in two files, not a paragraph in a brief:

- `docs/facts/facts.json`: one record per claim:
  `{ "id": "f-0001", "claim", "value", "status": "verified|contested|unverified", "sources": ["s-0001"], "caveat", "checkedAt": "YYYY-MM-DD" }`
- `docs/facts/sources.json`: one record per source:
  `{ "id": "s-0001", "title", "url", "publisher", "licence", "accessed": "YYYY-MM-DD" }`

## Steps

1. **Search the ledger before researching.** `grep -i "<keyword>" docs/facts/facts.json`.
   Re-researching a claim already recorded wastes a session; re-using a claim
   already found wrong is worse.
2. **Split the claim from the number.** Write it as subject, measure, where, when
   ("river X, width, at point Y, dry season"). A claim that cannot be pinned to a
   place and a time is not checkable: pin it or cut it.
3. **Source in tiers.**
   1. Primary or institutional: the original paper, agency, statistics office,
      official record, the document itself.
   2. Encyclopaedic: follow through to *its* citation and read that.
   3. Popular articles and listicles: use them only to find candidates. Two
      tier-3 sources agreeing is still tier 3.
   Follow laundered claims to the end. Ten blogs copying each other are one
   source; if the chain ends at nothing, drop the claim.
4. **Read the original wording yourself.** Summarisers and extraction tools keep
   the number and drop the hedge: "probably reduced" becomes "reduced". That turns
   a model estimate into a measurement, and nothing downstream catches it because
   the number is still right. `claim` and `caveat` are written from text you read.
5. **Flag hypotheses as hypotheses.** Superlatives ("largest", "only", "first")
   almost always have a competing definition: state it or drop the superlative.
   "Recently discovered" and anniversaries: check the year.
6. **Write the record, whatever the answer.**
   | status | meaning | on screen |
   |---|---|---|
   | `verified` | you read it in the original | yes |
   | `contested` | real but sources disagree, or common phrasing is wrong | only with a `caveat`, and say it in the caption (`sk-handoff`) |
   | `unverified` | not checked yet | no; lint blocks it |
   A claim you proved wrong is still worth a record with a `caveat` saying so: a
   popular belief that is false is often the best hook, and the record stops
   someone re-researching it later.
7. **Record every image, clip, font and music track as a source** with its exact
   `licence` string (e.g. "CC BY 4.0", "public domain", "CC0", "licensed: <terms>").
   Take attribution text verbatim from the provider; it often carries a year or
   author that is part of the requirement. Prefer public domain and CC0; CC BY
   needs a credit line (on screen or in the pinned comment). Never use imagery
   whose terms you have not read, including map tiles and stock sites' previews.
8. **Link narration lines to facts.** Each line that states a fact carries
   `"fact": "f-xxxx"` in `src/videos/<id>/narration.json`.
9. **Validate.**
   ```bash
   bun run facts        # ledger schema, ids, source references
   bun run lint <id>    # every referenced fact exists and is verified (contested needs caveat)
   ```

## Verify

- [ ] ledger searched before researching
- [ ] every on-screen or spoken number has a `verified` record (or `contested` + caveat)
- [ ] no claim rests only on a tier-3 source
- [ ] every `url` in sources.json was actually opened this session
- [ ] every image and audio asset has a source record with a licence
- [ ] `bun run facts` exits clean, with no new warnings
- [ ] anything that could not be verified was cut, not softened into vagueness

Next: back to `sk-brief` (or `sk-narration` if the brief exists).

© howznguyen · MIT · howznguyen/shorts-kit

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

Каталог скиллов SKILL.md →
facts backnotprop Скилл facts для Claude Code кратко сводит ключевые факты о планируемой или завершённой работе. Он включается только по явному вызову $facts. CX Codex +1 587установок ERP Facts Jaikin-SASU MCP-сервер ERP Facts для Claude Code предоставляет агенту проверяемые сведения о продуктах ERP, сроках поддержки и электронных счетах. Помогает сравнивать системы и планировать переход на Odoo 20. CX Codex +1 Leonida Lab: GTA 6 facts, official or not LeonidaLab Leonida Lab: GTA 6 facts, official or not — MCP-сервер для Claude Code, который отвечает на вопросы о GTA 6 фактами со статусом: официальными, из прессы или не объявленными. CX Codex +1 find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок grill-me Matt Pocock Скилл grill-me проводит жёсткое интервью по плану или дизайну, чтобы найти пробелы и уточнить решения. Подойдёт перед началом разработки. CX Codex +1 1 424 476установок

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

Весь набор →
sk-brief Скилл sk-brief для Claude Code готовит бриф для короткого видео: формулирует идею, выбирает сюжетный ход и визуальный стиль. Проверка лицензий изображений проходит до написания сценария. CX Codex +1 ★ 204звёзд репо sk-style Скилл sk-style для Claude Code правит формулировки в устном сценарии короткого видео, сохраняя смысл. Запускается по просьбе сделать текст короче, живее или убрать фразы, похожие на машинные. CX Codex +1 ★ 204звёзд репо sk-render Скилл sk-render для Claude Code рендерит короткие видео в MP4, нормализует громкость и готовит файл к загрузке. Запускается по просьбам отрендерить ролик, исправить тихий звук или проверить повреждённый файл. CX Codex +1 ★ 204звёзд репо sk-narration Скилл sk-narration для Claude Code пишет и правит сценарий короткого видео, создаёт озвучку и запускает проверку. Срабатывает на просьбы изменить текст, произношение или голос, а также на ошибки проверки сценария. CX Codex +1 ★ 204звёзд репо sk-handoff Скилл sk-handoff для Claude Code готовит обложку, файл для загрузки, подпись и закреплённый комментарий к короткому видео. Запускается по просьбе подготовить ролик к публикации или сделать обложку, подпись либо кредиты. CX Codex +1 ★ 204звёзд репо sk-scene Скилл sk-scene для Claude Code собирает и правит визуальные сцены коротких видео в Remotion. Запускается при запросах собрать кадры, поправить подпись, анимацию или компоновку. CX Codex +1 ★ 204звёзд репо sk-promo Скилл sk-promo для Claude Code создаёт рекламные ролики, тизеры и фильмы о запуске продукта. Задаёт формат 9:16 или 16:9 и проводит проект через сценарий, раскадровку, проверку и экспорт. CX Codex +1 ★ 204звёзд репо sk-pipeline Скилл sk-pipeline для Claude Code ведёт вертикальный ролик от идеи до файлов для публикации. Включается при создании нового видео, монтаже исходников или продолжении незавершённого проекта. CX Codex +1 ★ 204звёзд репо

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

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