mcpField
F
file-organizer

file-organizer

github.com/89jobrien生産性437 回インストール9 週間前に更新
リポジトリ

file-organizer について

file-organizer は、Claude Code でファイルを整理するスキルです。重複ファイルを探してフォルダー構成を提案し、承認後に移動や名前変更を行い、変更を記録します。

主な機能

  1. 01フォルダーとファイル形式の分析
  2. 02重複ファイルの検出
  3. 03フォルダー構成の提案
  4. 04承認後の移動と名前変更
  5. 05取り消しに備えた変更記録

活用シーン

  1. 01散らかった Downloads フォルダーの整理
  2. 02削除前の重複ファイル確認
  3. 03進行中のプロジェクトとアーカイブの分離
  4. 04日付ごとの写真整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/89jobrien/steve --skill file-organizer

インストール後、Claude Code で/file-organizerを入力して読み込まれたか確認します。

詳細

ファイルオーガナイザー

このスキルは、パソコン全体のファイル構成をすっきりと論理的に保つのに役立つ、あなた専用の整理アシスタントです。常に手作業で整理する負担を軽減します。

このスキルを使う場面

  • ダウンロードフォルダーが散らかっている
  • ファイルがあちこちに散らばっていて見つからない
  • 重複ファイルが容量を圧迫している
  • フォルダー構成が分かりにくくなっている
  • 整理整頓の習慣を身につけたい
  • 新しいプロジェクトを始めるにあたり、適切な構成が必要
  • 古いプロジェクトをアーカイブする前に整理したい

このスキルでできること

  1. 現在の構成を分析:フォルダーやファイルを確認し、現在の状態を把握します
  2. 重複を検出:システム全体から重複ファイルを特定します
  3. 整理方法を提案:ファイルの内容に基づいて、論理的なフォルダー構成を提案します
  4. 整理を自動化:承認を得たうえで、ファイルの移動、名前変更、整理を行います
  5. 状況を考慮:ファイルの種類、日付、内容に基づいて適切に判断します
  6. 散らかりを解消:もう必要ないと思われる古いファイルを特定します

使い方

ホームディレクトリから
cd ~

その後、Claude Codeを起動して、サポートを依頼します:

Help me organize my Downloads folder
Find duplicate files in my Documents folder
Review my project directories and suggest improvements
特定の整理タスク
Organize these downloads into proper folders based on what they are
Find duplicate files and help me decide which to keep
Clean up old files I haven't touched in 6+ months
Create a better folder structure for my [work/projects/photos/etc]

手順

ユーザーからファイル整理のサポートを依頼された場合:

  1. 対象範囲を把握する

    確認のための質問をします:

    • どのディレクトリを整理しますか?(ダウンロード、書類、ホームフォルダー全体など)
    • 主な問題は何ですか?(ファイルが見つからない、重複している、散らかりすぎている、構成がないなど)
    • 対象外にするファイルやフォルダーはありますか?(進行中のプロジェクト、機密データなど)
    • どの程度しっかり整理しますか?(控えめに整理するか、徹底的に整理するか)
  2. 現在の状態を分析する

    対象ディレクトリを確認します:

    # Get overview of current structure
    ls -la [target_directory]
    
    # Check file types and sizes
    find [target_directory] -type f -exec file {} \; | head -20
    
    # Identify largest files
    du -sh [target_directory]/* | sort -rh | head -20
    
    # Count file types
    find [target_directory] -type f | sed 's/.*\.//' | sort | uniq -c | sort -rn
    

    調査結果をまとめます:

    • ファイルとフォルダーの合計数
    • ファイルの種類ごとの内訳
    • サイズの分布
    • 日付の範囲
    • 明らかな整理上の問題
  3. 整理のパターンを特定する

    ファイルに基づいて、論理的な分類を決めます:

    種類別:

    • 書類(PDF、DOCX、TXT)
    • 画像(JPG、PNG、SVG)
    • 動画(MP4、MOV)
    • アーカイブ(ZIP、TAR、DMG)
    • コード/プロジェクト(コードを含むディレクトリ)
    • スプレッドシート(XLSX、CSV)
    • プレゼンテーション(PPTX、KEY)

    用途別:

    • 仕事用と個人用
    • 進行中とアーカイブ
    • プロジェクト別
    • 参考資料
    • 一時ファイル/作業用ファイル

    日付別:

    • 今年/今月
    • 過去の年
    • かなり古いファイル(アーカイブ候補)
  4. 重複を検出する

    依頼された場合は、重複を検索します:

    # Find exact duplicates by hash
    find [directory] -type f -exec md5 {} \; | sort | uniq -d
    
    # Find files with same name
    find [directory] -type f -printf '%f\n' | sort | uniq -d
    
    # Find similar-sized files
    find [directory] -type f -printf '%s %p\n' | sort -n
    

    重複しているファイルごとに:

    • すべてのファイルパスを表示する
    • サイズと更新日を表示する
    • 残すファイルを推奨する(通常は最も新しいもの、または最も分かりやすい名前のもの)
    • 重要:削除する前に必ず確認を求める
  5. 整理計画を提案する

    変更を加える前に、分かりやすい計画を提示します:

    # Organization Plan for [Directory]
    
    ## Current State
    - X files across Y folders
    - [Size] total
    - File types: [breakdown]
    - Issues: [list problems]
    
    ## Proposed Structure
    
    

    [ディレクトリ]/ ├── 仕事/ │ ├── プロジェクト/ │ ├── 書類/ │ └── アーカイブ/ ├── 個人/ │ ├── 写真/ │ ├── 書類/ │ └── メディア/ └── ダウンロード/ ├── 未整理/ └── アーカイブ/

    
    ## Changes I'll Make
    
    1. **Create new folders**: [list]
    2. **Move files**:
       - X PDFs → Work/Documents/
       - Y images → Personal/Photos/
       - Z old files → Archive/
    3. **Rename files**: [any renaming patterns]
    4. **Delete**: [duplicates or trash files]
    
    ## Files Needing Your Decision
    
    - [List any files you're unsure about]
    
    Ready to proceed? (yes/no/modify)
    
  6. 整理を実行する

    承認を得た後、計画的に整理します:

    # Create folder structure
    mkdir -p "path/to/new/folders"
    
    # Move files with clear logging
    mv "old/path/file.pdf" "new/path/file.pdf"
    
    # Rename files with consistent patterns
    # Example: "YYYY-MM-DD - Description.ext"
    

    重要なルール:

    • 削除する前に必ず確認する
    • 後で元に戻せるよう、移動をすべて記録する
    • 元の更新日を保持する
    • ファイル名が競合した場合は適切に対処する
    • 想定外の状況が発生した場合は作業を止めて確認する
  7. 概要とメンテナンスのヒントを提示する

    整理の完了後:

    # Organization Complete! ✨
    
    ## What Changed
    
    - Created [X] new folders
    - Organized [Y] files
    - Freed [Z] GB by removing duplicates
    - Archived [W] old files
    
    ## New Structure
    
    [Show the new folder tree]
    
    ## Maintenance Tips
    
    To keep this organized:
    
    1. **Weekly**: Sort new downloads
    2. **Monthly**: Review and archive completed projects
    3. **Quarterly**: Check for new duplicates
    4. **Yearly**: Archive old files
    
    ## Quick Commands for You
    
    ```bash
    # Find files modified this week
    find . -type f -mtime -7
    
    # Sort downloads by type
    [custom command for their setup]
    
    # Find duplicates
    [custom command]
    

    別のフォルダーも整理しますか?

Examples

Example 1: Organizing Downloads (From Justin Dielmann)

User: "My Downloads folder is a mess with 500+ files. Help me organize it."

Process:

  1. Analyzes Downloads folder
  2. Finds patterns: work docs, personal photos, installers, random PDFs
  3. Proposes structure:
    • Downloads/
      • Work/
      • Personal/
      • Installers/ (DMG, PKG files)
      • Archive/
      • ToSort/ (things needing decisions)
  4. Asks for confirmation
  5. Moves files intelligently based on content and names
  6. Results: 500 files → 5 organized folders
Example 2: Finding and Removing Duplicates

User: "Find duplicate files in my Documents and help me decide which to keep."

Output:

# Found 23 Sets of Duplicates (156 MB total)

## Duplicate Set 1: "proposal.pdf"
- `/Documents/proposal.pdf` (2.3 MB, modified: 2024-03-15)
- `/Documents/old/proposal.pdf` (2.3 MB, modified: 2024-03-15)
- `/Desktop/proposal.pdf` (2.3 MB, modified: 2024-03-10)

**Recommendation**: Keep `/Documents/proposal.pdf` (most recent in correct location)
Delete the other 2 copies?

[Continue for all duplicates...]
例3:プロジェクトフォルダーの再構成

ユーザー:「~/Projects ディレクトリを確認して、改善案を提案してください。」

出力:

# Analysis of ~/Projects

## Current Structure Issues
- Mix of active and archived projects (3+ years old)
- No consistent naming convention
- Some projects at root, others in random subfolders
- Duplicate folders (project-name, project-name-old, project-name-v2)

## Proposed Structure

プロジェクト/ ├── 進行中/ │ ├── クライアントの作業/ │ ├── 個人プロジェクト/ │ └── 学習/ ├── アーカイブ/ │ ├── 2022/ │ ├── 2023/ │ └── 2024/ └── テンプレート/


## Specific Changes
1. Move 12 projects not touched since 2022 → Archive/
2. Consolidate 4 duplicate project folders
3. Rename projects to consistent format: "client-name-project-name"
4. Create Archive for old work

Want me to implement this?
例 4:写真を日付ごとに整理する

ユーザー:「写真フォルダーを年と月ごとに整理してください。」

出力:次のような構造を作成します:

Photos/
├── 2023/
│   ├── 01-January/
│   ├── 02-February/
│   └── ...
├── 2024/
│   ├── 01-January/
│   └── ...
└── Unsorted/

その後、EXIF データまたはファイルの変更日時に基づいて写真を移動します。

よくある整理タスク

ダウンロードフォルダーの整理
Organize my Downloads folder - move documents to Documents,
images to Pictures, keep installers separate, and archive files
older than 3 months.
プロジェクトの整理
Review my Projects folder structure and help me separate active
projects from old ones I should archive.
重複ファイルの削除
Find all duplicate files in my Documents folder and help me
decide which ones to keep.
デスクトップの整理
My Desktop is covered in files. Help me organize everything into
my Documents folder properly.
写真の整理
Organize all photos in this folder by date (year/month) based
on when they were taken.
仕事用/個人用の分離
Help me separate my work files from personal files across my
Documents folder.

プロのヒント

  1. 小さく始める:まずは散らかったフォルダー(ダウンロードフォルダーなど)を一つ整理して、信頼を築きましょう
  2. 定期的なメンテナンス:ダウンロードフォルダーを毎週整理しましょう
  3. 一貫した命名:重要なファイルには「YYYY-MM-DD - 説明」の形式を使いましょう
  4. 積極的にアーカイブする:古いプロジェクトは削除せず、アーカイブに移動しましょう
  5. 作業中の項目を分けておく:作業中のものとアーカイブ済みのものを明確に分けましょう
  6. プロセスを信頼する:ファイルの保存先を決める認知負荷は Claude に任せましょう

ベストプラクティス

フォルダーの命名
  • 明確で説明的な名前を使う
  • スペースを避ける(ハイフンまたはアンダースコアを使う)
  • 具体的にする:「docs」ではなく「client-proposals」
  • 並べ替え用の接頭辞を使う:「01-current」、「02-archive」
ファイルの命名
  • 日付を含める:「2024-10-17-meeting-notes.md」
  • 説明的な名前にする:「q3-financial-report.xlsx」
  • 名前にバージョン番号を含めない(代わりにバージョン管理を使う)
  • ダウンロード時に付加された文字列を削除する:「document-final-v2 (1).pdf」→「document.pdf」
アーカイブするタイミング
  • 6 か月以上手を付けていないプロジェクト
  • 後で参照する可能性のある完了済みの作業
  • 新しいシステムへの移行後の古いバージョン
  • 削除をためらうファイル(まずアーカイブする)

関連するユースケース

  • 新しいコンピューター向けの整理環境の設定
  • バックアップ/アーカイブ用のファイルの準備
  • ストレージを整理する前の片付け
  • 共有チームフォルダーの整理
  • 新しいプロジェクトディレクトリの構成

コメント