docs-cleaner
重複したドキュメントを統合しながら、有益なコンテンツをすべて保持します。ドキュメントの肥大化を整理したい、冗長なドキュメントをまとめたい、同一トピックをカバーする複数ファイルを統合したいといった場面で使用します。「ドキュメントを整理して」「ドキュメントをまとめて」「ドキュメントファイルが多すぎる」といった指示や、類似トピックを扱う複数ファイルの合計が500行を超える場合にトリガーされます。
description の原文を見る
Consolidates redundant documentation while preserving all valuable content. This skill should be used when users want to clean up documentation bloat, merge redundant docs, reduce documentation sprawl, or consolidate multiple files covering the same topic. Triggers include "clean up docs", "consolidate documentation", "too many doc files", "merge these docs", or when documentation exceeds 500 lines across multiple files covering similar topics.
SKILL.md 本文
ドキュメンテーション・クリーナー
冗長なドキュメンテーションを統合しながら、価値のあるコンテンツを100%保持します。
コア原則
削除前の批判的評価。 盲目的な削除は禁物です。削除を提案する前に、各セクションの独自の価値を分析してください。目標は情報損失なしの削減です。
ワークフロー
フェーズ 1: 発見
- トピックをカバーするすべてのドキュメントファイルを特定
- ファイル全体の行数をカウント
- ドキュメント間のコンテンツ重複をマッピング
フェーズ 2: 価値分析
各ドキュメントについて、セクション別の分析表を作成:
| セクション | 行数 | 価値 | 理由 |
|---|---|---|---|
| API リファレンス | 25 | 保持 | ユニークなエンドポイントドキュメント |
| セットアップステップ | 40 | 圧縮 | 冗長だが必須 |
| テスト結果 | 30 | 削除 | ワンタイム記録、リファレンスではない |
価値カテゴリ:
- 保持: ユニーク、必須、頻繁に参照される
- 圧縮: 価値があるが冗長
- 削除: 重複、ワンタイム、自明、時代遅れ
詳細な基準は references/value_analysis_template.md を参照してください。
フェーズ 3: 統合計画
ターゲット構造を提案:
Before: 726 lines (3 files, high redundancy)
After: ~100 lines (1 file + reference in CLAUDE.md)
Reduction: 86%
Value preserved: 100%
フェーズ 4: 実行
- すべての価値のあるコンテンツを含む統合ドキュメントを作成
- 冗長なソースファイルを削除
- 参照を更新 (CLAUDE.md、README、インポート)
- リンク切れがないことを確認
価値保持チェックリスト
最終化する前に、以下の保持を確認してください:
- 必須プロセス (セットアップ、設定)
- 主要な制約と落とし穴
- トラブルシューティングガイド
- 技術的債務 / ロードマップアイテム
- 外部リンクと参照
- デバッグのヒントとコードスニペット
アンチパターン
| パターン | 問題 | 解決策 |
|---|---|---|
| 盲目的な削除 | 価値のある情報を失う | 最初にセクション別分析を実施 |
| すべてを保持 | 削減が達成されない | 価値基準を厳密に適用 |
| 複数の真実の情報源 | 将来の相違 | 単一の公式な場所 |
| 孤立した参照 | リンク切れ | 統合後にすべての参照を更新 |
出力成果物
成功したクリーンアップは以下を生成します:
- 統合ドキュメント - 単一の真実の情報源
- 価値分析 - セクション別の正当性
- 前後のメトリクス - 削減行数、保持される価値
- 更新された参照 - 新しい場所へのポインタを含む CLAUDE.md または README
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- daymade
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/daymade/claude-code-skills / ライセンス: MIT
関連スキル
nature-response
Nature系ジャーナルの原稿修正に対する査読者への回答文について、下書き、チェック、または修正を行うことができます。査読者からのコメント、編集者の決定文、修正指示、回答案の作成、または大幅修正・軽微修正の対応方法に関するご相談があれば、対応いたします。査読報告書や回答文作成のサポートが必要な場合にご利用ください。
microsoft-docs
公式のMicrosoft文書を参照して、Azure、.NET、Agent Framework、Aspire、VS Code、GitHubなど様々な分野の概念、チュートリアル、コード例を検索します。デフォルトではMicrosoft Learn MCPを使用し、learn.microsoft.com外のコンテンツについてはContext7およびAspire MCPを使用します。
API Documentation Lookup
このスキルは、ユーザーが「Effect APIを調べる」「Effectドキュメントを確認する」「Effect関数のシグネチャを探す」「Effect.Xは何をするのか」「Effect.Xの使い方」「Effect APIリファレンス」「Effectドキュメントを取得する」といった質問をした場合や、公式のEffect-TS APIドキュメントから特定の関数シグネチャ、パラメータ、使用例を調べる必要がある場合に使用します。
knowledge-base
このスキルは、ヘルプセンターのアーキテクチャ設計、サポート記事の執筆、検索とセルフサービスの最適化が必要な場合に活用できます。ナレッジベース、ヘルプセンター、サポート記事、セルフサービス、記事テンプレート、検索最適化、コンテンツ分類、ヘルプドキュメントの設計・管理に関するあらゆるタスクで動作します。
markdown
GitHub Flavored Markdown標準に従ったMarkdownファイルのフォーマットと検証ができます。自動的なlinting処理と手動による意味的なレビューを組み合わせることで、ファイルの品質を確保します。
claude-md-enhancer
CLAUDE.mdファイルをプロジェクトタイプに合わせて分析・生成・改善します。ベストプラクティス、モジュール設計対応、技術スタックのカスタマイズに対応しています。新規プロジェクトの立ち上げ、既存のCLAUDE.mdファイルの改善、またはAI支援開発の標準化を図る際にご活用ください。