skill-from-github

GitHub のスキル

ユーザーが何かを達成したい場合は、GitHub で質の高いプロジェクトを検索し、その内容を深く理解したうえで、その知識に基づいたスキルを作成します。

使用する場面

ユーザーがタスクを説明し、参考になる既存のツールやプロジェクトを探したい場合：

• 「Markdown を PDF に変換できるようにしたい」
• 「顧客レビューの感情分析を手伝ってほしい」
• 「コードから API ドキュメントを生成したい」

ワークフロー

ステップ 1：ユーザーの意図を把握する

ユーザーが何を達成したいのかを明確にします：

• 入力は何ですか？
• 期待する出力は何ですか？
• 制約（言語、フレームワークなど）はありますか？

ステップ 2：GitHub を検索する

この問題を解決するプロジェクトを検索します：

{task keywords} language:{preferred} stars:>100 sort:stars

検索のヒント：

• 広い範囲から始めて、徐々に絞り込みます
• キーワードの組み合わせを変えて試します
• 関連する場合は「cli」「tool」「library」を含めます

品質フィルター（すべて満たす必要があります）：

• スター数が 100 を超えている（コミュニティによる評価がある）
• 過去 12 か月以内に更新されている（積極的にメンテナンスされている）
• 明確なドキュメントを備えた README がある
• 実際のコードがある（awesome-list だけではない）

ステップ 3：選択肢をユーザーに提示する

上位 3〜5 件の候補を提示します：

## Found X projects that can help

### Option 1: [project-name](github-url)
- Stars: xxx | Last updated: xxx
- What it does: one-line description
- Why it's good: specific strength

### Option 2: ...

Which one should I dive into? Or should I search differently?

先に進む前に、ユーザーの確認を待ちます。

ステップ 4：選択されたプロジェクトを深く調査する

ユーザーがプロジェクトを選択したら、内容を徹底的に理解します：

1. README を読む - 目的、機能、使い方を理解します
2. 主要なソースファイルを読む - 仕組みを理解します
3. 例を確認する - 実際の使用パターンを確認します
4. 依存関係を確認する - 何に依存しているかを把握します
5. 重要な概念を特定する - 背景にあるメンタルモデルを把握します

次の内容を抽出します：

• 中核となるアルゴリズム／アプローチ
• 入出力形式
• エラー処理のパターン
• コードに反映されたベストプラクティス

ステップ 5：理解した内容を要約する

学んだ内容をユーザーに提示します：

## Understanding [project-name]

### Core Approach
How it solves the problem...

### Key Techniques
1. ...
2. ...

### Limitations
- ...

### What I'll encode in the skill
- ...

Does this look right? Should I proceed to create the skill?

ユーザーの確認を待ちます。

ステップ 6：skill-creator でスキルを作成する

次の内容を添えて skill-creator に引き継ぎます：

1. 明確な目的 - スキルでできること
2. 方法論 - プロジェクトから学んだアプローチ
3. 段階的な手順 - 具体的な指示
4. 品質基準 - 優れた出力の条件
5. よくある落とし穴 - 避けるべきこと（プロジェクトの課題やドキュメントから学んだ内容）

重要： スキルには、単にツールをラップするのではなく、プロジェクトから得た知識を組み込む必要があります。元のプロジェクトがインストールされていなくても、スキルを使用できるようにします。

例

ユーザー：「より良いコミットメッセージを書きたい」

ステップ 2 - 検索：

commit message convention stars:>100 sort:stars

ステップ 3 - 提示：

## Found 4 projects

### Option 1: conventional-commits/conventionalcommits.org (4.2k ⭐)
- Specification for human and machine readable commit messages
- Why: Industry standard, used by Angular, Vue, etc.

### Option 2: commitizen/cz-cli (15k ⭐)
- CLI tool for creating conventional commits
- Why: Battle-tested, lots of adapters

### Option 3: carloscuesta/gitmoji (14k ⭐)
- Emoji guide for commit messages
- Why: Visual, fun approach

Which one interests you?

ユーザー：「Conventional Commits にしましょう」

ステップ 4 - 深く調査：

• 仕様を読む
• タイプ（feat、fix、docs など）を理解する
• スコープや破壊的変更について学ぶ
• 実例を調べる

ステップ 5 - 要約：

## Understanding Conventional Commits

### Core Approach
Structured format: <type>(<scope>): <description>

### Key Types
- feat: new feature
- fix: bug fix
- docs: documentation
- ...

### Benefits Learned
- Automated changelog generation
- Semantic versioning
- Clear history

Ready to create a commit message skill based on this?

ステップ 6 - これらの原則を組み込んだスキルを作成する

重要な注意事項

1. 必ずユーザーの確認を得る - ステップ 3（プロジェクトの選択時）とステップ 5（作成前）
2. ラップするより学ぶことを優先する - 「このツールを実行する」だけでなく、知識を組み込みます
3. ライセンスを確認する - 制限のあるライセンスの場合は、その旨を伝えます
4. 情報源を明記する - 生成したスキルにクレジットを記載します
5. 速さより品質を重視する - プロジェクトを真に理解するために時間をかけます

このスキルが対象としないこと

• パッケージインストーラーではありません
• ツールのラッパーではありません
• 優れたプロジェクトから学び、その知識を再利用可能なスキルに組み込むことが目的です