Aut_Sci_PPt — скилл

Скилл превращает научную статью в PDF или план с нумерованными разделами в готовый .pptx с четкими формулами и рисунками.

  • 123 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Python-пакет читает PDF и пишет файлы `.pptx` на диск; свободный текст для разбора уходит во внешний API модели.
Все причины и проверки

shzhao27208/aut_sci_ppt

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/aut-sci-ppt

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Python-пакет читает PDF и пишет файлы `.pptx` на диск; свободный текст для разбора уходит во внешний API модели.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Aut_Sci_PPt — скилл и Python-пакет, который собирает презентацию `.pptx` для защиты, семинара или исследовательской заявки. Входом служит статья в PDF или текст с разделами `1. Название` и пунктами `- пункт`. PDF разбирается через PyMuPDF, рисунки вынимаются в высоком разрешении, формулы LaTeX отрисовываются в прозрачные PNG. Движок верстки следит, чтобы текст не выходил за слайд и не налезал на рисунки. Тема встроена: темно-синий основной цвет и красный акцент для главной новизны работы. Свободный текст при желании превращается в структуру через модель Anthropic или OpenAI, если в окружении задан ключ API.

Для кого. Магистрантам и аспирантам, которым по готовой статье в PDF нужна презентация к защите, семинару или исследовательской заявке.

Подходит, если

  • Статья в PDF есть, а слайды к семинару надо собрать за один вечер.
  • Рассказ о себе и достижениях для поступления уже набран разделами и списками.
  • В презентации много формул LaTeX, и на проекторе они должны остаться четкими.
  • Рисунки из статьи нужны на слайдах в высоком разрешении, без размытых растровых вырезок.

Не подходит, если

  • Оформление должно строго повторять шаблон вуза или компании, а у проекта одна встроенная тема.
  • Слайды нужны не по научной статье: логика заточена под академический формат.
  • Текст нельзя отправлять во внешний ИИ-сервис: свободный текст уходит на разбор в API модели.

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

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

Ограничения

Нужен Python 3.10 или новее. Команда `pip install python-pptx pyyaml pymupdf Pillow` из README ставит только зависимости, а сам пакет подключают из копии репозитория. Скилл следует 13 правилам оформления из `SKILL.md`: запрещает вырезать рисунки из PDF как растровые картинки низкого качества и предупреждает, если операция займет больше 10 секунд. Тема задает шрифты Microsoft YaHei, KaiTi и Times New Roman, без них PowerPoint подставит другие. Последний коммит в репозитории сделан в июле 2026 года.

Как отключить. Удалите папку скилла из каталога скиллов агента и снимите Python-зависимости, если ставили их отдельно. Ключи API лежат в переменных окружения, очистите их сами.

Частые вопросы

Как оформить входной текст?

Разделы нумеруют как `1. Название`, пункты начинают с `- `. Заголовки Markdown с `##` парсер не распознает.

Чем режим PDF отличается от текстового?

Режим PDF идет через `PaperWorkflow` и берет текст и рисунки из статьи с помощью PyMuPDF. Текстовый режим принимает готовый план через `create_ppt`.

Нужен ли ключ ИИ?

Только для разбора свободного текста: `ai_parser.py` читает `ANTHROPIC_API_KEY` или `OPENAI_API_KEY`. Размеченный текст разбирает отдельный парсер без обращения к модели.

Какой файл получается на выходе?

Готовый `.pptx` в формате 16:9 (13,33 на 7,5 дюйма). Промежуточный Markdown скилл не выдает.

Как выделить главную новизну статьи?

Скилл сам ищет ее и подсвечивает красным цветом `#EE0000`, основной цвет темы — `#1E3A5F`.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл собирает презентацию из статьи, отчета или заметок как серию цельных слайдов-картинок и склеивает их в pptx

СкиллРасширенный доступ7,8 тыс.Звезды репозитория10Установок через CLI и агентов

Скилл для Codex и Claude Code: делает из научной статьи презентацию для семинара с настоящими рисунками и проверкой

СкиллМинимальный доступ122Звезды репозитория

Скилл на китайском делает из PDF, DOCX, страниц и Markdown презентации PPTX с настоящими редактируемыми фигурами.

СкиллМинимальный доступ58Звезды репозитория
Нужен VPN

Скилл делает презентации через gpt-image-2: каждый слайд рисуется как цельный макет и собирается в .pptx, можно повторить стиль чужого шаблона

СкиллРасширенный доступ1,5 тыс.Звезды репозитория

Скилл делает презентацию из темы или статьи и меняет оформление старой по картинке-образцу, сохраняя текст и редактируемость слайдов

СкиллРасширенный доступ470Звезды репозитория

Скилл для выступлений: строит план презентации по ходу мысли слушателя, решает, где нужны картинки и видео, и проверяет готовые слайды перед сценой

СкиллРасширенный доступ993Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
Aut_Sci_PPt (эта карточка)нет123
Thesis Defense PPTXнет280сохраняет оформление вашего шаблона PowerPoint; Aut_Sci_PPt использует встроенную тему и сам рендерит формулы
Academic Presentations Skillнет1 512строит слайды как аргумент доклада; Aut_Sci_PPt добавляет Python-движок верстки с разбором PDF и рисунков

Коротко о README

README краткий: список возможностей, установка зависимостей и пример на Python. Подробности лежат в `SKILL.md`, `references/rules.md` и `USER_GUIDE.md`, готовая презентация-пример — в папке `example/`.

Бейдж для README

Исходный SKILL.md

---
name: aut-sci-ppt
description: Use when converting academic paper PDFs or structured text into professional, high-standard PowerPoint (PPTX) presentations for defense or seminars.
---

# Aut_Sci_PPt (Academic Auto-PPT Agent)

A specialized tool for generating professional academic presentations directly from paper content or structured outlines.

## Core Behavioral Rules (The 13 Laws)

1. **Format**: Use `1. Title` for chapters and `- Point` for bullets.
2. **Markdown**: 🚫 DO NOT use `##` for slide titles; it is not recognized by the parser.
3. **Innovation**: Identify the core innovation of the paper and highlight it in **Red**.
4. **Imagery**: Use HD extraction (600 DPI) for figures; minimum width >= 300px.
5. **No Scrapping**: 🚫 PROHIBITED to scrap low-quality bitmaps from PDF streams.
6. **Formulas**: Render LaTeX formulas as high-quality transparent PNGs.
7. **Transparency**: All generated formula/media assets must have transparent backgrounds.
8. **Feedback**: Inform the user if an operation (like PDF parsing) will take >10 seconds.
9. **Final Output**: 🚫 DO NOT output intermediate Markdown; generate and provide the `.pptx` directly.
10. **Colors**: Use `#1E3A5F` (Primary Blue) and `#EE0000` (Highlight Red).
11. **Layout**: Ensure zero text-overflow or figure-text overlap.
12. **Professionalism**: Keep communication brief and technical; skip AI pleasantries.

## Usage

### Simple Text Input
```python
from aut_sci_ppt import create_ppt

create_ppt("""
主题:[Title]
申请人:[Name]
1. [Section Title]
- [Content]
""", "output.pptx")
```

### PDF to PPT (Academic Workflow)
```python
from aut_sci_ppt import PaperWorkflow

workflow = PaperWorkflow()
workflow.process_pdf("paper.pdf", output_pptx="seminar.pptx")
```

Сообщить о проблеме