arch-tsdown について
arch-tsdown は starter-ts を基にした TypeScript ライブラリのスターター兼ガイドスキルです。tsdown を使う開発者向けに、ESM 中心のビルドとテストの構成をまとめています。
主な機能
- 01tsdown のビルド設定
- 02.d.ts の自動生成
- 03pnpm ワークスペース設定
- 04Vitest と ESLint の構成
- 05CI とリリースのガイド
活用シーン
- 01TypeScript ライブラリの開始
- 02パッケージのエクスポートと型の設定
- 03テストと CI リリースの構築
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hairyf/ skills --skill arch-tsdownインストール後、Claude Code で/arch-tsdownを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
GENERATION.mdassets/ci.ymlrelease.ymlreferences/best-practices-tsdown.mdcore-ci.mdcore-git-hooks.mdcore-overview.mdcore-package-exports.mdcore-pnpm-workspace.mdcore-release.mdcore-scripts.mdcore-testing.mdcore-tooling.mdcore-tsdown-config.md詳細
arch-tsdown は、ビルドに tsdown を使用する TypeScript ライブラリのスターター(antfu/starter-ts をベースにしています)です。最小限で、特定の方針に沿ったセットアップを提供します。ESM のみの出力、自動 .d.ts 生成、pnpm、Vitest、ESLint、CI ベースのリリースに使用できるオプションの npm Trusted Publisher を備えています。
このスキルは starter-ts(arch-tsdown のソース)をベースにしており、2026-01-30 に生成されました。
推奨プラクティス:
- 純粋な ESM としてビルドし、tsdown の設定で
dtsとexportsを有効にします - リリースには npm Trusted Publisher を使用します
- 公開前に publint(tsdown の
publint: true経由)を実行します
コアリファレンス
| トピック | 説明 | リファレンス |
|---|---|---|
| 概要 | プロジェクトの目的、構成、使用する場面 | core-overview |
| tsdown の設定 | entry、dts、exports、publint | core-tsdown-config |
| スクリプトとリリース | build、dev、start、release、npm Trusted Publisher | core-scripts |
| パッケージのエクスポート | dist の出力、types、exports、sideEffects | core-package-exports |
| pnpm ワークスペース | カタログ、バージョン管理、ワークスペース | core-pnpm-workspace |
| ツール | ESLint、TypeScript、Vitest の設定 | core-tooling |
| Git フック | simple-git-hooks、lint-staged、pre-commit | core-git-hooks |
| CI | GitHub Actions — lint、typecheck、テストマトリックス | core-ci |
| リリース | タグのプッシュ、sxzz/workflows、npm Trusted Publisher | core-release |
| テスト | Vitest、vitest-package-exports、エクスポートのスナップショット | core-testing |
ベストプラクティス
| トピック | 説明 | リファレンス |
|---|---|---|
| tsdown とパッケージ | ESM、dts、exports、ツールの整合性 | best-practices-tsdown |
コメント
Markdown 対応