Agent Skills 入門

Findy AI Meetup in Fukuoka #4

Transcript

1. Agent Skills ⼊⾨ 1 2026/02/18 Findy AI Meetup #4 ファインディ株式会社 フロントエンド テックリード 新福 宜侑 @puku0x
3. 3 ファインディでは⽣成AI関連の機能‧プロダクトが登場
4. 4 開発フローを改善
5. 5 （⽣成AIで良い感じに） 開発フローを改善
6. 6 これまでのファインディでの⽣成AIツール活⽤事例 GitHub Copilot と Claude Code についての記事を公開中 https://tech.findy.co.jp/entry/2025/07/23/070000 https://tech.findy.co.jp/entry/2024/12/25/070000 • カスタムインストラクションやスラッシュコマンドを整備 • スラッシュコマンドによる開発フロー⾃動化が便利
7. 7 各種エディタ‧ツールはAI関連のアップデートが多数
8. 8 Agent Skills とは？
9. 9 Agent Skills とは • 2025年10⽉に Anthropic が発表した機能 • 再利⽤可能な知識‧⼿順を SKILL.md に記載 知識 AIモデル ⼿順 SKILL.md 動的読み込み
10. 10 Agent Skills は何が違うのか？（１） • カスタムインストラクションは 常に 読み込まれる ※applyTo設定で対象を絞ることもできる（Rulesと似た挙動） • Agent Skills は必要な情報のみ 段階的に 読み込まれる AGENTS.md CLAUDE.md copilot-instructions.md ※ AIモデル xxx/SKILL.md yyy/SKILL.md AIモデル コンテキストの 肥⼤化を抑制
11. 11 Agent Skills は何が違うのか？（２） • カスタムスラッシュコマンドは主に ⼈間 が呼び出す • Agent Skills は AIエージェント や ⼈間 が呼び出す .claude/commands/*.md .github/prompts/*.prompt.md .claude/skills/**/SKILL.md .github/skills/**/SKILL.md
12. 12 Agent Skills は何が違うのか？（３） • オープンスタンダードとして標準化 https://agentskills.io/ ◦ さまざまなツールが対応中 ▪ Claude Code ▪ Cline ▪ Codex ▪ Cursor ▪ Gemini CLI ▪ GitHub Copilot : ツール間での 相互利⽤が可能
13. 13 VS Code / GitHub Copilot も Agent Skills をサポート • "chat.useAgentSkills": true で有効化 • 現在はプレビュー版 VS Code v1.109から正式リリース 🎉 ◦ https://code.visualstudio.com/docs/copilot/customization/agent-skills • 使うなら VS Code Insiders を推奨 ◦ Claude Codeとの互換性も改善されている
14. 14 Agent Skills を作ってみよう
15. 15 どうやって 作ればいいの？
16. 16 SKILL.md • マークダウンで書く ◦ nameとdescriptionは必須 https://agentskills.io/specification --- name: '<スキル名:小文字英数+ハイフン 64文字以内>' description: '<説明や利用タイミング、キーワード : 1024文字以内>' --- # 概要 例: このスキルは〜を行う。 ## いつ使うか 例: このスキルは〜の場合に用いる。
17. 17 ⽅法1: skill-creator を使う • Anthropic が公開している「Agent Skills を作るスキル」 ◦ https://github.com/anthropics/skills ◦ 共通規格なので GitHub Copilot からでも実⾏可能 スラッシュコマンドのように呼び出せる
18. 18 skill-creator での Agent Skills 作成例 ファインディのテックブログで紹介 https://tech.findy.co.jp/entry/2025/10/27/070000
19. 19 ⽅法3: make-skill-template を使う • https://github.com/github/awesome-copilot/blob/main/skills/make-skill-template ⽅法4: ⼿で書く • 細かく制御したい場合はこっち ◦ Anthropic が参考資料を 公開している https://claude.com/blog/complete-guide-to-building-skills-for-claude ⽅法2: agent-customization を使う • GitHub Copilot Chat の機能（実験的） ◦ "github.copilot.chat.agentCustomizationSkill.enabled": true
20. 20 何を Agent Skills にすればいいの？
21. 21 Agent Skills の候補 • 特定の知識や⼿順を含む操作 ◦ UIデザイン、設計、テスト、定型作業、特定ツール操作... • Anthropic での例 ◦ Category 1: Document & Asset Creation ◦ Category 2: Workflow Automation ◦ Category 3: MCP Enhancement 知識 AIモデル ⼿順 SKILL.md 動的読み込み
22. 22 ワークフローの ⾃動化
23. 23 ⾃動化といえば
24. 24 ⾃動化といえば スラッシュコマンド
25. 25 スラッシュコマンドの細分化 • スラッシュコマンド内の⼿順を Agent Skills に分離 ◦ 分離した箇所のみ実⾏など柔軟性が上がる .github/prompts/*.prompt.md *.instructions.md xxx/SKILL.md yyy/SKILL.md 再利⽤可能な細かい⼿順
26. 26 やってみよう
27. 27 例: PR作成⽤のスラッシュコマンド --- description: 'Create a pull request.' agent: 'agent' tools: ['read', 'execute', 'edit', ...] --- # プルリクエストの作成 変更の内容からプルリクエストを自動的に作成します。 : （以下、手順の列挙） Findy AI Meetup #2 より https://findy-inc.connpass.com/event/365777/
28. 28 スラッシュコマンド内の⼿順を Agent Skills として分離 --- description: 'Create a pull request.' agent: 'agent' tools: ['read', 'execute', 'edit', ...] --- # プルリクエストの作成 変更の内容からプルリクエストを自動的に作成します。 : ## 手順 ### ブランチの作成 ブランチ名のフォーマットは以下の... : ### コミットの作成 コミットメッセージはConventional Commitsに従って... : ### プルリクエストの作成 作業ブランチをpushします。... GitHub CLIのコマンドを使ってPRを... : 1. ブランチ作成スキル 2. コミット作成スキル 3. プルリクエスト作成スキル サンプルコード github.com/puku0x/agent-skills-test
29. 29 ブランチ作成スキル（１） --- name: git-branch description: Create Git branches with automatic type detection and project-specific naming conventions. Use when asked to "create a branch", "make a new branch", "create branch for changes", or when ready to organize code changes into a new branch. Supports feat, fix, docs, refactor, test, build, ci, chore, revert, and perf branch types with automatic type selection based on changed file patterns. — # Git Branch Skill This skill guides the creation of Git branches with project-specific naming conventions. ure that the branch name follows the project's naming conventions. スキルの概要と 発⽕条件を詳細に記述 nameはケバブケース
30. 30 ブランチ作成スキル（２） ## Workflow ### Step 1: Check staged changes Use the following command to view staged changes: ```bash git diff --staged ``` If there are no staged changes, check unstaged changes with: ```bash git diff ``` ステップバイステップ で操作を記述
31. 31 ブランチ作成スキル（３） ### Step 2: Determine branch type and description The format for branch names is: ``` <type>-<description> ``` - If there are only staged changes, base the branch name on the staged changes. - If there are only unstaged changes, base the branch name on the unstaged changes. - If there are both staged and unstaged changes, base the branch name on the staged changes. **type** is determined based on the patterns of the changed files: - `feat-`: New features or changes to existing features : 条件分岐は 箇条書き
32. 32 ブランチ作成スキル（４） ## Step 3: Create the branch Use `git switch -c` to create and switch to the new branch. Example: ```bash git switch -c feat-user-authentication ``` ## References - [branch-name.md](./references/branch-name.md) コマンドの 利⽤例を記述 出⼒例を参考 として提⽰
33. 33 コミット作成スキル --- name: git-commit description: Create Git commit messages following Conventional Commits format… --- # Git Commit Skill This skill guides the creation of Git commit messages that follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) format. ## When to Use Use this skill when: - Code changes are completed and ready to be committed - Need to create a commit message that adheres to project conventions
34. 34 プルリクエスト作成スキル --- name: gh-pr description: Create pull requests with proper title format… user-invocable: false --- # GitHub Pull Request Creation Skill This skill guides the creation of GitHub pull requests following project-specific conventions. ## When to Use Use this skill when: - Ready to create a pull request for review - Need to push branch to remote and open PR スラッシュコマンド としての呼び出しを無効化 https://github.com/microsoft/vscode/pull/295058 でClaude Codeと互換性問題は解消済み✅
35. 35 Agent Skills 分離後のプロンプト（抜粋） ### Step 1. デフォルトブランチの取得 `/gh-default-branch` スキルを利⽤して、リポジトリのデフォルトブランチ名を取得する。 （中略） 現在のブランチがデフォルトブランチと同じ場合は `/git-branch` スキルを利⽤して、... ### Step 5. 変更のコミット `/git-commit` スキルを利⽤して、変更をコミットする。 ### Step 6. プルリクエストの作成 `/gh-pr` スキルを利⽤して、プルリクエストを作成する。 スキルの名称を書くだけ ※カスタムインストラクションに スキルを列挙しておくと良い
36. 36 動作確認（１）
37. 37 動作確認（２） スキルを呼び出してコミットメッセージ作成
38. 38 動作確認（３）
39. 39 所感 • Agent Skills をうまく使いこなすのが今後のトレンドになりそう • スキルの発⽕条件 ◦ （体感的に）⽇本語よりも英語が良い かも ◦ [何をするか] + [いつ実⾏するか] + [キーワード] ▪ awesome-copilot の make-skill-template スキルはこの辺が上⼿ ◦ 動かないときの対処 ▪ descriptionの⾒直し ▪ プロンプト内で「◯◯のスキルを使⽤せよ」と指⽰ ▪ モデル変更（Sonnet 4.5 など）
40. 40 まとめ（１） • 基本はカスタムインストラクション + Agent Skills で良さそう ◦ カスタムインストラクション ▪ コーディング規約、ディレクトリ構成など ▪ リポジトリ全体に関わるもの ◦ Agent Skills ▪ プログラミング⾔語、フレームワーク、ツールの知識 テスト、レビュー、定型作業など ▪ 特定の知識‧操作に関わるもの • 今回のサンプル → https://github.com/puku0x/agent-skills-test
41. 41 まとめ（２） • Agent Skills を整備しよう ◦ カスタムインストラクション → Agent Skills に分離 ◦ スラッシュコマンド → Agent Skills に分離‧移⾏ ▪ Codexではスラッシュコマンドが⾮推奨化する流れも • 導⼊は skill-creator が便利 ◦ マーケットプレイスもあるが セキュリティ⾯には注意 • Anthropic の資料を読みましょう https://claude.com/blog/complete-guide-to-building-skills-for-claude
42. 42 ⽣成AI時代の新サービスも開発中！ https://ai-career.findy-code.io/
43. 43 ⽣成AIエンジニアになるための第⼀歩「磨くべきスキル」 ⽣成AI事業に抜擢されたエンジニアの評価されたスキル ⽣成AI推進企業5社に聞く！ ✅公式Xで公開中 @findy_ai_career
44. 44 ⽣成AIエンジニアになるための第⼀歩「磨くべきスキル」 ⽣成AI事業に抜擢されたエンジニアの評価されたスキル ⽣成AI推進企業5社に聞く！ ✅公式Xで公開中 @findy_ai_career
45. We’re hiring! https://careers.findy.co.jp/ 45