agentleFS
matvej-melikhovmatvej-melikhov/karpathy-llm-wiki/.claude/skills/transcribe/SKILL.md

transcribe

Skill2 starsChanged 6 months agoMITView on GitHub

Преобразует бинарные источники (PDF, DOCX) в качественный markdown. Двухшаговый pipeline: механическая конвертация через библиотеки (Step 1) + агентское восстановление структуры (Step 2). Результат сохраняется в raw/ как обычный .md-источник для дальнейшего ingest. Может вызываться самостоятельно или автоматически из ingest при обнаружении бинарного источника. Триггеры: /transcribe, transcribe, convert pdf, преобразуй pdf, конвертируй документ, transcribe this file, обработай этот документ.

51 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use talking-head-cards, spreadsheet and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • aya-talebSkill

    talking-head-cards

    Add timed graphic cards over a talking-head, podcast or interview clip, each one popping up as the speaker says the point: key ideas, numbers, terms, short lists, pull quotes. Plans the cards from the transcript, checks every card against what was actually said (no invented numbers or quotes), keeps them clear of the face and the app buttons, and renders locally with ffmpeg for free. Use it for "add text pop-ups to my video", "make my talking head more visual", "put the key points on screen", "b-roll text cards", "lower thirds", "make this podcast clip look like a pro edit", "overlay graphics synced to what I say", or after transcribe when the user wants the clip to hold attention.

    Also in 3 projects that use this

  • JetBrainsSkill

    spreadsheet

    Use when tasks involve creating, editing, analyzing, or formatting spreadsheets (`.xlsx`, `.csv`, `.tsv`) with formula-aware workflows, cached recalculation, and visual review.

    Also in 3 projects that use this

  • vltingSkill

    think

    Lightweight plan-to-execution pipeline. Explores codebase, runs council deliberation, presents plan for approval, then executes via /run.

    Also in 3 projects that use this

  • robzolkosSkill

    done

    Reset the working directory for the next task by ensuring no uncommitted changes exist, then switching to the main branch and pulling latest.

    Also in 3 projects that use this

  • eherrerosjSkill

    humanize

    Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive 'Signs of AI writing' guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases. Triggers on: 'humanize', 'make this sound human', 'remove AI writing', 'de-AI', 'sound more natural', 'less robotic', 'too AI-sounding', or when reviewing text that reads like AI output.

    Also in 3 projects that use this

  • AnthropicSkill

    onboarding

    Generate an onboarding checklist and first-week plan for a new hire. Use when someone has a start date coming up, building the pre-start task list (accounts, equipment, buddy), scheduling Day 1 and Week 1, or setting 30/60/90-day goals for a new team member.

    Also in 3 projects that use this

The file

Files
SKILL.md

transcribe: конвертация бинарных источников в markdown

Превращает PDF или DOCX в читаемый структурированный markdown, пригодный для synthesis через ingest. Оригинальный файл уходит в raw/formats/, восстановленный .md — в raw/.


Команды и флаги

КомандаПоведение
/transcribe <file>Полный pipeline: Step 1 + Step 2 (restore)
/transcribe --no-restore <file>Только Step 1 (для документов >100 страниц)
/transcribe --ingest <file>Pipeline + автоматически вызвать /ingest на результате

Pipeline

Пользователь даёт файл (PDF/DOCX)
         ↓
[Проверка расположения]
  Не в raw/formats/ → переместить туда
         ↓
Step 1а: bin/transcribe.py raw/formats/<file>
  → манифест изображений в stdout (JSON)
  → изображения сохранены в _attachments/
         ↓
Step 1б: Read tool на исходном файле
  → агент видит весь контент нативно:
    текст, формулы LaTeX, таблицы, списки
         ↓
Step 2: агент пишет качественный markdown
  (если ≤100 страниц — полное восстановление)
  → сохраняет raw/<stem>.md
         ↓
Готово. raw/<stem>.md — обычный источник,
готов к /ingest когда понадобится.

Детали каждого шага — в references/:

  • references/raw-pipeline.md — Step 1, форматы, изображения, именование, файловая структура
  • references/wiki-integration.md — frontmatter восстановленного .md, интеграция с ingest

Важные правила для агента

Step 2 — это транскрипция, а не реферирование.

Задача агента: перевести визуальное содержимое документа в markdown дословно и полностью. Не сокращать, не суммировать, не "улучшать" — даже если текст кажется повторяющимся или избыточным.

Обязательно:

  • Читать через Read tool. Нативный multimodal-агент корректно видит формулы, таблицы и структуру.
  • Воспроизводить каждое предложение оригинала. Если в источнике три абзаца — в markdown три абзаца. Если один абзац занимает страницу — он занимает страницу.
  • Форматирование по оригиналу:
    • Формулы → LaTeX: $...$ inline, $$...$$ block
    • Таблицы → markdown tables с теми же колонками и данными
    • Нумерованные и маркированные списки → точно по структуре
    • Жирный/курсив → **bold**, *italic*
    • Подзаголовки → соответствующий уровень ##/###
    • Ссылки, сноски, цитаты (Author, YYYY) → сохранять

Встраивание изображений:

  • Из манифеста → ![[image.png]] там где стоит рисунок в оригинале, перед/после подписи
  • Изображение не извлечено (вектор) → плейсхолдер:
    > **Рис. 1.10** *(изображение не извлечено — добавьте вручную)*
    > [текстовое описание того что на рисунке, основанное на контексте]

Категорически запрещено:

  • ❌ Сокращать абзацы ("автор пишет о...")
  • ❌ Пересказывать своими словами
  • ❌ Объединять несколько предложений в одно
  • ❌ Пропускать разделы, которые кажутся неважными
  • ❌ Добавлять пояснения, комментарии, резюме от себя
  • ❌ Менять структуру разделов

Если что-то не читается (OCR-артефакт, нечёткий скан) → оставлять [нечитаемо] или максимально близкую транслитерацию в скобках.

Исключение — аудио и видео: whisper-cpp возвращает «плоский» текст без пунктуации структуры (заголовков, списков). Агент вправе:

  • разбить на логические разделы по смыслу (## подзаголовки)
  • расставить абзацы по сменам темы
  • исправить очевидные ошибки распознавания (имена, термины)
  • убрать слова-паразиты («эээ», «ну вот», «как бы») если они не несут смысла
  • но не сокращать содержание — каждая мысль говорящего должна остаться

Для видео — то же самое (ffmpeg извлекает аудиодорожку, дальше тот же pipeline).


Что делать если файл не туда положили

Пользователь может положить paper.pdf в raw/ или куда угодно. Агент всегда выполняет проверку и перемещает:

# Если файл не в raw/formats/ — переместить
mkdir -p raw/formats
mv raw/paper.pdf raw/formats/paper.pdf

После перемещения продолжать pipeline.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.