npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

ai-custom-template-prompt

v0.5.4

Published

CLI tool for managing AI custom templates (Cursor, Agents)

Downloads

77

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

redamoonredamoon

Keywords

cliaicursortemplates

Readme

ai-custom-template-prompt

AI開発ツール（Cursor、Agents）向けのカスタムテンプレート管理CLIツールです。

クイックスタート

# npxで直接実行（インストール不要）
npx ai-custom-template-prompt init
npx ai-custom-template-prompt list
npx ai-custom-template-prompt add cursor-rules
npx ai-custom-template-prompt doctor
npx ai-custom-template-prompt update-readme
npx ai-custom-template-prompt release patch

主な機能

  • ✅ Cursorルール: コード品質、テスト、コーディング規約のルール定義
  • ✅ ネストされたルール: ディレクトリ別にルールを適用（backend/frontend/server）
  • ✅ Cursorコマンド: /で呼び出せる再利用可能なワークフロー（PR作成、ブランチ作成など）
  • ✅ Cursorスキル: 再利用可能なスキルテンプレート（textlintセットアップ、Zenn執筆など）
  • ✅ 自動適用: ファイルタイプやディレクトリに応じて自動的にルールを適用
  • ✅ Manualルール: @ruleNameで明示的に指定して使用
  • ✅ 対話式インストール: 3つのモード（一括/カテゴリ/個別）から選択可能

インストール

GitHub Packages（Private）からインストール

チーム内で使用する場合：

# .npmrcファイルを作成（.npmrc.exampleを参考）
# GitHub Personal Access Tokenが必要（repo, write:packages, read:packages権限）

npm install @redamoon/ai-custom-template-prompt --registry=https://npm.pkg.github.com

# または、グローバルインストール
npm install -g @redamoon/ai-custom-template-prompt --registry=https://npm.pkg.github.com

Public npmからインストール

# グローバルインストール
npm install -g ai-custom-template-prompt

# または、ローカルインストール
npm install ai-custom-template-prompt

# または、npxで直接実行（インストール不要）
npx ai-custom-template-prompt list
npx ai-custom-template-prompt init
npx ai-custom-template-prompt add cursor-rules
npx ai-custom-template-prompt doctor

開発用インストール

# リポジトリをクローン
git clone https://github.com/redamoon/ai-custom-template-prompt.git
cd ai-custom-template-prompt

# 依存関係のインストール
pnpm install

使用方法

コマンド一覧

| コマンド | 説明 | |---------|------| | init | 初回セットアップ（対話式でテンプレートを選択） | | add <template> | 指定テンプレートを追加 | | list | 利用可能なテンプレート一覧を表示 | | doctor | 設定チェック（テンプレートファイルの配置状況を確認） | | update-readme | READMEを自動生成 | | release <type> | リリースを実行（patch/minor/major） |

初回セットアップ（対話式）

# インストール済みの場合
ai-custom-template-prompt init

# または npxで実行
npx ai-custom-template-prompt init

# dry-runモード（実際のファイル操作なしで確認）
npx ai-custom-template-prompt init --dry-run

対話式で3つのインストールモードから選択できます。

  • 🚀 すべて一括インストール - rules, commands, skills, agentsを全てインストール
  • 📁 カテゴリ単位で選択 - Rules, Commands, Skills, Agentsからマルチ選択
  • 📋 個別に選択 - 各カテゴリ内でテンプレートをマルチ選択

テンプレートを追加

# 対話式で選択（引数なし）
ai-custom-template-prompt add
npx ai-custom-template-prompt add

# 直接指定
ai-custom-template-prompt add cursor-rules
npx ai-custom-template-prompt add cursor-rules

# dry-runモード
npx ai-custom-template-prompt add --dry-run

利用可能なテンプレート名:

Rules（ルール）

  • cursor-rules - Cursor用基本ルールファイル（常に適用）
  • cursor-manual-rules - Manualルール（@manual-rulesで明示的に指定）
  • cursor-test-rules - テストファイル用ルール（自動適用）
  • cursor-api-rules - API関連コード用ルール（自動適用）
  • cursor-backend-rules - バックエンド用ルール（ネスト: backend/.cursor/rules/）
  • cursor-frontend-rules - フロントエンド用ルール（ネスト: frontend/.cursor/rules/）
  • cursor-server-rules - サーバー用ルール（ネスト: backend/server/.cursor/rules/）
  • cursor-writing - 日本語執筆ルール

Commands（コマンド）

  • cursor-command-create-pr - PR作成コマンド
  • cursor-command-create-branch - ブランチ作成コマンド
  • cursor-command-update-readme - README更新コマンド
  • cursor-command-release - リリースコマンド

Skills（スキル）

  • cursor-skill-textlint-setup - textlintセットアップスキル（AI文章検出ルール対応）
  • cursor-skill-textlint-blog - ブログ記事用textlintチェックスキル（任意フォルダ対応）
  • cursor-skill-zenn-blog-writing - Zenn技術ブログ執筆スキル
  • cursor-skill-hatena-blog-markdown - はてなブログMarkdown記法スキル（任意フォルダ対応）
  • cursor-skill-hatena-syntax-highlight - はてなブログシンタックスハイライトスキル（任意フォルダ対応）
  • cursor-skill-refactoring-legacy-code - レガシーコードリファクタリングスキル
  • cursor-skill-sql-antipatterns - SQLアンチパターン検出・修正スキル（第2版準拠）

Agents

  • agent-agents - Agents設定ファイル

テンプレート一覧を表示

# インストール済みの場合
ai-custom-template-prompt list

# または npxで実行
npx ai-custom-template-prompt list

設定チェック

# インストール済みの場合
ai-custom-template-prompt doctor

# または npxで実行
npx ai-custom-template-prompt doctor

プロジェクト内のテンプレートファイルの配置状況を確認できます。

テンプレートの配置先

プロジェクトルートのルール

  • .cursor/rules/rules.mdc - Cursor基本ルール（常に適用）
  • .cursor/rules/manual-rules.mdc - Manualルール（@manual-rulesで指定）
  • .cursor/rules/test-rules.mdc - テストファイル用ルール（自動適用）
  • .cursor/rules/api-rules.mdc - API関連コード用ルール（自動適用）

ネストされたルール（ディレクトリ別）

  • backend/.cursor/rules/backend-rules.mdc - バックエンド用ルール
  • frontend/.cursor/rules/frontend-rules.mdc - フロントエンド用ルール
  • backend/server/.cursor/rules/server-rules.mdc - サーバー用ルール

Cursorコマンド

  • .cursor/commands/create-pr.md - PR作成コマンド（/create-prで呼び出し）
  • .cursor/commands/create-branch.md - ブランチ作成コマンド（/create-branchで呼び出し）
  • .cursor/commands/update-readme.md - README更新コマンド（/update-readmeで呼び出し）
  • .cursor/commands/release.md - リリースコマンド（/releaseで呼び出し）

コマンドはチャット入力欄で / を入力すると自動的に表示され、ワークフローを標準化できます。

Cursorスキル

  • .cursor/skills/textlint-setup/SKILL.md - textlintセットアップスキル

    • textlintのインストール手順
    • @textlint-ja/textlint-rule-preset-ai-writing の設定
    • AI文章検出ルールの設定

  • .cursor/skills/textlint-blog/SKILL.md - ブログ記事用textlintチェックスキル

    • 任意フォルダ内のMarkdownファイルをチェック
    • 技術文書の品質向上
    • AI生成テキスト特有の表現を検出・修正

  • .cursor/skills/zenn-blog-writing/SKILL.md - Zenn技術ブログ執筆スキル

    • フロントマターの書き方
    • 文章品質の基準
    • AIっぽい文章の排除ガイドライン
    • レビュー時のチェックリスト

  • .cursor/skills/hatena-blog-markdown/SKILL.md - はてなブログMarkdown記法スキル

    • 見出しはh3から始めるルール
    • はてな独自の記法（目次、フォトライフ、TeX数式など）
    • 任意フォルダに対応

  • .cursor/skills/hatena-syntax-highlight/SKILL.md - はてなブログシンタックスハイライトスキル

    • コードブロックのシンタックスハイライト記法
    • 500以上の言語に対応
    • 任意フォルダに対応

  • .cursor/skills/refactoring-legacy-code/SKILL.md - レガシーコードリファクタリングスキル

    • レガシーコードの分析とリファクタリング戦略
    • 段階的な改善アプローチ
    • テスト駆動リファクタリング

  • .cursor/skills/sql-antipatterns/SKILL.md - SQLアンチパターン検出・修正スキル

    • SQLアンチパターン第2版（Bill Karwin著、和田卓人監訳）準拠
    • データベース論理設計・物理設計のアンチパターン検出
    • クエリ・アプリケーション開発のアンチパターン検出
    • ミニ・アンチパターン一覧（15個）
    • レビュー時のチェックリスト

スキルはCursorが自動的に検出し、関連するタスクで活用されます。

その他のテンプレート

  • AGENTS.md - Agents設定（プロジェクトルート）

ルールの適用方法

  • 基本ルール (rules/rules.mdc): alwaysApply: true で常に適用
  • Manualルール (manual-rules.mdc): @manual-rules で明示的に指定した場合のみ適用
  • テストルール (test-rules.mdc): globs: ["**/*.test.ts"] でテストファイルに自動適用
  • APIルール (api-rules.mdc): globs: ["**/api/**/*"] でAPIディレクトリに自動適用
  • バックエンドルール (backend-rules.mdc): globs: ["backend/**/*"] でバックエンドディレクトリに自動適用
  • フロントエンドルール (frontend-rules.mdc): globs: ["frontend/**/*"] でフロントエンドディレクトリに自動適用
  • サーバールール (server-rules.mdc): globs: ["backend/server/**/*"] でサーバーディレクトリに自動適用

ネストされたルールの動作

Cursorは、ファイルが参照されたときに、そのファイルが含まれるディレクトリの.cursor/rulesディレクトリ内のルールを自動的に適用します。

例：

  • backend/api/users.ts を開くと → backend/.cursor/rules/backend-rules.mdc が適用される
  • frontend/components/Button.tsx を開くと → frontend/.cursor/rules/frontend-rules.mdc が適用される
  • backend/server/index.ts を開くと → backend/server/.cursor/rules/server-rules.mdc が適用される

ビルド

# TypeScriptをコンパイル
pnpm build

# ビルド後は dist/ ディレクトリに出力される

ローカルでCLIをリンクして使用

# プロジェクトをグローバルにリンク
pnpm link --global

# または、別のプロジェクトからリンク
cd /path/to/your-project
pnpm link ai-custom-template-prompt

# CLIコマンドが使用可能になる
ai-custom-template-prompt list
ai-custom-template-prompt init
ai-custom-template-prompt add cursor-rules
ai-custom-template-prompt doctor

開発

ローカル開発環境のセットアップ

# リポジトリをクローン
git clone https://github.com/redamoon/ai-custom-template-prompt.git
cd ai-custom-template-prompt

# 依存関係のインストール
pnpm install

# 開発モードで実行（tsxを使用）
pnpm dev <command>

動作確認手順

  1. 依存関係のインストール

    pnpm install

  2. テンプレート一覧の確認

    pnpm dev list

  3. 対話式セットアップのテスト

    pnpm dev init

  4. 単体テンプレート追加のテスト

    pnpm dev add cursor-rules

  5. 設定チェックのテスト

    pnpm dev doctor

テンプレートのカスタマイズ

templates/ ディレクトリ内のファイルを編集することで、テンプレートの内容をカスタマイズできます。

Cursorルール

  • templates/cursor/rules/rules.mdc - 基本ルール（コード品質、テスト、コーディング規約）
  • templates/cursor/rules/manual-rules.mdc - Manualルール（高度なパターン）
  • templates/cursor/rules/test-rules.mdc - テストファイル用ルール
  • templates/cursor/rules/api-rules.mdc - API関連コード用ルール
  • templates/cursor/rules/backend-rules.mdc - バックエンド用ルール
  • templates/cursor/rules/frontend-rules.mdc - フロントエンド用ルール
  • templates/cursor/rules/server-rules.mdc - サーバー用ルール
  • templates/cursor/rules/writing.mdc - 日本語執筆ルール

Cursorコマンド

  • templates/cursor/commands/create-pr.md - PR作成コマンド
  • templates/cursor/commands/create-branch.md - ブランチ作成コマンド
  • templates/cursor/commands/update-readme.md - README更新コマンド
  • templates/cursor/commands/release.md - リリースコマンド

Cursorスキル

  • templates/cursor/skills/textlint-setup/SKILL.md - textlintセットアップスキル
  • templates/cursor/skills/textlint-blog/SKILL.md - ブログ記事用textlintチェックスキル
  • templates/cursor/skills/zenn-blog-writing/SKILL.md - Zenn技術ブログ執筆スキル
  • templates/cursor/skills/hatena-blog-markdown/SKILL.md - はてなブログMarkdown記法スキル
  • templates/cursor/skills/hatena-syntax-highlight/SKILL.md - はてなブログシンタックスハイライトスキル
  • templates/cursor/skills/refactoring-legacy-code/SKILL.md - レガシーコードリファクタリングスキル
  • templates/cursor/skills/sql-antipatterns/SKILL.md - SQLアンチパターン検出・修正スキル

その他のテンプレート

  • templates/agents/Agents.md - Agents設定

コマンドの使用方法

Cursorのチャットで / を入力すると、利用可能なコマンドが自動的に表示されます：

  • /create-pr - PR作成のワークフローを実行
  • /create-branch - ブランチ作成のワークフローを実行

コマンドはプロジェクトの .cursor/commands ディレクトリに保存され、チーム全体で共有できます。

パッケージ配布

このパッケージは以下の2つの方法で配布されます：

1. GitHub Packages（Private）

  • 対象: チーム内メンバーのみ
  • パッケージ名: @redamoon/ai-custom-template-prompt
  • レジストリ: https://npm.pkg.github.com
  • 認証: GitHub Personal Access Token（PAT）が必要

セットアップ手順

  1. GitHub Personal Access Tokenを作成

    • 権限: repo, write:packages, read:packages
    • Settings → Developer settings → Personal access tokens → Tokens (classic)

  2. .npmrcファイルを作成

    @redamoon:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=YOUR_PERSONAL_ACCESS_TOKEN

  3. インストール

    npm install @redamoon/ai-custom-template-prompt --registry=https://npm.pkg.github.com

2. Public npm

  • 対象: 誰でも利用可能
  • パッケージ名: ai-custom-template-prompt
  • レジストリ: https://registry.npmjs.org

インストール

npm install -g ai-custom-template-prompt

自動公開

GitHub Actionsワークフローにより、タグを作成すると自動的に両方のレジストリに公開されます：

# バージョンタグを作成
git tag v0.1.0
git push origin v0.1.0

必要なシークレット設定

GitHubリポジトリのSettings → Secrets and variables → Actionsに以下を設定：

  • NPM_TOKEN: npmjs.comのアクセストークン（Public npm公開用）
    • npmjs.comでログイン後、Access Tokensから作成
    • 権限: Automation または Publish

ライセンス

MIT