gost-report-skill

Install

git clone https://github.com/Bbar0n234/gost-report-skill.git
pip install python-docx docxcompose

This is third-party code. Review the repository files before installing.

What it does

The skill splits the job: the model handles only content, while a deterministic pandoc and python-docx build applies formatting. The agent reads the course guidelines, proposes a structure for the paper type, agrees on it and writes the text; the script then builds a .docx with GOST styles, section numbering, figure and table captions, appendices and a GOST 7.0.100 bibliography. The title page is filled from metadata, with templates for GUAP and SPbGEU, and the agent can turn another university's blank into a template. After the build, a verify script and a checklist catch formatting errors.

Who it is for. For students and teachers at Russian universities preparing lab reports, coursework, internship reports and theses.

Example request

Format my lab report No. 3 for the operating systems course, here are the guidelines

Limitations

Requires pandoc and the python-docx and docxcompose packages. An auto table of contents with page numbers needs LibreOffice, about 700 MB; otherwise update it in Word with F9. Title pages can only come from .docx, not PDF. Margins and spacing that differ from GOST must be edited manually in the style template.

How to disable. Delete the gost-lab-report folder from ~/.claude/skills, ~/.agents/skills or ~/.config/opencode/skills.

Security check

• Runs Python build and verify scripts
• May suggest installing pandoc and LibreOffice

README in short

The README states the core idea: the model writes text and a script handles formatting, so styles never drift. It lists supported paper types, title page auto-fill and adding a new university, the auto table of contents and self-review. Install is a clone plus copying the folder for Claude Code, Codex CLI or opencode. It includes an OS compatibility table and a candid list of what the skill does not do. Apache 2.0 licensed.

SKILL.md

---
name: gost-lab-report
description: >
  Оформление студенческих работ по ГОСТ 7.32: лабораторные, курсовые,
  ВКР, отчёты по практике, рефераты, контрольные.
  Используй когда: отчёт, лабораторная, курсовая, курсач, ВКР, диплом,
  практика, реферат, контрольная, ГОСТ, оформить работу, оформление,
  lab report, coursework, thesis.
---

# Оформление студенческих работ по ГОСТ 7.32

## Обзор

Скилл автоматизирует оформление студенческих работ: LLM генерирует Markdown, скрипт собирает .docx с правильными стилями и титульным листом. Покрываются все текстовые типы работ — лабораторные, курсовые, ВКР, отчёты по практике, рефераты, контрольные. Оформление тела едино (ГОСТ 7.32), титульники подключаемые (вуз × тип работы).

Сопутствующие файлы (читать по необходимости):
- **PROFILES.md** — детальные профили типов работ (структуры разделов, шаблон реферата ВКР, конвенции приложений). Читать перед аутлайном.
- **WIZARD.md** — подключение титульника нового вуза из .docx-бланка пользователя + реестр существующих шаблонов. Читать, когда нужного титульника нет в `templates/title_pages/`.
- **REVIEW.md** — финальная проверка собранного отчёта: verify-скрипт + визуальный осмотр рендера + чек-лист ГОСТ 7.32. Читать после сборки, перед сдачей пользователю.
- **ENVIRONMENTS.md** — проверенные окружения и версии зависимостей. Читать при сетапе или проблемах окружения.

## Порядок работы

1. **Анализ контекста.** Изучить всё, что предоставил пользователь: методичку, скриншоты, устные указания, тему. Определить тип работы и прочитать его профиль в PROFILES.md.
2. **Аутлайн.** Предложить полный outline отчёта: перечень разделов, что будет в каждом. Согласовать с пользователем.
3. **Уточнения.** Запросить недостающее: номер варианта, скриншоты (если требуются, но не предоставлены), конкретные параметры/данные, неоднозначности из методички. Можно совместить с аутлайном, если вопросов немного. Если контекста достаточно — пропустить.
4. **Генерация.** После согласования — генерировать Markdown и собирать .docx.
5. **Ревью.** Проверить собранный .docx по REVIEW.md (в идеале — независимым субагентом с чистым контекстом) и устранить замечания до сдачи пользователю.

Принцип: не генерировать вслепую, сначала синхронизироваться с пользователем. Но и не превращать в допрос.

Related