sk-facts — скилл для Claude Code: проверка фактов
Скилл sk-facts для Claude Code проверяет фактические утверждения и сохраняет результаты исследования в реестр. Включается для поиска источника, проверки числа или лицензии изображения.
MIT ★ 204 обновлён 2026-11-09
npx skills add howznguyen/shorts-kit --skill sk-facts -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/sk-facts/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sk-facts/
1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-facts -a codex2Вручную: положить файлы
.agents/skills/sk-facts/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-facts -a cursor2Вручную: положить файлы
.cursor/skills/sk-facts/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install howznguyen/shorts-kit .claude/skills/sk-facts2Вручную: положить файлы
.github/skills/sk-facts/SKILL.md1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-facts -a gemini-cli2Командой платформы
gemini skills install https://github.com/howznguyen/shorts-kit --path .claude/skills/sk-factsВручную: положить файлы
.devin/skills/sk-facts/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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