OpenSkillIndex← back to search
claude-code

Agent-almanac create-r-package

install
source · Clone the upstream repo
git clone https://github.com/pjt222/agent-almanac
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/ja/skills/create-r-package" ~/.claude/skills/pjt222-agent-almanac-create-r-package-4d1afe && rm -rf "$T"
manifest: i18n/ja/skills/create-r-package/SKILL.md
source content

Rパッケージの作成

モダンなツールとベストプラクティスに基づく、完全に設定されたRパッケージをスキャフォールドする。

使用タイミング

  • 新しいRパッケージをゼロから始める時
  • 散在するRスクリプトをパッケージに変換する時
  • 共同開発用のパッケージスケルトンを準備する時

入力

  • 必須: パッケージ名（小文字、
    .
    以外の特殊文字不可）
  • 必須: パッケージの目的を示す一行の説明
  • 任意: ライセンスの種類（デフォルト: MIT）
  • 任意: 著者情報（名前、メール、ORCID）
  • 任意: renvを初期化するかどうか（デフォルト: はい）

手順

ステップ1: パッケージスケルトンを作成する

usethis::create_package("packagename")
setwd("packagename")

期待結果: 

DESCRIPTION
、
NAMESPACE
、
R/
、
man/
サブディレクトリを含むディレクトリが作成される。

失敗時: usethisがインストールされていることを確認する（

install.packages("usethis")
）。ディレクトリが既に存在しないことを確認する。

ステップ2: DESCRIPTIONを設定する

DESCRIPTION
に正確なメタデータを記述する:

Package: packagename
Title: What the Package Does (Title Case)
Version: 0.1.0
Authors@R:
    person("First", "Last", , "email@example.com", role = c("aut", "cre"),
           comment = c(ORCID = "0000-0000-0000-0000"))
Description: One paragraph describing what the package does. Must be more
    than one sentence. Avoid starting with "This package".
License: MIT + file LICENSE
Encoding: UTF-8
Roxygen: list(markdown = TRUE)
RoxygenNote: 7.3.2
URL: https://github.com/username/packagename
BugReports: https://github.com/username/packagename/issues

期待結果: 

R CMD check
でメタデータの警告が出ない有効なDESCRIPTION。

失敗時: 

R CMD check
がDESCRIPTIONフィールドについて警告する場合、
Title
がタイトルケースであること、
Description
が1文以上であること、
Authors@R
が有効な 
person()
構文を使用していることを確認する。

ステップ3: インフラを構築する

usethis::use_mit_license()
usethis::use_readme_md()
usethis::use_news_md()
usethis::use_testthat(edition = 3)
usethis::use_git()
usethis::use_github_action("check-standard")

期待結果: LICENSE、README.md、NEWS.md、

tests/
ディレクトリ、
.git/
初期化、
.github/workflows/
が作成される。

失敗時: 

usethis::use_*()
関数が失敗した場合、不足している依存関係をインストールして再実行する。
.git/
が既に存在する場合、
use_git()
は初期化をスキップする。

ステップ4: 開発設定を作成する

.Rprofile
を作成する:

if (file.exists("renv/activate.R")) {
  source("renv/activate.R")
}

if (requireNamespace("mcptools", quietly = TRUE)) {
  mcptools::mcp_session()
}


.Renviron.example
を作成する:

RSTUDIO_PANDOC="C:/Program Files/RStudio/resources/app/bin/quarto/bin/tools"
# GITHUB_PAT=your_github_token_here


.Rbuildignore
エントリを作成する:

^\.Rprofile$
^\.Renviron$
^\.Renviron\.example$
^renv$
^renv\.lock$
^CLAUDE\.md$
^\.github$
^.*\.Rproj$

期待結果: 

.Rprofile
、
.Renviron.example
、
.Rbuildignore
が作成される。開発用ファイルがビルドされたパッケージから除外される。

失敗時: 

.Rprofile
が起動時にエラーを起こす場合、構文の問題を確認する。オプションパッケージが存在しない場合の失敗を防ぐため、
requireNamespace()
ガードが正しいことを確認する。

ステップ5: renvを初期化する

renv::init()

期待結果: 

renv/
ディレクトリと 
renv.lock
が作成される。プロジェクトローカルのライブラリが有効になる。

失敗時: 

install.packages("renv")
でrenvをインストールする。renvが初期化中にハングする場合、ネットワーク接続を確認するか 
options(timeout = 600)
を設定する。

ステップ6: パッケージドキュメントファイルを作成する

R/packagename-package.R
を作成する:

#' @keywords internal
"_PACKAGE"

## usethis namespace: start
## usethis namespace: end
NULL

期待結果: 

"_PACKAGE"
センチネルを含む 
R/packagename-package.R
が存在する。
devtools::document()
を実行するとパッケージレベルのヘルプが生成される。

失敗時: ファイル名が 

R/<packagename>-package.R
のパターンに一致していることを確認する。
"_PACKAGE"
文字列は関数内ではなく、独立した式として記述する必要がある。

ステップ7: CLAUDE.mdを作成する

プロジェクトルートにAIアシスタント向けのプロジェクト固有の指示を含む 

CLAUDE.md
を作成する。

期待結果: プロジェクト固有の編集規約、ビルドコマンド、アーキテクチャのメモを含む 

CLAUDE.md
がプロジェクトルートに存在する。

失敗時: 何を含めるか分からない場合は、パッケージ名、一行の説明、一般的な開発コマンド（

devtools::check()
、
devtools::test()
）、自明でない規約から始める。

バリデーション

  • devtools::check()
    がエラー0、警告0を返す
  • パッケージ構造が期待されるレイアウトと一致する
  • .Rprofile
    がエラーなく読み込まれる
  • renv::status()
    で問題がない
  • 適切な 
    .gitignore
    を持つGitリポジトリが初期化されている
  • GitHub Actionsワークフローファイルが存在する

よくある落とし穴

  • パッケージ名の重複: 名前を確定する前に 
    available::available("packagename")
    でCRANを確認する
  • .Rbuildignore
    エントリの不足    : 開発用ファイル（
    .Rprofile
    、
    .Renviron
    、
    renv/
    ）はビルドされたパッケージから除外する必要がある
  • Encodingの記述忘れ: DESCRIPTIONに必ず 
    Encoding: UTF-8
    を含める
  • RoxygenNoteの不一致: DESCRIPTIONのバージョンはインストール済みのroxygen2と一致する必要がある

使用例

# 最小構成での作成
usethis::create_package("myanalysis")

# 1セッションでのフルセットアップ
usethis::create_package("myanalysis")
usethis::use_mit_license()
usethis::use_testthat(edition = 3)
usethis::use_readme_md()
usethis::use_git()
usethis::use_github_action("check-standard")
renv::init()

関連スキル

  • write-roxygen-docs
    - 作成した関数のドキュメント作成
  • write-testthat-tests
    - パッケージのテスト追加
  • setup-github-actions-ci
    - CI/CDの詳細設定
  • manage-renv-dependencies
    - パッケージ依存関係の管理
  • write-claude-md
    - 効果的なAIアシスタント指示の作成