vkr-author: Russian thesis formatting

vkr-author

A Claude Code skill that builds a Russian bachelor's thesis from markdown into docx per the STO SGAU standard and GOST 7.1

Skill

Low risk

We rate an entry low when it mostly gives the agent instructions and reference material.

Why this level

  • Works only with the user's local markdown files and docx template
  • Does not publish or send documents anywhere
All reasons and checks
Russian stack

tssvett/vkr-author

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/vkr-author

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal in the project folder

npx skills add tssvett/vkr-author --skill vkr-author -a claude-code -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add tssvett/vkr-author --skill vkr-author -a cursor -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add tssvett/vkr-author --skill vkr-author -a github-copilot -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add tssvett/vkr-author --skill vkr-author -a codex -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add tssvett/vkr-author --skill vkr-author -a gemini-cli -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add tssvett/vkr-author --skill vkr-author -a cline -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add tssvett/vkr-author --skill vkr-author -a roo -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

A fork of Roo Code, same .roo folders.

Run in a terminal in the project folder

npx skills add tssvett/vkr-author --skill vkr-author -a opencode -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 139e92f.

Text for your agent

Clone the repository into ~/.claude/skills/vkr-author with git clone https://github.com/tssvett/vkr-author ~/.claude/skills/vkr-author, make sure pandoc, python with python-docx and lxml, git and the beads CLI are installed, then ask to start a new thesis.

Other ways from the author
git clone https://github.com/tssvett/vkr-author ~/.claude/skills/vkr-author

Clone into the Claude Code skills folder, as described in the README.

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

What it does

The skill walks a student through the whole thesis process: init scaffolds a ten-chapter project with a title page and a beads task tracker, audit checks the text for wrong dash types, figure and table numbering, paragraph length and source references, build compiles markdown into docx via pandoc with a Lua filter and a Word style template, and review-prep runs an audit plus a build before showing the work to an advisor. The docx styles (font, margins, heading and table formatting) are copied from a defended thesis under the STO SGAU 02068410-004-2018 standard, with bibliography per GOST 7.1-2003.

Who it is for. For undergraduate students at Samara University and similar institutions writing a thesis who want formatting done without manual Word wrangling.

Good fit when

  • You need to start a thesis project with a standard chapter structure and a title page
  • You need to compile a markdown draft into docx with correct styles and continuous numbering
  • You need to check the text for dash usage, heading style and broken figure links before showing it to an advisor

Not a fit when

  • Your university requires a different local formatting standard, not STO SGAU
  • You do not have Windows with Microsoft Word: the table of contents does not render automatically on other systems
  • You need a plagiarism check or scientific review of the content

Example request

Start a new thesis on time series analysis, I'm a Samara University student

Limitations

The author describes the project as an MVP tested on a single defended thesis and does not recommend unsupervised use yet. The repository has no stated license. Building requires pandoc, python with python-docx and lxml, git and the beads CLI; the table-of-contents prerender only works through Word COM on Windows, and on other systems the TOC must be refreshed manually in Word with F9. The skill does not write chapter content or check the academic substance, only formatting.

How to disable. Delete the skill folder from `~/.claude/skills/vkr-author`.

Security check

  • Works only with the user's local markdown files and docx template
  • Does not publish or send documents anywhere

README in short

The README calls the project an MVP tested on one defended thesis and describes four subcommands: init, audit, build, review-prep. It shows the build pipeline through pandoc with a Lua style filter, PowerShell and python postprocessing scripts for docx. Dependencies and the skill's folder layout are listed. The roadmap includes finishing the title page generator, a standalone audit CLI, support for other universities and LaTeX or PDF export.

SKILL.md

---
name: vkr-author
description: Помощник для создания и оформления выпускной квалификационной работы (ВКР) бакалавра по СТО СГАУ 02068410-004-2018 и ГОСТ 7.1-2003. Триггерится когда пользователь хочет начать новую ВКР, написать секцию диплома, скомпилировать markdown в docx с правильным русским академическим оформлением, провести аудит готового текста или подготовить работу к показу научному руководителю. Поддерживает четыре подкоманды — init, audit, build, review-prep.
---

# vkr-author — оформление ВКР по СТО СГАУ

## Что я делаю

Я помогаю студенту бакалавриата подготовить выпускную квалификационную работу (ВКР) полностью оформленной по СТО СГАУ 02068410-004-2018 (стандарт Самарского университета) с библиографией по ГОСТ 7.1-2003. Стили совпадают с защитившейся ВКР Маршуниной М.А. и НИР 7-го семестра — это gold standard для нашей команды.

На входе: пустая папка для нового проекта ВКР или существующая markdown-структура.

На выходе: docx-файл с правильными отступами, шрифтами, заголовками, нумерацией, таблицами, рисунками, списком литературы по ГОСТ.

FAQ

Does the skill fit a university without the STO SGAU standard?

The styles and the docx template are built specifically for STO SGAU 02068410-004-2018, so another university would need to adapt them.

Does the build work on macOS or Linux?

Pandoc and the python scripts run there, but the automatic table-of-contents prerender uses Word COM and needs Windows; elsewhere you refresh the TOC in Word by hand.

Official

Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models

MCP serverMedium riskNo VPN needed187.4KRepository stars
Editors’ pick

Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec

SkillMedium risk178.8KRepository stars
Editors’ pick

A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations

SkillMedium risk56.8KRepository stars
Editors’ pick

A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types

SkillMedium riskNo VPN needed42.6KRepository stars
Foxx AIvkr-author: Russian thesis formatting

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.