スキル caveman-compress

caveman-compress

低リスク ⚙️ 外部コマンド🔑 環境変数

メモリファイルを圧縮してトークンコストを削減

CLAUDE.md のような大容量メモリファイルは、AIセッション開始ごとにトークンを無駄に消費します。このスキルは、技術コンテンツを完全に保持したまま、約46%圧縮します。

対応: Claude Codex Code(CC)
🥉 75 ブロンズ
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「caveman-compress」を使用しています。 TypeScript設定、テストガイドライン、プロジェクト規約が完全な散文で記述された706トークンのCLAUDE.mdファイル。

期待される結果:

すべての技術指示をダイレクトなキャヴマンスタイルの散文で保持した285トークンの圧縮版。見出し、コード例、URLは変更されません。元のファイルは CLAUDE.original.md として保存されます。

「caveman-compress」を使用しています。 アーキテクチャ説明、デプロイ手順、チーム規約が記載された1145トークンのプロジェクトノートファイル。

期待される結果:

535トークンの圧縮ファイル。すべてのセクション見出しは正確に保持。コードブロックとURLはそのまま。冗長な説明は重要な事実に凝縮。バックアップは project-notes.original.md として保存。

セキュリティ監査

低リスク
v1 • 4/15/2026

Static analysis flagged 107 potential issues across 10 files with a risk score of 100/100. After semantic evaluation, all flagged patterns are false positives. The external_commands findings (74 locations) are primarily markdown backticks in documentation files misidentified as shell execution. The one real subprocess call in scripts/compress.py uses hardcoded arguments with stdin input and no shell interpolation. Network findings (2 locations) are static URLs in README.md documentation, not runtime requests. Filesystem findings (2 locations) are standard path resolution for a file-processing tool. Environment access findings (9 locations) are legitimate ANTHROPIC_API_KEY and CAVEMAN_MODEL configuration for API usage. The critical heuristic finding about code execution plus network plus credential access is a false positive describing the normal operation of an Anthropic API client. No prompt injection attempts, data exfiltration patterns, or malicious intent detected. The tool has appropriate safeguards including file size limits (500KB), automatic backups, and retry logic with rollback on failure.

10
スキャンされたファイル
964
解析された行数
5
検出結果
1
総監査数
低リスクの問題 (3)
Subprocess CLI Call
The tool calls the claude CLI via subprocess.run as a fallback when ANTHROPIC_API_KEY is not set. Arguments are hardcoded and user content is passed via stdin, not shell arguments. This is a standard pattern for Claude CLI integration. The risk is minimal but warrants documentation.
Environment Variable Access for API Key
The tool reads ANTHROPIC_API_KEY from environment variables to authenticate with the Anthropic API. This is standard and expected behavior for API tooling. The key is used only for direct API calls to Anthropic, not transmitted elsewhere.
File Write to User-Specified Path
The tool writes compressed content back to the same file path the user specifies. A backup is created before overwriting. The path is resolved to an absolute path and validated for existence and size (max 500KB). No files outside the user-specified path are modified.

リスク要因

⚙️ 外部コマンド (1)
🔑 環境変数 (1)
監査者: claude

品質スコア

59
アーキテクチャ
100
保守性
87
コンテンツ
50
コミュニティ
84
セキュリティ
83
仕様準拠

作れるもの

セッションごとのコストを削減

CLAUDE.md プロジェクトメモリファイルを一度圧縮するだけで、セッション開始ごとに小さいファイルが読み込まれ、AI作業のたびにトークンを節約できます。

チームドキュメントを最適化

共有設定ファイル、スタイルガイド、プロジェクト規約を圧縮。チームメンバーは同じ指示を、セッションあたりの入力トークンを減らして受け取れます。

長期プロジェクトノートを凝縮

蓄積されたTodoリスト、議事録、決定ログを重要な事実に圧縮。冗長なオーバーヘッドなしにすべての情報を保持。

これらのプロンプトを試す

単一ファイルを圧縮
CLAUDE.md のファイルをキャヴマン形式に圧縮してください。
複数の設定ファイルを圧縮
以下のメモリファイルを圧縮してください: CLAUDE.md, todos.md, preferences.txt。
編集後に再圧縮
CLAUDE.original.md に新しいコーディング標準を追加しました。CLAUDE.md を置き換えるためにもう一度圧縮してください。
カスタムモデルで圧縮
CAVEMAN_MODEL を claude-haiku に設定して CLAUDE.md を圧縮してください。

ベストプラクティス

  • .original.md バックアップファイルを編集してから再圧縮してください。これにより、人間可読なフォーマットを信頼できる情報源として維持できます。
  • メモリファイルの主要な更新後に圧縮を実行してください。新しい編集には圧縮効果の高い冗長な説明が含まれていることが多いです。
  • 圧縮出力を信頼する前に確認してください。検証は技術コンテンツをチェックしますが、スタイルの変更はニュアンスに影響を与える可能性があります。

回避

  • コードファイル、設定ファイル、または主にコードで構成されるファイルを圧縮しないでください。ツールはこれらを自動的にスキップします。
  • .original.md バックアップを削除しないでください。これは人間可読な情報源であり、リカバリポイントです。
  • 変更されていないファイルに対して圧縮を繰り返し実行しないでください。実行ごとにAPIトークンを消費します。意味のある編集後にのみ圧縮してください。

よくある質問

元のファイルはどうなりますか?
元のファイルは圧縮版で上書きされます。その前に、.original.md 拡張子のバックアップが保存されます。バックアップはいつでも確認・編集できます。
CLAUDE.md 以外のファイルも圧縮できますか?
はい。マークダウン(.md)、プレーンテキスト(.txt)、reStructuredText(.rst)ファイルはすべて対応可能です。自然言語を含む拡張子なしのファイルもサポートされています。コードファイルと設定ファイルは自動的にスキップされます。
圧縮で技術情報は失われませんか?
いいえ。コードブロック、URL、ファイルパス、コマンド、技術用語は完全に保持されます。圧縮後、見出し、コードブロック、URL、構造を検証ステップでチェックします。検証に失敗した場合、ツールはターゲット修正で再試行します。
圧縮が失敗したり、誤った出力が生成された場合はどうなりますか?
ツールはターゲット修正で最大2回再試行します。すべての再試行が失敗した場合、元のファイルは復元され、そのまま残ります。バックアップは圧縮が成功した場合のみ保持されます。
圧縮でどれくらいトークンを節約できますか?
平均して約46%の入力トークンが削減されます。個別のファイルでは、元のテキストの冗長性に応じて36%〜60%の削減が可能です。
このスキルを使用するにはAnthropic APIキーが必要ですか?
はい。環境変数に ANTHROPIC_API_KEY が設定されているか、デスクトップ認証が構成された claude CLI がインストールされているかのいずれかが必要です。スキルは利用可能な方を使用します。

開発者の詳細

作成者

juliusbrussee

ライセンス

MIT

参照

main

ファイル構成