Community Скиллы Российские сервисы

Оформление ВКР по СТО СГАУ

Claude Code
Открыть источник ↗ GitHub ↗
Установка 
git clone (см. README)

Описание

vkr-author — скилл сборки ВКР для Claude Code: из markdown в docx — исходники в текстовом формате, готовый документ на выходе, стандарт СТО СГАУ — требования конкретного вуза вшиты в скилл, ГОСТ 7.1 — библиографическое описание по стандарту. Для студентов СГАУ и вузов со схожими стандартами, оформляющих диплом без ручной вёрстки.

Что умеет:
— собирать ВКР из markdown в docx;
— оформлять по СТО СГАУ;
— делать библиографию по ГОСТ 7.1;
— работать в Claude Code.

Полная документация ниже — автоматически из репозитория godviolance/vkr-author (ветка main). Оригинальные материалы проекта распространяются на условиях его лицензии.

vkr-author

Claude Code skill for authoring Russian bachelor’s thesis (ВКР) per СТО СГАУ 02068410-004-2018 and ГОСТ 7.1-2003. Markdown in → properly formatted .docx out.

What it does

Helps a Russian engineering/CS undergraduate write their final qualifying work (выпускная квалификационная работа, ВКР) with:

  • Proper structure (Реферат → Содержание → Введение → Главы → Заключение → Список источников → Приложения)
  • ГОСТ-compliant bibliography format
  • Correct СТО СГАУ Word styles (TNR 14, 30/15/20/20mm margins, и т.д.)
  • Sequential figure/table numbering with proper captions
  • Auto-generated TOC with «СОДЕРЖАНИЕ» heading
  • Tables with +Текст в таблице style and tblHeader for cross-page rows
  • Lists rendered as plain paragraphs with en-dash prefix (per СТО СГАУ, no Word bullets)

Status

MVP / experimental. Tested on one defended thesis (model-forge). Not yet recommended for unsupervised use.

How it works

The skill activates when user asks to start/build/audit a Russian thesis. Four subcommands:

Command Action
init Bootstrap a new thesis project — collects student/topic/advisor data via dialog, creates folder structure, scaffolds 10 chapters, initializes beads tracker
audit Validate text — em-dash check, citation integrity, paragraph length, missing table/figure references
build Compile markdown → .docx via Pandoc with reference-doc + Lua filter + postprocess
review-prep Final pre-advisor checklist — full audit + build + versioned snapshot

Pipeline

text/*.md
    │
    ▼
Pandoc + apply-stosgau-styles.lua  (markdown → docx with custom-style spans)
    │
    ▼
update-fields.ps1 + inject-toc.py  (pre-render TOC via Word COM)
    │
    ▼
postprocess-docx.py  (tblHeader, dirty=false, image centering, Compact→989)
    │
    ▼
thesis.docx

Dependencies

  • pandoc ≥ 3.0
  • python ≥ 3.10 + python-docx + lxml
  • git
  • bd (beads) CLI
  • Windows + Microsoft Word (for TOC pre-rendering via COM)

Installation

Clone or symlink to your Claude Code skills directory:

git clone https://github.com/<user>/vkr-author ~/.claude/skills/vkr-author

Then in any Claude Code session ask: «начни новую ВКР» or «оформи диплом».

Layout

vkr-author/
├── SKILL.md                              # Skill manifest + entry instructions
├── resources/
│   ├── template/blank-template.docx      # Word styles (СТО СГАУ, gold standard)
│   ├── scripts/                          # Build pipeline scripts
│   ├── style-references/                 # Style rules summary
│   └── scaffold/                         # Files copied to user's project on `init`
├── examples/
└── README.md

License

To be decided. The Word style template is derived from a defended thesis with student permission for educational reuse.

Roadmap

  • [ ] Polish titlepage generator (currently MVP-stub)
  • [ ] Add audit standalone CLI
  • [ ] Support for non-СГАУ universities via configurable styles
  • [ ] LaTeX/PDF output
  • [ ] CI on sample document