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
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
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/vkr-authorDetects 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 -yThe 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 -yThe 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 -yThe 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 -yThe 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 -yThe 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 -yThe 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 -yThe 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 -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
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-authorClone 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 studentLimitations
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.
Related
Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models
Anthropic skills
Skills
Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec
A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations
A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types