Communitygithub.com

atilla777/omr

Use when collecting or revising source-backed content for an OMR video: собрать материалы по теме ролика, проверить факты и внешние источники, создать content/index.md и тематические Markdown-файлы. Not for requirements interviews, final narration or scene scripting, rendering, general research unrelated to a video, or development of OMR itself.

What is omr?

omr is a Claude Code agent skill that use when collecting or revising source-backed content for an OMR video: собрать материалы по теме ролика, проверить факты и внешние источники, создать content/index.md и тематические Markdown-файлы. Not for requirements interviews, final narration or scene scripting, rendering, general research unrelated to a video, or development of OMR itself.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/atilla777/omr/tree/HEAD/.opencode/skills/omr-content

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Материалы для ролика OMR

Ты владеешь содержательными материалами в content/ конкретного ролика, включая обязательный content/index.md. Общайся на языке пользователя. Результат — проверяемая база фактов, объяснений и примеров для будущего сценария.

Проект и достаточность входов

В начале работы загрузи omr-dialogue через skill, если он ещё не загружен в текущем контексте, и применяй ко всем уточнениям. Если зависимость недоступна, сообщи и согласуй подключение; под ведущим верни блокер ему.

Если есть reviews/content.md, прочитай его и учитывай описанные проблемы при создании или правке контента. Если файла нет, прежних замечаний из ревью нет. Не запускай ревью самостоятельно и не меняй его отчёт: это отдельная операция. Под ведущим возвращай существенные вопросы ему, не начинай отдельное интервью.

  1. Прочитай применимые AGENTS.md, запрос, requirements.md, предоставленные документы/ссылки и существующий content/index.md с затронутыми материалами. Используй текущую подпапку ролика или явно выбранный пользователем проект. Установи корень рабочей области по правилам и структуре, а не только по .git. Из корня без выбранного проекта сначала спроси, какую имеющуюся или новую подпапку использовать. Не записывай контент ролика в корень OMR и не создавай вложенную папку ролика внутри уже выбранного проекта или вложенный .git.
  2. Проверь, понятны ли тема, цель, аудитория, обязательное/исключённое содержание, глубина и ограничения объёма, позволяющие осмысленно отобрать материал. Учти прочие решения требований, включая режим, язык и ограничения ресурсов; не меняй их. Эквивалентный бриф/запрос допустим без requirements.md. Не требуй нового утверждения имеющихся документов или отдельного статуса.
  3. При существенном пробеле или конфликте назови конкретно, что мешает сбору, и задай необходимое уточнение. Если предыдущий результат отсутствует или недостаточен, предложи /omr-requirements, только проверив наличие команды в этой установке. Не вызывай её и не запускай интервью самостоятельно. Не создавай видимость готового контента на выдуманной теме/аудитории. Несущественные для сбора производственные детали не должны блокировать работу.

Сбор и проверка

  • Сначала разбери материалы пользователя: что они подтверждают, какие пробелы оставляют, откуда происходят. Сохраняй ссылки на локальные файлы и нужный раздел или страницу. Предоставленная заметка — источник пользовательского утверждения, а не автоматическое доказательство его истинности.
  • Самостоятельно найди внешнюю информацию по теме и требованиям. Используй доступный поиск и открывай подходящие страницы/первоисточники через доступные инструменты чтения веба. При отсутствии поискового инструмента можно искать через доступные страницы каталогов/энциклопедий и их ссылки; явно укажи способ и ограничения. Не выдавай известный по памяти URL или сниппет за прочитанный источник. Не устанавливай поисковые инструменты без согласования.
  • Предпочитай первоисточники, официальные материалы и профильные справочники. Для каждого существенного найденного факта укажи конкретный источник рядом с утверждением или через однозначную метку и список источников. Сохрани название, автора/организацию при наличии, URL, раздел/страницу и дату обращения; даты публикации и актуальности — когда они влияют на смысл. Для расчёта покажи исходные данные, допущения и ход вычисления, а не приписывай свой вывод источнику.
  • Соотнеси утверждение с действительно прочитанным фрагментом. Отличай прямой факт, объяснение своими словами, пример, гипотезу и вывод. Проверь единицы, область применимости формул и актуальность изменчивых данных. Масштаб проверки соразмерен теме; при споре ищи независимое подтверждение и сохраняй расхождения. Не скрывай конфликт материалов пользователя с внешним источником: объясни его; существенный выбор трактовки уточни, если доказательств недостаточно.
  • При недоступной странице попробуй доступный надёжный источник. Если нужное утверждение проверить нельзя, пометь его непроверенным с причиной и влиянием либо исключи из пригодной базы. При отсутствии доступа ко всему внешнему поиску сохрани полезную частичную работу с явным ограничением, назови блокер и согласуй получение источников; не объявляй внешний поиск выполненным.
  • Собери достаточные для цели факты, определения, понятные аудитории объяснения, примеры и важные оговорки. Ограничь исследование содержанием ролика; не расширяй тему в бесконечный обзор. Не копируй большие чужие тексты: пересказывай со ссылкой, цитаты обозначай и используй лишь по необходимости.

Организация результата

Создай по необходимости content/ и один или несколько тематических .md. Даже для единственного материала создай content/index.md:

  • тема и назначение базы, использованные требования/эквивалентный бриф;
  • относительные ссылки на материалы, кратко что в каждом и порядок чтения;
  • покрытие обязательных тем, существенные пробелы, спорные/непроверенные сведения и ограничения поиска, если они есть.

В тематических документах разделяй факты/объяснения, примеры, оговорки и источники. Дай следующему этапу достаточно контекста без старого чата. Структуру адаптируй под тему; не размножай документы ради шаблона. Ссылки должны вести к существующим локальным материалам или конкретным внешним источникам, а не только на их главную.

Это материалы, не сценарий: не создавай финальное повествование, готовый текст озвучки, последовательность сцен, покадровый тайминг или производственный код. Порядок чтения документов не является порядком сцен. Не создавай и не скачивай заранее производственные медиа; предоставленные ресурсы можно изучить и сослаться на них. Не устанавливай движки и другие производственные зависимости, не создавай package-файлы, исходники сцен, рендеры или пустые папки последующих этапов.

При повторном запуске изучи существующее и меняй только порученные материалы, обновляя индекс в пределах этой правки. Сохраняй остальную работу и источники; не перезаписывай весь каталог, не обновляй требования, сценарий или видео. Если запись запрещена, дай явно несохранённый результат и назови ограничение.

Проверка и остановка

Перечитай сохранённые документы. Проверь соответствие требованиям, наличие индекса, порядок чтения и локальные ссылки, связь существенных фактов с реально прочитанными источниками, точность примеров и явность оставшихся пробелов. Не объявляй базу достаточной, если обязательная тема осталась без надёжного материала.

Сообщи фактические пути, краткое покрытие и существенные ограничения проверки. Остановись: не запускай сценарий и другие этапы автоматически. Упоминай команду следующего этапа только после проверки, что она действительно реализована.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Related Skills