minorun-marp-skill
Три скилла и черная тема Marp для докладов: сюжет, схемы и дизайн слайдов плюс скрипты, которые измеряют готовый PDF
- 412 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Скилл запускает Marp CLI и проверочные скрипты, которые открывают Chrome и читают ваши файлы слайдов
- Установка просит поставить на компьютер дополнительные пакеты
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/minorun-marp-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл запускает Marp CLI и проверочные скрипты, которые открывают Chrome и читают ваши файлы слайдов
- Установка просит поставить на компьютер дополнительные пакеты
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Набор собран автором из его докладов и написан по-японски. Он учит агента делать презентации в Marp так, чтобы за аккуратной формой стоял сюжет. Автор замечает, что ИИ выдает ровные слайды с бедным содержанием, и закрепил свои повторяющиеся правки в правилах и проверочных скриптах. Скилл `slide-story` отвечает за сюжет: зацепку в начале, средние титульные слайды, постепенное раскрытие темы, стиль заголовков, концовку и оценку времени. Скилл `slide-figures` задает объем информации на схеме, способ рисовать SVG, нижний предел размера шрифта и расстановку иллюстраций. Скилл `slide-design-dark` описывает измерение отступов, вертикальный баланс, цвета на черном фоне, оформление таблиц и кода и ловушки Marp. В папке theme лежит тема `minorun-dark.css`, черная с бирюзовым акцентом. В папке tools семь скриптов проверяют экспортированный PDF и SVG: нижние и правые поля, зазоры между схемой и текстом, мелкий шрифт в схемах, умещение текста в блоках схем, контраст и повторяющиеся обороты. Образец колоды лежит в `examples/sample`, а `examples/broken` намеренно испорчен, чтобы проверки срабатывали.
Для кого. Для докладчиков и преподавателей, которые делают слайды в Marp вместе с Claude Code и готовы читать правила на японском.
Подходит, если
- Нужна колода на 20 минут для митапа в черной теме, например «слайды для быстрого доклада»
- Агент делает ровные слайды, но доклад получается пустым: нужны правила зацепки, средних титульных слайдов и концовки
- Схема на слайде перегружена: нужны правила, что в нее включать, и проверка размера шрифта в SVG
- Нужно измерить готовый PDF: поля, зазоры между схемой и текстом и контраст фигур
- Старые слайды переиспользуются в новом докладе, и нужна сверка заголовков и схем скриптом
Не подходит, если
- Нужна презентация не в Marp: правила и тема написаны под Marp, их придется переносить вручную
- Нужен светлый или корпоративный фирменный стиль: тема minorun-dark черная с бирюзовым акцентом
- Правила на японском для вас неудобны: тексты скиллов написаны по-японски, а переводить их придется самому
- Нужна презентация для чтения: скилл рассчитан на выступление с проекцией и пояснением голосом
Пример запроса к агенту
Сделай в черной теме слайды для 20-минутного доклада на митапе про MCP, а потом проверь готовый PDF проверочными скриптами.Ограничения
Тексты скиллов и README написаны по-японски. Для экспорта и проверок нужны Marp CLI, Google Chrome, пакеты poppler и mupdf-tools, Python 3 с Pillow. Скрипты на JavaScript используют puppeteer-core из Marp CLI, и пути к нему и к Chrome задаются переменными `MARP_NODE_MODULES` и `CHROME_PATH`.
Тема рассчитана на округлые гротески: лучше всего подходит шрифт Zen Maru Gothic, а без него macOS подставит Hiragino Maru Gothic. Автор использует платный шрифт, поэтому начертания в его опубликованных докладах слегка отличаются.
Иллюстрации «いらすとや» в репозиторий не включены и не подпадают под лицензию Apache 2.0: образец колоды требует скачать их скриптом, а условия использования нужно проверить самому. Доступность установки из России при подготовке карточки не проверялась.
Как отключить. Удалите три каталога slide-story, slide-figures и slide-design-dark из `~/.claude/skills/`. Копия репозитория в `~/.claude/skill-repos/minorun-marp-skill` нужна только для темы и скриптов, ее можно удалить отдельно.
Частые вопросы
Как поставить скилл для слайдов Marp в Claude Code?
Передайте агенту адрес репозитория и попросите поставить скиллы. Вручную нужно положить репозиторий в `~/.claude/skill-repos/minorun-marp-skill` и скопировать три каталога из `skills/` в `~/.claude/skills/`, а затем начать новую сессию.
Как собрать PDF с темой minorun-dark?
Командой `marp --no-stdin deck.md --pdf --theme theme/minorun-dark.css --allow-local-files`. В начале файла укажите `marp: true` и `theme: minorun-dark`.
Какие классы слайдов есть в теме?
`top` для титульного слайда, `crosshead` для средних титульных слайдов, `image-full` для заголовка с большой картинкой и `split` для текста слева и изображения справа. Размеры по умолчанию: текст 26 pt, h1 36 pt, средний титульный 44 pt, обложка 52 pt.
Какие проверки есть для готового PDF?
`check-dark-margins.py` измеряет нижнее и правое поля, `check-dark-gaps.py` зазоры между схемой и текстом, `check-figure-text.py` мелкий шрифт в схемах. Для SVG есть `check-svg-box-fit.mjs` и `check-svg-contrast.mjs`, для переиспользованных слайдов `check-reuse-diff.py`, а `check-ai-smell.py` ищет повторы оборотов.
Почему в образце колоды нет иллюстраций?
Картинки «いらすとや» в репозиторий не входят из-за лицензии. Перед экспортом образца их скачивает скрипт `examples/sample/fetch-illustrations.sh`, а условия использования нужно проверить самому.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыНабор из 14 скиллов, которые учат агента строить диаграммы и визуализации прямо в Markdown: UML, облачные и сетевые схемы, графики, карты и карточки
Скилл верстает по шаблонам резюме, одностраничники, письма, отчеты и слайды в PDF, PNG и PPTX и проверяет результат скриптами до выдачи
Скилл для агентов, который собирает презентацию как один HTML-файл: два стиля оформления, обложки для соцсетей и режим докладчика
Скилл собирает презентацию из статьи, отчета или заметок как серию цельных слайдов-картинок и склеивает их в pptx
Dashi PPT
Dashi PPT Skill
Скилл делает из документа презентацию: редактируемая в браузере HTML-колода с консолью на каждой странице и экспортом в PPTX и PDF
Скилл для выступлений: строит план презентации по ходу мысли слушателя, решает, где нужны картинки и видео, и проверяет готовые слайды перед сценой
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| minorun-marp-skill (эта запись) | нет | 412 | |
| Slidev | нет | 49 264 | официальный скилл для докладов в Slidev на Markdown и Vue, а этот набор работает с Marp и измеряет готовый PDF |
| PPT Agent Skill | нет | 169 | делает презентацию в HTML и PPTX из одной фразы, а этот набор задает правила сюжета и дизайна для Marp |
Коротко о README
Описание содержит таблицу содержимого репозитория, порядок установки через запрос к Claude и отдельную инструкцию для самого агента. Затем идут команды экспорта и проверок, раздел про шрифты и замечание об иллюстрациях.
Бейдж для README
Исходный SKILL.md
--- name: slide-story description: 人前で話す登壇・講義スライドのストーリーの組み方。つかみ、中扉、段階的な開示、見出しの文体、締め方、尺の見積り。「登壇スライドを作って」「LTの資料」「講義資料の構成を考えて」と言われたら、書き始める前に読む。 --- # 登壇スライドのストーリーの型 登壇スライドは読ませる資料ではない。話し手が話しやすい紙芝居であり、聞き手が「いまどの話のどこにいるか」を見失わないための道具である。投影して口頭で補う前提なので、配布資料に必要な網羅性や注記は要らない。 この型は、作者（みのるん）が数年分の自作デッキを読み返して抽出したもの。AIエージェントにスライドを書かせると体裁は整うのに中身が薄くなりがちで、その原因の大半は下に挙げる規則のどれかを外していることにある。 ## 着手の順序 1. 主催者の告知ページで、正式なタイトル・概要・持ち時間を確かめる。応募時の原稿で代用しない。告知で約束した論点が資料に入っているかを、骨子の段階と完成時に照合する 2. 話し手本人の過去のデッキを1本、実物で読む。型は文章の説明より実物から掴める 3. 何を伝えたいか、聞き手は誰か、どの話で驚かせるかを、話し手と言葉で詰める 4. 紙芝居の流れを骨子として合意する 5. そのページでしか成立しない中身（図、具体例、実物のスクリーンショット、数字）を決める 6. 体裁はそのあと テンプレートの型へ内容を流し込む作り方はしない。「アイコン＋太字の見出し＋1行の説明」のカードを3枚並べた構成を全ページで繰り返すと、体裁は整うのに何も伝わらない資料になる。 ### やってはいけないこと - 申請書や審査資料のような「読ませる資料」の型（カード、対比図、フロー、ハブ図）を持ち込まない。1スライドに4ブロック詰まって、情報が並ぶ割に全部薄くなる - 主催者から受け取ったテンプレートや既存スライドの構成を真似ない。合わせるのは画面比率・ロゴ・書体までで、中身の作り方は話し手の型を通す - カリキュラム表やアジェンダの項目を、そのままスライドの章とスライド数にしない。要件の網羅は資料の役目ではない ## 骨格 ### つかみは聴衆の現在地から 概念の定義から始めない。作者の人気デッキ21本を調べたところ、定義から始まるものは1本もなかった。型は4つある。 - 共感と困りごとの代弁（「最近、MCPってよく聞きますよね！ …ざっと調べても、イマイチ分かりづらくないですか？」） - 挑発するクイズ（「AIエージェントとは何か、自分の言葉で説明できますか？」） - 時事のフック（「先日、新しいモデルがリリースされました！」） - 自分の近況 自己紹介の次は、聴衆への問いかけのスライド2つから入る。「使ってますか？」の次に「作ってますか？」のように、2つ目で手が減る問いを置くと、そこが本編の入口になる。海外のイベントや英語のデッキでも同じ。 ### セクションの接続は「聴衆の心の声」の中扉 技術カタログの章立てをしない。聞き手がいま抱いたはずの疑問を中扉に書き、次の技術が必然として登場する形にする。