create-ra-skill

RA Skill Generator

What This Does

Convert the business knowledge held by Research Administrators (URAs/research support staff) into a Claude Code skill definition (SKILL.md) through interactive interviews. Structure individual know-how into a format that other RAs and agents can reuse.

Required Inputs

The following information is not needed on the first run. Collect it through interactive interviews.

When the user first runs /create-ra-skill , begin the interview.

What It Produces

skills/{skill-name}/SKILL.md — The completed skill definition file
A test execution plan for the skill (how to verify that the generated skill works as intended)

Procedure

Phase 1: Interview

Ask the following questions in order and collect the material for the skill. Do not ask everything at once; dig deeper based on the answers.

Q1. Overview of the work

どのようなRA業務についてスキルを作りたいですか？
（例: 科研費の予算執行管理、研究倫理審査の申請支援、産学連携のコーディネート 等）

Q2. Purpose of the work

この業務の目的は何ですか？誰の、どんな課題を解決しますか？
（例: 「研究者が予算執行で迷わないように、ルールに基づいた判断を支援する」）

Q3. Input information

この業務を行うとき、最初に必要な情報は何ですか？
（例: 研究種目、予算額、購入したい物品の情報 等）

Q4. Specific steps

この業務を実際にどのような手順で進めますか？
ステップバイステップで教えてください。
初心者の RA でも再現できるレベルの具体性でお願いします。

Q5. Judgment criteria and rules

手順の中で判断が必要な場面はありますか？
その判断基準やルールを教えてください。
（例: 「50万円以上の物品は設備備品に分類する」「年度末3月の発注は原則不可」）

Q6. Common mistakes and pitfalls

この業務で初心者がよくやるミスや、ベテランでも注意すべき落とし穴はありますか？

Q7. Success criteria

この業務がうまくいったと言える基準は何ですか？
（例: 「会計検査で指摘事項ゼロ」「申請書の不備による差し戻しゼロ」）

Q8. Reference information

この業務で参照するマニュアル、規程、ウェブサイトはありますか？

Phase 2: Generate the skill definition

Structure the interview results into the following template:

---
name: {kebab-case のスキル名}
description: {1行の説明}
user_invocable: true
---

# {スキルの日本語名}

## What This Does
{Q1 + Q2 の回答を統合した説明}

## Required Inputs
{Q3 の回答を構造化}
- **{入力1}**: {説明}
- **{入力2}**（任意）: {説明}

## What It Produces
{業務の成果物を列挙}
1. {成果物1}
2. {成果物2}

## 手順
{Q4 の回答をステップバイステップで構造化}

### 1. {ステップ名}
{具体的な手順}

### 2. {ステップ名}
{具体的な手順}
...

## 判断基準
{Q5 の回答を表やリストで構造化}

## よくあるミスと対策
{Q6 の回答を構造化}
| ミス | 対策 |
|------|------|
| {ミス1} | {対策1} |

## 品質基準
{Q7 の回答を基に品質基準を記述}

## 参照情報
{Q8 の回答をリンク付きで構造化}

## Available Tools
{業務内容に応じて適切なツールを記載}

Phase 3: Review and revision

Present the generated skill definition to the user
Ask for feedback from the following perspectives:
- Are there any omissions in the steps?
- Are the judgment criteria accurate?
- Is it specific enough that a beginner can read and execute it?
Revise to reflect the feedback
After final confirmation, save the file

Phase 4: Save the file

Convert the skill name to kebab-case (example: "Budget Execution Management" → budget-execution）
skills/{skill-name}/SKILL.md and save as
Notify the user of the save destination path

Phase 5: Guidance on next steps

After saving the skill, provide guidance on the following:

スキルを保存しました: skills/{skill-name}/SKILL.md

このスキルを使うには:
  claude --add-dir ./skills/{skill-name}
  → /{skill-name} で実行できます

リポジトリに貢献するには:
  1. このリポジトリを fork
  2. skills/{skill-name}/ を追加
  3. Pull Request を作成
  詳しくは CONTRIBUTING.md を参照してください。

Quality standards

The interview should be interactive rather than one-sided questioning
The user's answers are accurately reflected (do not add information on your own)
The generated skill complies with the SKILL.md format
It is specific enough that a beginner RA can read it and perform the work
If judgment criteria or rules are ambiguous, explicitly state "confirmation required"
Always include a user review after generation

Available Tools

Read / Write: Reading and writing skill files
Bash: File operations, directory creation