arch-tsdown-cli について
tsdownでTypeScript CLIパッケージを作るためのスタータースキルです。ライブラリと実行コマンドを備える最小構成を求める開発者向けに、ESMビルド、型定義生成、テスト、リリースの指針を説明します。
主な機能
- 01ライブラリと実行コマンドの構成
- 02ESMビルドと型定義生成
- 03tsxによる開発用コマンド
- 04pnpm、Vitest、ESLintの設定
- 05CIとリリースの資料
活用シーン
- 01TypeScript CLIパッケージの作成開始
- 02開発用と本番用バイナリの設定
- 03パッケージ公開設定とリリース手順の準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hairyf/ skills --skill arch-tsdown-cliインストール後、Claude Code で/arch-tsdown-cliを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
GENERATION.mdassets/ci.ymlrelease.ymlreferences/best-practices-cli.mdcore-bin-entry.mdcore-ci.mdcore-git-hooks.mdcore-overview.mdcore-package-exports.mdcore-scripts.mdcore-testing.mdcore-tooling.mdcore-tsdown-config.md詳細
arch-tsdown-cli は、ビルドに tsdown を使用する TypeScript CLI パッケージのスターターです(hairyf/starter-cli に基づいています)。最小限で明確な方針のセットアップを提供します。ライブラリと実行可能ファイルの両方を備えた構成、ESM のみの出力、自動 .d.ts 生成、tsx による開発用実行可能ファイル、pnpm、Vitest、ESLint、CI ベースのリリース向けのオプションの npm Trusted Publisher などが含まれます。
このスキルは starter-cli(arch-tsdown-cli ソース)に基づいており、2026-01-30 に生成されました。
推奨プラクティス:
- ローカルでは開発用実行可能ファイル(tsx)を使用し、publishConfig では本番用実行可能ファイル(dist)を使用します
- 純粋な ESM をビルドし、
dtsを有効にして、依存関係にはexternalを維持します - リリースには npm Trusted Publisher を使用します
コアリファレンス
| トピック | 説明 | リファレンス |
|---|---|---|
| 概要 | プロジェクトの目的、構成、使用する場面 | core-overview |
| 実行可能ファイルのエントリーポイント | 開発用と本番用の実行可能ファイル、シバン、tsx | core-bin-entry |
| tsdown の設定 | entry、format、dts、external | core-tsdown-config |
| スクリプトとリリース | build、dev、start、release、npm Trusted Publisher | core-scripts |
| パッケージのエクスポート | dist、bin、publishConfig、files | core-package-exports |
| ツール類 | ESLint、TypeScript、Vitest の設定 | core-tooling |
| Git フック | simple-git-hooks、lint-staged、pre-commit | core-git-hooks |
| CI | GitHub Actions — lint、typecheck、テストマトリックス | core-ci |
| テスト | Vitest、vitest-package-exports | core-testing |
ベストプラクティス
| トピック | 説明 | リファレンス |
|---|---|---|
| CLI とパッケージ | bin、ESM、dts、external、リリース | best-practices-cli |
コメント
Markdown 対応