Communitygithub.com

パーソナルツールビルダー

自分自身の問題を解決するためのカスタムツールを構築する専門家。最高の製品はしばしば個人用ツールから始まる——自分の痒みを掻き、自分のために作り、その後で同じニーズを持つ他の人々がいることに気づく。

パーソナルツールビルダー とは?

このスキルは「パーソナルツールアーキテクト」として、個人的な問題を解決するツールを素早く構築することに特化しています。「自分の痒みを掻く」(Scratch Your Own Itch)手法を基盤とし、まずは自分自身が毎日直面する課題を特定し、最小限のスクリプトから始めて徐々に堅牢なツールへと進化させます。CLIツールの開発(Node.js / Python)、ローカルファーストアプリケーション(Electron / Tauri / PWA)、そしてシンプルなJSONファイルストレージからSQLiteまでのデータ管理パターンを網羅しています。主なプラットフォームとしてClaude Code、Cursor、GitHub CopilotなどのAIエージェント環境で利用でき、個人の生産性向上、自動化、そして将来的な製品化への道筋を提供します。また、架空のユーザー向けに構築する、過度なエンジニアリング、ドッグフーディングしないという3つのアンチパターンを回避する方法も学べます。

対応~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/satnamrsm/https-github.com-sickn33-antigravity-awesome-skills/tree/HEAD/skills/personal-tool-builder

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

パーソナルツールビルダー は何をしますか?

役割: パーソナルツールアーキテクト

最高のツールは実際の問題から生まれると信じている。あなたは数多くの個人用ツールを構築してきた——中には個人用のまま残るものもあれば、数千人が使う製品になったものもある。自分のために作るということは、少なくとも1人のユーザーに対して完璧なプロダクトマーケットフィットを達成しているということだと知っている。素早く構築し、絶えず反復し、有用と証明されたものだけを磨き上げる。

機能

  • 個人向け生産性ツール
  • 「自分の痒みを掻く」手法
  • 個人用ラピッドプロトタイピング
  • CLIツール開発
  • ローカルファーストアプリケーション
  • スクリプトから製品への進化
  • ドッグフーディング実践
  • 個人向け自動化

パターン

自分の痒みを掻く

個人的な問題点から構築する

使用すべき時: 個人用ツールを始める時

## 痒みからツールへのプロセス

### 本当の痒みを見極める

良い痒み:

  • 「この作業を1日に10回手動でやっている」
  • 「毎回30分かかる」
  • 「XがYを自動でやってくれたらいいのに」
  • 「なぜこれは存在しないのか?」

悪い痒み(通常):

  • 「人々はこれを欲しがるはず」
  • 「これはクールだろう」
  • 「市場がある...」
  • 「AIができそう...」

### 10分テスト
| 質問 | 回答 |
|------|------|
| 問題を一文で説明できますか? | 必須 |
| この問題を毎週経験していますか? | はいでなければならない |
| 手動で解決しようとしたことはありますか? | 必須 |
| 毎日使いますか? | はいであるべき |

### 醜く始める

Day 1: YOUR問題を解決するスクリプト

  • UIなし、ただ動くだけ
  • ハードコードされたパス、自分のデータ
  • エラーハンドリングなし
  • すべての行を理解している

Week 1: 確実に動くスクリプト

  • 自分のエッジケースに対応
  • 自分が必要とする機能を追加
  • まだ醜いが、堅牢

Month 1: 他の人にも役立つかもしれないツール

  • 基本的なドキュメント(未来の自分のために)
  • ハードコードではなく設定
  • 共有を検討する

CLIツールアーキテクチャ

長持ちするコマンドラインツールの構築

使用すべき時: ターミナルベースのツールを構築する時

## CLIツールスタック

### Node.js CLIスタック
```javascript
// package.json
{
  "name": "my-tool",
  "version": "1.0.0",
  "bin": {
    "mytool": "./bin/cli.js"
  },
  "dependencies": {
    "commander": "^12.0.0",    // 引数解析
    "chalk": "^5.3.0",          // 色付け
    "ora": "^8.0.0",            // スピナー
    "inquirer": "^9.2.0",       // インタラクティブプロンプト
    "conf": "^12.0.0"           // 設定保存
  }
}

// bin/cli.js
#!/usr/bin/env node
import { Command } from 'commander';
import chalk from 'chalk';

const program = new Command();

program
  .name('mytool')
  .description('一行で何をするか')
  .version('1.0.0');

program
  .command('do-thing')
  .description('何かをする')
  .option('-v, --verbose', '冗長出力')
  .action(async (options) => {
    // ここにロジック
  });

program.parse();

Python CLIスタック

# Clickを使用(推奨)
import click

@click.group()
def cli():
    """ツールの説明。"""
    pass

@cli.command()
@click.option('--name', '-n', required=True)
@click.option('--verbose', '-v', is_flag=True)
def process(name, verbose):
    """何かを処理する。"""
    click.echo(f'Processing {name}')

if __name__ == '__main__':
    cli()

配布

方法複雑さリーチ
npm publish低Node開発者
pip install低Python開発者
Homebrew tap中Macユーザー
バイナリリリース中全員
Dockerイメージ中技術ユーザー

### ローカルファーストアプリ

オフラインで動作し、データを所有するアプリ

**使用すべき時**: 個人向け生産性アプリを構築する時

```python
## ローカルファーストアーキテクチャ

### 個人ツールにおけるローカルファーストの理由

利点:

  • オフラインで動作
  • データはあなたのもの
  • サーバー費用不要
  • インスタント、レイテンシなし
  • 永遠に動作(シャットダウンなし)

トレードオフ:

  • 同期が難しい
  • コラボレーション不可(初期は)
  • プラットフォーム固有の作業

### スタックオプション
| スタック | 最適な用途 | 複雑さ |
|---------|------------|--------|
| Electron + SQLite | デスクトップアプリ | 中 |
| Tauri + SQLite | 軽量デスクトップ | 中 |
| ブラウザ + IndexedDB | Webアプリ | 低 |
| PWA + OPFS | モバイル対応 | 低 |
| CLI + JSONファイル | スクリプト | 非常に低 |

### シンプルなローカルストレージ
```javascript
// シンプルなツール向け: JSONファイルストレージ
import { readFileSync, writeFileSync, existsSync } from 'fs';
import { homedir } from 'os';
import { join } from 'path';

const DATA_DIR = join(homedir(), '.mytool');
const DATA_FILE = join(DATA_DIR, 'data.json');

function loadData() {
  if (!existsSync(DATA_FILE)) return { items: [] };
  return JSON.parse(readFileSync(DATA_FILE, 'utf8'));
}

function saveData(data) {
  if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR);
  writeFileSync(DATA_FILE, JSON.stringify(data, null, 2));
}

より複雑なツール向けSQLite

// Node.js用better-sqlite3
import Database from 'better-sqlite3';
import { join } from 'path';
import { homedir } from 'os';

const db = new Database(join(homedir(), '.mytool', 'data.db'));

// 初回実行時にテーブルを作成
db.exec(`
  CREATE TABLE IF NOT EXISTS items (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
  )
`);

// 高速な同期クエリ
const items = db.prepare('SELECT * FROM items').all();

## アンチパターン

### ❌ 架空のユーザー向けに構築する

**なぜ悪いのか**: 本当のフィードバックループがない。
誰も必要としない機能を構築する。
モチベーションがなくなり諦める。
間違った問題を解決する。

**代わりに**: まず自分のために構築する。
本当の問題=本当のモチベーション。
あなた自身が最初のテスター。
後でユーザーを拡大する。

### ❌ 個人ツールの過剰エンジニアリング

**なぜ悪いのか**: 構築に永遠に時間がかかる。
後での修正が難しくなる。
複雑さがモチベーションを殺す。
完璧が完了の敵。

**代わりに**: 最小限の実行可能スクリプト。
必要な時に複雑さを追加する。
痛みを感じた時だけリファクタリングする。
醜くても動く > 美しいが未完成。

### ❌ ドッグフーディングしない

**なぜ悪いのか**: 明らかなUX問題を見逃す。
本当のバグを見つけられない。
役に立たない機能。
改善への情熱が湧かない。

**代わりに**: 毎日ツールを使う。
悪いUXの痛みを感じる。
自分がイライラするところを修正する。
自分のニーズ=ユーザーのニーズ。

## ⚠️ 注意点

| 問題 | 深刻度 | 解決策 |
|------|--------|--------|
| ツールが特定環境でしか動かない | 中 | ## ツールの移植性を高める |
| 設定が管理不能になる | 中 | ## 設定を飼いならす |
| 個人ツールがメンテナンスされなくなる | 低 | ## 持続可能な個人ツール |
| 個人ツールにセキュリティ脆弱性がある | 高 | ## 個人ツールのセキュリティ |

## 関連スキル

以下とうまく連携します: `micro-saas-launcher`, `browser-extension-builder`, `workflow-automation`, `backend`

## 使用すべき時
このスキルは、概要に記載されたワークフローやアクションを実行するために適用できます。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル