論文執筆の作業（探す・読む・書く・確かめる）を、AIエージェント向けスキルとして整理し、公開しました。この記事では、設計の対応関係と導入手順を書きます。

リポジトリ: https://github.com/hideshi/scholarly-agent-skills
ライセンス: MIT
対応言語: 日本語 / 英語
想定環境: Cursor、Claude Code、Antigravity など、エージェントスキルを読める環境。導入スクリプトは Python 3 の標準ライブラリで動きます

スキルは執筆の支援までです。生成文・出典・投稿の正確性は保証しません。内容の責任は、書くご本人にあります。

作った理由

海外の大学院で修士論文を書いていたとき、文献は増えるのに引用の可否で止まり、数値の出典を見失い、用語の定義が章ごとにずれていました。

ソフトウェア開発では、同じ種類の失敗を減らす型があります。テストを先に書く。ユビキタス言語で語を揃える。主張と根拠を突き合わせる。その型を、論文の作業順に並べたのがこのスキル集です。

日々の生活が科学技術と人文科学に支えられているので、ITエンジニアなりの恩返しとして公開しています。

設計

特定のエディタ用フォルダだけを正本にはしていません。skills/ と rules/ を共通形式で置き、各ツールへ展開します。論文リポジトリ側は Git サブモジュール、またはシンボリックリンクで参照します。

ソフトウェア側の型と、スキルの対応は次です。

開発側の型	論文側でやること	スキル
キックオフ / 完成の定義	問い・読者・提出先を1ページに落とす	`research-plan-workshop`
ユビキタス言語	用語の定義揺れを先に止める	`scholarly-concept-modeling`
仕様ギャップ分析	先行研究の到達点と自説の差を書く	`literature-gap-analysis`
TDD	想定反論を先に置き、それを越える本文を書く	`counter-argument-tdd`
不変条件監査	主張と一次情報・引用が対応しているか見る	`claim-evidence-gate`
トレーサビリティ	本文の引用と参考文献を1対1で見る	`citation-traceability-audit`
ハンドオーバー	セッションをまたいで「今どこまでか」を残す	`session-research-handoff`

文献検索は OpenAlex、arXiv、Crossref、Semantic Scholar を使います。PDFは Markdown と図版に分けて残し、あとから検索・引用できるようにします。外国語論文は対訳と用語表を残して読みます。

全部を一度に回す必要はありません。今つまずいているところだけでも使えます。カタログの全文はリポジトリの skills/ja/README.md にあります。

導入

論文用の Git リポジトリを用意したうえで、サブモジュールで入れる例です。

git submodule add https://github.com/hideshi/scholarly-agent-skills.git .scholarly-agent-skills
python3 .scholarly-agent-skills/scripts/setup_submodule.py --lang ja

同じマシンで複数の論文リポジトリから参照する場合は、シンボリックリンク用のスクリプトもあります。詳細は README を見てください。

文献検索など、外部 API へアクセスする処理では、実行者本人の連絡先メールが必要です。OpenAlex / Crossref の polite pool 向けに User-Agent へ載せます。ドキュメント用の example.com や空欄では、HTTP を送らず終了します。リポジトリに個人メールをコミットしないでください。

export SCHOLARLY_CONTACT_EMAIL="ご自身のメールアドレス"

Semantic Scholar を頻繁に使う場合は、任意で SEMANTIC_SCHOLAR_API_KEY も渡せます。

自分で使った例

私はこのスキル集を使い、次の論文を公開しました。個人の公開例です。スキルを使えば同じように論文を公開できる、という意味ではありません。

数値や引用は、一次情報を取りにいき、リポジトリ内に残してから本文へ書いています。AIに任せて終わり、にはしていません。

おわりに

完成を保証する道具ではありません。手元の研究に合わせて、直したり足したりして使ってください。

スキル集: https://github.com/hideshi/scholarly-agent-skills
免責の全文: https://github.com/hideshi/scholarly-agent-skills/blob/main/DISCLAIMER.md

※MITライセンスには、著作権表示の維持など所定の条件があります。