journal-adapt — скилл

Скилл адаптации научной статьи под журнал: по набору опубликованных статей строит правила письма и правит рукопись по разделам с журналом правок

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

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

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

  • Агент читает папки со статьями и рукописью и сохраняет рядом карточки стиля, правленые разделы и журналы правок
  • Рукопись, возможно неопубликованная, целиком уходит в модель агента и к ее поставщику
Все причины и проверки

wantongc/journal-adapt-writing-skill

Установка

Работает в

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

npx skillfoxx add skills/journal-adapt

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

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

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

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

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

  • Агент читает папки со статьями и рукописью и сохраняет рядом карточки стиля, правленые разделы и журналы правок
  • Рукопись, возможно неопубликованная, целиком уходит в модель агента и к ее поставщику

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

Что делает

journal-adapt помогает переписать научную статью под конкретный журнал. Работа идет в два этапа. На первом агент спрашивает, для какого журнала пишется текст, где лежат статьи этого журнала (основной корпус), есть ли дополнительные статьи по теме и образцы вашей лаборатории, а также какой базовый набор правил подключить: общий академический, экономику, машинное обучение или инженерию. По каждой статье он составляет карточку стиля: как построены аннотация, введение, вклад, обзор литературы, метод, результаты и обсуждение. Карточки он сводит в профиль журнала и получает файл dynamic_writing_skill.md, который вы читаете и правите до начала работы. На втором этапе агент правит рукопись по одному разделу за раз и для каждого раздела сохраняет отдельный файл и журнал правок. В итоге рядом с рукописью появляется папка [имя]_revised со стилевым профилем, переписанными разделами и общей сводкой. Результат в формате Markdown вы переносите в LaTeX или Word после проверки. Жесткие правила не отключаются: агент не добавляет факты, цитаты и результаты, не меняет формулы, ключи ссылок и обозначения и не воспроизводит текст статей корпуса: из них берется только описание структуры и риторики.

Для кого. Для исследователей, аспирантов и научных редакторов, которые готовят англоязычную статью к подаче в конкретный журнал и хотят увидеть, как ее принято строить, до начала правки.

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

  • Статью отклонили или вернули на доработку, и нужно перестроить введение и подачу вклада под соседние публикации журнала
  • Рукопись надо подать в другой журнал, и требования к структуре и тону у него иные
  • У вас есть 5–8 статей целевого журнала и нужны правила письма, выведенные из этих статей
  • Нужен журнал правок, где видно, какое решение принято в каждом разделе и почему
  • Хочется держать общий слой правил лаборатории отдельно от настроек конкретного журнала

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

  • Нужно написать статью с нуля: скилл правит готовую рукопись и не сочиняет результаты, ссылки и данные
  • У вас нет статей целевого журнала в читаемом виде: без основного корпуса профиль журнала не построить
  • Нужна проверка фактов, расчетов или цитирования: скилл сохраняет их без изменений и не проверяет
  • Текст нельзя отдавать модели, например из-за неопубликованных результатов под соглашением: рукопись и корпус читает сам агент

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

Помоги составить динамический скилл письма для моей рукописи по статьям Journal of Environmental Economics and Management из папки corpus и переписать введение

Ограничения

Поддерживается только академическое письмо на английском языке.

Сгенерированный dynamic_writing_skill.md нужно прочитать и подтвердить до начала правки, иначе правила журнала остаются непроверенными догадками агента.

Переводом PDF в Markdown занимается отдельная программа MinerU, и при некоторых локальных настройках она не запускается. Тогда нужны готовые Markdown-файлы или другой конвертер, а каждая статья, попавшая в корпус, должна читаться целиком. Автор рекомендует 5–8 статей журнала, 2–5 дополнительных и 1–3 образца лаборатории.

Скилл описывает структуру и риторику статей корпуса и не должен цитировать или пересказывать их защищенный авторским правом текст. Внешние базовые скиллы вроде econ-writing-skill он только рекомендует и сам не скачивает, пока вы не попросите. Лицензия MIT, версия 1.1.

Как отключить. Удалите папку ~/.claude/skills/journal-adapt, и Claude Code перестанет видеть команду /journal-adapt. Для Codex уберите папку skill из каталога скиллов или ссылку на нее. Файлы _revised и карточки стиля в _style_cards лежат у вашей рукописи и корпуса, удалите их отдельно, если не нужны.

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

Чем динамический скилл отличается от статического?

Статический скилл дает одни и те же правила для любой рукописи: нормы дисциплины, очистку от шаблонных фраз, защиту формул. Динамический строится под одну рукопись и один журнал по статьям корпуса, и главным по приоритету остаются статьи целевого журнала.

Нужен ли MinerU для работы?

Только если статьи или рукопись лежат в PDF. С файлами Markdown или обычным текстом агент работает без него. Если MinerU не ставится, можно дать готовый Markdown или другой конвертер, главное условие — каждая статья читается целиком.

Сколько статей нужно для корпуса?

Автор советует начать с 5–8 статей целевого журнала. Дополнительно можно положить 2–5 статей по теме из ведущих журналов области и 1–3 документа с образцами автора или лаборатории.

Какие базовые наборы правил входят в скилл?

Четыре файла в папке base_rules: общий академический стиль, экономика, машинное обучение с компьютерным зрением и обработкой языка, инженерия и компьютерные науки. Можно подключить собственный файл или обойтись только правилами из корпуса.

Что лежит в примере для журнала JEEM?

Обезличенный пробный прогон для Journal of Environmental Economics and Management: метаданные ролей корпуса, отчет о конвертации, сводный профиль стиля, сгенерированный динамический скилл, очищенная диагностика раздела и образец правки с журналом. PDF, полные тексты и закрытая рукопись не включены.

Меняет ли скилл формулы и ссылки в тексте?

Нет, формулы, команды LaTeX, ключи цитирования, имена переменных, обозначения и числа сохраняются дословно. Это первое из четырех жестких правил, наряду с запретом добавлять факты и пересказывать статьи корпуса.

Обсуждение

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

Скиллы

Скиллы под конкретные научные журналы: помогают выбрать издание, оформить статью и пройти рецензирование

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

Скилл paper-spine: по теме, материалам и данным ведет научную статью от поиска литературы и текста до иллюстраций, рецензии и файлов Word, LaTeX и PDF

СкиллШирокий доступ6 тыс.Звезды репозитория

Восемь скиллов для готовых научных статей и диссертаций на LaTeX и Typst: компиляция, ссылки, правка языка, письмо в журнал и аудит как у рецензента

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

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

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

Скилл для написания и правки статей по ML, CV и NLP: структура разделов, связность абзацев и самопроверка глазами рецензента

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

Набор скиллов для научной работы в стиле журналов Nature: поиск и чтение статей, текст, статистика, графики, ответы рецензентам

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

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

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

ЗаписьОфициальныйЗвезды репозиторияГлавное отличие
journal-adapt (эта запись)нет765
Academic Paper Skillsнет1 421два скилла для планирования и написания статьи, без разбора стиля конкретного журнала
Academic Research Skillsнет53 488набор для исследования, написания статьи, рецензирования и проверки цитат по шагам

Коротко о README

Описание объясняет идею «статический слой плюс динамический» схемой потока от корпуса к карточкам стиля, профилю журнала, динамическому скиллу и правке по разделам. Дальше идут таблицы статических скиллов с источниками, ролей корпуса и системы приоритетов от жестких ограничений до очистки шаблонных фраз, а затем быстрый старт для Claude Code и Codex, раскладка входных папок и перечень выходных файлов. В репозитории есть документы по установке, архитектуре и модулям, шаблоны и пример для одного журнала.

Бейдж для README

Исходный SKILL.md

---
name: journal-adapt
description: "Dynamic academic writing skill generator. Combines optional static writing skills with target-journal, field-top, or user-provided reference corpora, then revises a manuscript with a reviewable temporary skill. Use when the user wants to adapt an academic paper to a target journal, build a corpus-grounded writing skill, or revise section by section using journal and field writing signals."
argument-hint: "e.g. 'build a dynamic writing skill for my manuscript using these journal papers' or 'help me revise my paper for JEEM'"
user-invocable: true
---

You are a dynamic academic writing skill assistant. You help researchers build a temporary, reviewable writing skill for one manuscript by combining:

1. an optional static base writing skill,
2. a primary target-journal corpus,
3. optional field-top or topic-similar reference papers,
4. optional user/lab exemplars.

The target journal usually receives the highest weight, but the corpus does not have to be limited to the target journal.

This skill runs in two phases. Read all instructions before starting.

---

# HARD RULES — apply at all times

These override everything else. Never violate them.

1. **Never add facts.** Do not introduce new empirical claims, results, citations, or data not already in the original manuscript.
2. **Never change technical content.** All equations, LaTeX commands, citation keys, variable names, model notation, numerical results, proposition statements, and footnotes must be preserved verbatim.
3. **Never paraphrase corpus papers.** When reading reference papers in Phase 1, output only structural and rhetorical descriptions — never quotes, never paraphrases, never reproductions of findings.
4. **One section at a time.** In Phase 2, revise and output one section fully before moving to the next.

---

# INPUT AND DEPENDENCY CHECK

First determine whether the corpus and manuscript inputs are already Markdown/text or still PDFs.

- If all inputs are Markdown, plain text, or already converted agent-readable files, **do not require MinerU**. Proceed directly to Phase 1.
- If any input is PDF, ask the user whether they want to use MinerU or provide converted Markdown instead.

For PDF input with MinerU, verify installation:

```bash
mineru --version
```

If this command fails, do not stop the whole workflow. Tell the user:

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

Foxx AIjournal-adapt
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.