エージェント スキル: クロードのモジュラー スキルを作成する
Le エージェントのスキル これらは、拡張のための最も強力なメカニズムの 1 つを表します。 クロード・コードのスキル。それはについてです コンピテンスモジュール 彼らが追加すると 専門知識と事前定義されたワークフローをエージェントに提供し、エージェントの実行を可能にします。 単純なコード生成をはるかに超えた複雑なタスク。
シリーズ 13 回目のこの記事では、スキルのアーキテクチャについて説明します。 コミュニティからの実例を含む 10 の主要なカテゴリを作成し、その作成方法を学びます。 特定のワークフローに合わせてカスタマイズされたスキル。スキルがクロード・コードを変える 一般的なアシスタントから 専門の専門家チーム 利用可能 ターミナル内で。
何を学ぶか
- エージェント スキルのアーキテクチャと構造を理解する
- 利用可能なスキル カテゴリのトップ 10 を確認する
- コミュニティからスキルをインストールして構成する
- カスタマイズされたスキルを段階的に作成する
- スキルを日々の開発ワークフローに統合
- 効果的なスキルを設計するためのベスト プラクティスを適用する
- 複数のスキル間の依存関係と競合を管理する
- チーム向けに再利用可能なスキル ライブラリを構築する
シリーズ全体の概要
| # | アイテム | 集中 |
|---|---|---|
| 1 | テクニカルパートナーとしてのクロード | セットアップと最初のステップ |
| 2 | プロジェクトのコンテキストとセットアップ | CLAUDE.mdと設定 |
| 3 | コンセプトと要件 | MVP とユーザーペルソナ |
| 4 | バックエンドとフロントエンドのアーキテクチャ | Spring Boot と Angular |
| 5 | コードの構造 | 組織と規約 |
| 6 | 高度なエンジニアリングプロンプト | 高度なテクニック |
| 7 | テストと品質 | 戦略とテストの生成 |
| 8 | 専門的な文書 | README、API、ADR |
| 9 | デプロイとDevOps | Docker、CI/CD、モニタリング |
| 10 | 進化と維持 | リファクタリングとスケーラビリティ |
| 11 | 実際のプロジェクトの統合 | クロード・コードの運用中 |
| 12 | クロードコード CLI | コマンドと設定 |
| 13 | エージェントのスキル (ここにいます) | モジュール機能 |
| 14 | 専門のサブエージェント | 特定の役割を持つエージェント |
| 15 | フックと自動化 | イベント駆動型のワークフロー |
| 16 | ラルフ・ウィガム法 | テスト駆動開発 |
| 17 | BMAD法 | 構造化されたプロジェクト管理 |
| 18 | マルチエージェントオーケストレーション | エージェントパイプライン |
| 19 | 共同作業 | チームおよびペアプログラミングAI |
| 20 | セキュリティとベストプラクティス | 強化とコンプライアンス |
| 21 | 監視と可観測性 | メトリクスとデバッグ |
1. エージェント スキルのアーキテクチャ
エージェントスキルとは、 マークダウンファイル ディレクトリに置かれる
.claude/skills/ プロジェクトの。各ファイルには特定のスキルが記述されています
クロードは会話の文脈で必要なときにこれを呼び出すことができます。
サブエージェント (次の記事で説明します) とは異なり、スキルは
自律的な存在ですが、 知識の拡張 能力を豊かにする
プリンシパルエージェントの。
ディレクトリ構造
プロジェクトにおけるスキルの一般的な構造
.claude/
skills/
document-generator.md # Skill per generazione documenti
api-tester.md # Skill per testing API
database-migration.md # Skill per migrazioni DB
code-review-checklist.md # Skill per code review
performance-analyzer.md # Skill per analisi performance
security-audit.md # Skill per audit di sicurezza
csv-data-analyzer.md # Skill per analisi dati CSV
deployment-validator.md # Skill per validazione deploy
agents/ # Subagenti (articolo 14)
commands/ # Custom slash commands
settings.json # Configurazione progetto
settings.local.json # Configurazione localeスキルの構造
各スキル ファイルは、Claude が自動的に解釈する事前定義された構造に従います。 構造には、スキルの名前、その機能の説明、 取扱説明書と使用制限。
.claude/skills/template-skill.md - スキルの基本構造
# Nome della Skill
## Descrizione
Breve descrizione di cosa fa questa skill e quando viene attivata.
## capacità
- capacità 1: cosa sa fare
- capacità 2: cosa sa fare
- capacità N: cosa sa fare
## Istruzioni
Istruzioni dettagliate su come eseguire il task:
1. Passo 1
2. Passo 2
3. Passo N
## Vincoli
- Non fare X
- Preferire Y rispetto a Z
- Formato output atteso
## Esempi
### Esempio 1: [Titolo]
Input: ...
Output: ...
### Esempio 2: [Titolo]
Input: ...
Output: ...クロードのスキル選択方法
クロードは、ユーザーのプロンプトと会話のコンテキストを分析します。
どのスキルが関連しているかを判断します。選択は自動的に行われます
リクエストと説明の間の意味上の対応に基づく
利用可能なスキルの。スキルを明示的に呼び出す必要はありません。
自分の専門分野の範囲内でリクエストを行うだけです。
特定のスキルを呼び出すには、次のコマンドを使用できます。
/skill nome-skill.
スキルのライフサイクル
ライフサイクルのフェーズ
| 段階 | 説明 | アクション・クロード |
|---|---|---|
| 発見 | クロードスキャン .claude/skills/ 起動時 |
利用可能なすべてのスキルのメタデータをロードします |
| マッチング | ユーザープロンプトのセマンティック分析 | リクエストに関連するスキルを特定する |
| 読み込み中 | 選択したスキルのロードを完了します | 指示、制約、例を読む |
| 実行 | スキル指示の適用 | ガイドラインに従ってタスクを実行します |
| 検証 | 制約に対する結果のチェック | 出力が定義された基準を満たしていることを確認する |
2. 10 のスキルカテゴリー
コミュニティは、10 の主要なカテゴリに分類された何百ものスキルを開発してきました。 各カテゴリは特定の領域をカバーしており、すぐに使用できるスキルを提供します。 あなたのプロジェクトにすぐに採用できます。
カテゴリ 1: 文書化スキル
ドキュメント スキルにより、クロードはドキュメントを作成、編集、変換できます。 プロフェッショナルなフォーマットで。これらのスキルはクロードを発電機に変えます 配布可能な出力を生成する構造化コンテンツ。
ドキュメントに関する主なスキル
| スキル | 形式 | 容量 |
|---|---|---|
| docxジェネレーター | Microsoft Word (.docx) | スタイル、表、画像、自動インデックスを備えた Word 文書を生成 |
| PDFクリエーター | カスタム レイアウト、ヘッダー/フッター、透かしを使用してプロフェッショナルな PDF を作成 | |
| pptxビルダー | パワーポイント (.pptx) | マスター スライド、グラフ、アニメーションを使用したプレゼンテーションを生成します。 |
| xlsx アナライザー | エクセル(.xlsx) | 数式、ピボット テーブル、グラフを含むスプレッドシートを作成する |
| 公開JSプレゼンター | HTML (Reveal.js) | トランジションとライブコードを使用したインタラクティブな Web プレゼンテーションを生成する |
.claude/skills/docx-generator.md - ドキュメントスキルの例
# Document Generator (DOCX)
## Descrizione
Genera documenti Microsoft Word professionali a partire da contenuti
strutturati. Supporta stili personalizzati, tabelle, immagini inline,
intestazioni/pie' di pagina e indice automatico.
## capacità
- Creare documenti .docx da zero con template professionale
- Applicare stili di formattazione coerenti
- Inserire tabelle con dati strutturati
- Generare indice automatico dai titoli
- Inserire header e footer con numerazione pagine
- Supportare contenuto multilingue
## Istruzioni
1. Analizzare la struttura del contenuto richiesto
2. Creare lo script Node.js usando la libreria `docx`
3. Definire gli stili del documento (heading, body, table)
4. Costruire la struttura del documento sezione per sezione
5. Eseguire lo script per generare il file .docx
6. Verificare che il file sia stato creato correttamente
## Dipendenze
- npm: docx (per generazione .docx)
- npm: @types/docx (per TypeScript)
## Vincoli
- Usare sempre stili coerenti nel documento
- Includere numerazione pagine nel footer
- Formato data: DD/MM/YYYY per documenti italiani
- Dimensione massima consigliata: 50 pagineカテゴリ 2: 開発およびコード ツール
開発スキルにより、高度なパターンでクロードのコーディング能力が拡張され、 特定のフレームワークと構造化された作業方法論。これらのスキルは、 製品コードの一貫性と品質を維持するのに特に役立ちます。
開発のためのコアスキル
| スキル | テクノロジー | 容量 |
|---|---|---|
| ウェブアーティファクトビルダー | HTML/CSS/JS | インライン HTML、CSS、JavaScript を使用して自己完結型 Web コンポーネントを生成 |
| tdd-ワークフロー | 多言語対応 | テスト駆動開発の推進: 最初にテストを作成し、次にデプロイします。 |
| git-worktree | Git | 複数のブランチでの並行開発のための Git ワークツリーを管理します |
| aws-cdk-ビルダー | AWS CDK | クラウド インフラストラクチャのベスト プラクティスを使用して CDK スタックを生成する |
| API デザインファースト | オープンAPI | OpenAPI仕様に基づいてAPIを設計し、サーバーとクライアントを生成します。 |
| 角度コンポーネントの生成 | 角度のある | シグナル、テスト、ストーリーブックを含むスタンドアロンの Angular コンポーネントを生成 |
.claude/skills/tdd-workflow.md - テスト駆動開発のスキル
# TDD Workflow
## Descrizione
Guida lo sviluppo seguendo rigorosamente il ciclo Red-Green-Refactor
del Test-Driven Development. Ogni feature viene implementata partendo
dai test che descrivono il comportamento atteso.
## capacità
- Scrivere test che definiscono il comportamento desiderato (Red)
- Implementare il minimo codice per far passare i test (Green)
- Refactoring del codice mantenendo tutti i test verdi (Refactor)
- Gestire test unitari, di integrazione e e2e
- Applicare test doubles (mock, stub, spy) dove necessario
## Istruzioni
### Fase Red
1. Analizzare il requisito e scomporlo in comportamenti testabili
2. Scrivere un test che descrive il comportamento atteso
3. Eseguire il test e verificare che FALLISCA
4. Se il test passa gia: il test non testa nulla di nuovo
### Fase Green
5. Scrivere il MINIMO codice necessario per far passare il test
6. Non ottimizzare, non aggiungere feature extra
7. Eseguire tutti i test e verificare che PASSINO tutti
### Fase Refactor
8. Rifattorizzare il codice eliminando duplicazione
9. Migliorare naming e struttura
10. Eseguire tutti i test dopo ogni modifica
11. I test devono rimanere VERDI dopo il refactoring
## Vincoli
- MAI scrivere codice di produzione senza un test che lo richiede
- Un test alla volta, una feature alla volta
- I test devono essere indipendenti tra loro
- Naming dei test: should_[comportamento]_when_[condizione]カテゴリ 3: データと分析
データ分析スキルにより、クロードは探索可能なデータ アナリストに変わります。 データセット、複雑なクエリの生成、視覚化の生成、および識別 データの異常。
データと分析のコアスキル
| スキル | ドメイン | 容量 |
|---|---|---|
| 根本原因の追跡 | デバッグ | 因果関係図による複雑なバグの体系的な根本原因分析 |
| csvデータサマライザー | CSV データセット | 探索的分析、記述統計、相関および異常 |
| postgresql-クエリビルダー | PostgreSQL | インデックス、CTE、ウィンドウ関数、Explain Plan を使用して最適化されたクエリを生成します。 |
| ログアナライザー | アプリケーションログ | パターン認識とイベント タイムラインによるログの解析と分析 |
| メトリクスダッシュボード | 監視 | ビジネス要件から Grafana/Prometheus 構成を生成 |
.claude/skills/csv-data-summarizer.md
# CSV Data Summarizer
## Descrizione
Analizza file CSV per produrre report statistici completi con
visualizzazioni, correlazioni e identificazione di anomalie.
## capacità
- Caricare e parsare file CSV di qualsiasi dimensione
- Calcolare statistiche descrittive (media, mediana, moda, deviazione standard)
- Identificare valori mancanti, duplicati e outlier
- Generare correlazioni tra variabili numeriche
- Produrre visualizzazioni con grafici ASCII o script Python/matplotlib
- Creare report strutturati in formato Markdown
## Istruzioni
1. Leggere il file CSV e identificare le colonne
2. Classificare le colonne: numeriche, categoriche, date, testo
3. Per ogni colonna numerica:
- Calcolare min, max, media, mediana, std dev
- Identificare outlier (IQR method)
- Verificare distribuzione
4. Per ogni colonna categorica:
- Contare valori unici e frequenze
- Identificare valori dominanti
5. Calcolare matrice di correlazione per colonne numeriche
6. Identificare pattern temporali (se presenti date)
7. Generare report con tutte le scoperte
## Formato Output
```markdown
# Report Analisi: [nome_file]
## Panoramica Dataset
- Righe: N, Colonne: M
- Valori mancanti: X%
## Statistiche per Colonna
[tabella per ogni colonna]
## Correlazioni Significative
[matrice e insights]
## Anomalie Rilevate
[lista anomalie con spiegazione]
```カテゴリ 4: 科学と研究
科学的スキルは、バイオインフォマティクスなどの高度な分野の専門知識をもたらします。 材料のシミュレーションと研究データの分析。それらはのために設計されています 科学データを扱う研究者と技術チーム。
科学分野のスキル
| スキル | ドメイン | 容量 |
|---|---|---|
| バイオインフォマティクスパイプライン | バイオインフォマティクス | DNA/RNA配列解析、アラインメント、遺伝子アノテーション |
| ml-実験トラッカー | 機械学習 | メトリクス、ハイパーパラメータ、比較による ML 実験の追跡 |
| 材料シミュレーション | 材料科学 | 計算モデルによる材料特性のシミュレーション |
| 統計分析 | 統計 | 統計検定、回帰、分散分析および信頼区間 |
カテゴリ 5: 執筆と研究
執筆スキルとリサーチスキルは技術コンテンツの作成に役立ちます Web ソースからの情報の抽出から書き込みまで、高品質 引用と参考文献を含む完全な記事。
執筆とリサーチのスキル
| スキル | 関数 | 容量 |
|---|---|---|
| 記事抽出者 | コンテンツ抽出 | Web URL、PDF、ドキュメントからコンテンツを抽出して構造化する |
| コンテンツリサーチライター | 研究と執筆 | テーマを徹底的にリサーチし、オリジナルコンテンツを制作 |
| テクニカルブログライター | 技術ブログ | コード、図、明確な説明を含む技術記事を書く |
| 変更ログジェネレーター | リリースノート | 自動分類による Git コミットからの変更ログの生成 |
.claude/skills/changelog-generator.md
# Changelog Generator
## Descrizione
Genera changelog professionali a partire dalla storia dei commit Git.
Categorizza automaticamente le modifiche seguendo Conventional Commits.
## capacità
- Analizzare commit tra due tag/versioni
- Categorizzare: feat, fix, docs, refactor, perf, test, chore
- Generare formato Keep a Changelog
- Linkare commit e issue/PR correlati
- Rilevare breaking changes
- Supportare versionamento semantico (SemVer)
## Istruzioni
1. Identificare l'intervallo di commit (ultimo tag -> HEAD)
2. Parsare ogni messaggio di commit per tipo e scope
3. Raggruppare per categoria
4. Ordinare per importanza (breaking > feat > fix > others)
5. Generare il documento CHANGELOG.md
6. Suggerire la nuova versione SemVer
## Formato Output
```markdown
# Changelog
## [1.2.0] - 2026-02-14
### Breaking Changes
- **auth:** Rimossa compatibilità con token v1
### Features
- **user:** Aggiunto form di modifica profilo (#123)
- **notif:** Sistema notifiche push (#145)
### Bug Fixes
- **cart:** Corretto calcolo totale con sconti (#167)
### Performance
- **api:** Cache su endpoint /products (-40% latenza)
```カテゴリ 6: 学習と知識
学習スキルによりクロードは知識管理システムに変わります 構造化された方法で情報を整理し、接続し、提示することができ、 インクリメンタル。
学習と知識のためのスキル
| スキル | 関数 | 容量 |
|---|---|---|
| タペストリー | ナレッジグラフ | 双方向リンクとナビゲーションを使用して、相互接続されたドキュメントのネットワークを作成します。 |
| 次の船の学習 | 反復学習 | 出荷、学習、改善のサイクル: リリース、フィードバックの分析、改善 |
| コンセプトマッパー | コンセプトマップ | テキストや技術文書からコンセプト マップを生成 |
| 学習パスビルダー | トレーニングコース | リソースとマイルストーンを使用してパーソナライズされた学習パスを作成する |
カテゴリ 7: メディアとコンテンツ
マルチメディア スキルにより、クロードはビデオおよびオーディオ コンテンツを操作できるようになります およびデジタル出版フォーマットに対応し、テキストのみを超えてその機能を拡張します。
メディアとコンテンツのスキル
| スキル | 形式 | 容量 |
|---|---|---|
| youtube-トランスクリプト | YouTube | YouTube 動画からトランスクリプトを抽出し、概要と構造化されたメモを生成します |
| ビデオダウンローダー | ビデオ | サポートされているプラットフォームから品質を選択してビデオをダウンロード |
| epubコンバータ | EPUB | Markdown または HTML コンテンツを電子書籍リーダー用の EPUB 形式に変換します |
| ポッドキャストのメモ | オーディオ | タイムスタンプ付きのポッドキャストトランスクリプトから構造化されたメモを生成 |
| ダイアグラムジェネレーター | 人魚/植物UML | 自然言語記述から技術図を生成 |
.claude/skills/diagram-generator.md
# Diagram Generator
## Descrizione
Genera diagrammi tecnici in formato Mermaid o PlantUML
a partire da descrizioni in linguaggio naturale o analisi del codice.
## capacità
- Diagrammi di sequenza da flussi di codice
- Diagrammi di classe da modelli di dominio
- Diagrammi ER da schema database
- Diagrammi di stato da macchine a stati
- Diagrammi di flusso da logica di business
- Diagrammi di architettura C4
## Istruzioni
1. Analizzare la richiesta o il codice sorgente
2. Identificare il tipo di diagramma più appropriato
3. Estrarre entità, relazioni e flussi
4. Generare il codice Mermaid/PlantUML
5. Salvare in un file .md o .puml
6. Se possibile, generare un preview ASCII
## Formato Mermaid
```mermaid
sequenceDiagram
participant U as User
participant A as API
participant DB as Database
U->>A: POST /login
A->>DB: SELECT user
DB-->>A: User data
A-->>U: JWT Token
```
## Vincoli
- Preferire Mermaid per semplicità
- Usare PlantUML per diagrammi complessi
- Includere sempre legenda se il diagramma ha più di 5 entità
- Massimo 20 entità per diagramma (dividere se necessario)カテゴリー 8: 健康とライフサイエンス
ライフサイエンスのスキルは医療従事者や研究者を支援します 医療データの分析、臨床レポートや研究の読解 生物医学的な。これらのスキルは常に、代替品ではないことに注意して機能します。 専門的な医学的意見。
ライフサイエンスのスキル
| スキル | ドメイン | 容量 |
|---|---|---|
| クロード・アライ・ヘルス | 医療報告書 | 医療レポートを分析し、異常値を強調表示し、フォローアップを提案します |
| 臨床試験分析装置 | 臨床試験 | 構造化合成による臨床試験のプロトコルと結果の分析 |
| 医薬品相互作用チェッカー | 薬理学 | 公開データベースに基づいて薬物相互作用をチェックする |
重要な免責事項
ヘルスケアスキルはサポートツールであり、 彼らは置き換えません いずれにしても医療専門家のアドバイス。生成されるすべての分析 臨床上の決定を行う前に、資格のある担当者によって検証される必要があります。 クロードコードは認定医療機器ではありません。
カテゴリ 9: コラボレーションと PM
コラボレーションとプロジェクト管理のスキルがクロードをツールで補完します Linear、Jira、会議分析システムなどの作業管理システム。 これらにより、タスク、スプリント、レポートの管理を自動化できます。
コラボレーションとPMのスキル
| スキル | 楽器 | 容量 |
|---|---|---|
| 線形積分 | リニア | API を介して Linear 上で問題、サイクル、プロジェクトを作成および管理する |
| jira ワークフロー | ジラ | Jira でタスクを同期し、ステータスを更新し、スプリント レポートを生成します |
| 会議分析 | 会議メモ | 会議メモを分析し、アクションアイテムを抽出し、責任を割り当てます |
| スプリントプランナー | アジャイル | ベロシティ、キャパシティ、バックログの優先順位に基づいてスプリントを計画する |
| スタンドアップレポーター | 毎日のスタンドアップ | 過去 24 時間以内に完了したコミット、PR、タスクからスタンドアップ レポートを生成 |
.claude/skills/meeting-analytics.md
# Meeting Analytics
## Descrizione
Analizza note di riunione per estrarre decisioni, action item,
rischi e metriche di partecipazione. Genera report strutturati
e traccia il follow-up delle azioni nel tempo.
## capacità
- Parsare note di riunione in formato libero
- Estrarre decisioni prese e rationale
- Identificare action item con responsabile e deadline
- Rilevare rischi e impedimenti menzionati
- Calcolare metriche di partecipazione
- Generare email di follow-up con riassunto
- Tracciare azioni aperte tra riunioni successive
## Formato Output
```markdown
# Meeting Report - [Data]
## Partecipanti
[Lista con ruolo]
## Decisioni
1. [Decisione] - Motivazione: [perchè]
2. ...
## Action Items
| # | Azione | Responsabile | Deadline | Stato |
|---|--------|-------------|----------|-------|
| 1 | ... | @nome | GG/MM | Open |
## Rischi Identificati
- [Rischio] - Impatto: [alto/medio/basso]
## Prossima Riunione
- Data: [suggerita]
- Agenda: [punti proposti]
```カテゴリ 10: セキュリティと Web テスト
セキュリティ スキルにより、Claude は侵入テストのスキルを身につけます。 脆弱性評価とセキュリティ監査。これらのスキルは認められた基準に準拠しています OWASP などを利用して、コンプライアンス要件に準拠したレポートを作成します。
セキュリティとテストのスキル
| スキル | 標準 | 容量 |
|---|---|---|
| owasp チェックリスト | OWASP トップ 10 | Web アプリケーション上の OWASP トップ 10 脆弱性の体系的な検証 |
| フフフザー | ウェブファジング | エンドポイントとパラメーターの検出のために FFUF を使用してファジング セッションを構成および実行する |
| セキュア環境マネージャー | 機密管理 | 環境変数の安全な管理、シークレットのローテーション、ボールトの統合 |
| 依存関係監査者 | CVEデータベース | CVE の特定と修正の推奨事項を含む包括的な依存関係の監査 |
| APIセキュリティテスター | OWASP API のセキュリティ | REST API と GraphQL の特定のセキュリティ テスト |
.claude/skills/owasp-checklist.md
# OWASP Security Checklist
## Descrizione
Verifica sistematica della sicurezza dell'applicazione web
contro le OWASP Top 10 vulnerabilità. Produce un report
di audit con severity, evidenze e raccomandazioni.
## Checklist OWASP Top 10
1. A01 - Broken Access Control
2. A02 - Cryptographic Failures
3. A03 - Injection (SQL, NoSQL, OS, LDAP)
4. A04 - Insecure Design
5. A05 - Security Misconfiguration
6. A06 - Vulnerable and Outdated Components
7. A07 - Identification and Authentication Failures
8. A08 - Software and Data Integrity Failures
9. A09 - Security Logging and Monitoring Failures
10. A10 - Server-Side Request Forgery (SSRF)
## Istruzioni per Ogni Voce
1. Identificare i file e gli endpoint rilevanti
2. Analizzare il codice per pattern vulnerabili
3. Classificare la severity: Critical/High/Medium/Low/Info
4. Documentare l'evidenza con riferimento al codice
5. Proporre la remediation con codice di esempio
6. Stimare l'effort di correzione
## Formato Report
| # | Vulnerabilità | Severity | File | Stato |
|---|--------------|----------|------|-------|
| A01 | Access Control | ... | ... | ... |3. カスタム スキルを段階的に作成する
カスタム スキルの作成は、Claude コードをニーズに適応させる最良の方法です あなたのプロジェクトとあなたのチームに特有のものです。完全なプロセスを見てみましょう 設計からテストまで。
ステップ 1: ニーズを特定する
スキルを作成する前に、繰り返しのパターンを特定することが重要です 標準化できるワークフローに。最高のスキルはタスクから生まれる 頻繁に実行され、明確なルールがあり、出力が生成される 予測可能な。
優れたスキルの基準
- 繰り返し性: タスクは週に数回実行されます
- 明確なルール: 定義された予測可能なステップがある
- 構造化された出力: 結果の形式は一貫しています
- 定義されたドメイン: スキルは特定の区切られた領域をカバーします
- 付加価値: 自動化により時間を大幅に節約
ステップ 2: スキルを設計する
実践例: Angular Component Generator のスキル
# Angular Standalone Component Generator
## Descrizione
Genera componenti Angular standalone seguendo le convenzioni
del progetto. Crea il file component.ts, il template HTML,
il foglio di stile CSS e il file di test .spec.ts.
## capacità
- Generare componenti standalone con signal per state management
- Creare template con design system del progetto
- Generare stili seguendo le convenzioni CSS/SCSS del progetto
- Scrivere test unitari con TestBed e ComponentFixture
- Applicare OnPush change detection
- Integrare con il router se richiesto
## Convenzioni del Progetto
- File naming: kebab-case (user-profile.component.ts)
- Selector prefix: app- (app-user-profile)
- State management: Angular Signals (non RxJS per stato locale)
- Change detection: OnPush
- Stili: CSS scoped al componente
- Test: Jasmine + TestBed
## Template Componente
```typescript
import { Component, signal, input, output } from '@angular/core';
@Component({
standalone: true,
selector: 'app-[nome]',
templateUrl: './[nome].component.html',
styleUrls: ['./[nome].component.css'],
changeDetection: ChangeDetectionStrategy.OnPush,
imports: []
})
export class [Nome]Component {
// Input signals
// State signals
// Output events
// Methods
}
```
## Template Test
```typescript
describe('[Nome]Component', () => {
let component: [Nome]Component;
let fixture: ComponentFixture<[Nome]Component>;
beforeEach(async () => {
await TestBed.configureTestingModule({
imports: [[Nome]Component]
}).compileComponents();
fixture = TestBed.createComponent([Nome]Component);
component = fixture.componentInstance;
fixture.detectChanges();
});
it('should create', () => {
expect(component).toBeTruthy();
});
});
```
## Vincoli
- Usare SEMPRE standalone: true
- NON usare ngModule
- Preferire signal() a BehaviorSubject per stato locale
- Includere almeno 3 test nel file .spec.ts
- Documentare ogni input/output con commento JSDocステップ 3: スキルをテストする
スキル ファイルを作成した後、さまざまなプロンプトでテストすることが重要です クロードがそれを正しく呼び出し、一貫した結果を生成することを確認します。
さまざまなプロンプトによるスキルテスト
# Test 1: Richiesta diretta
> Crea un componente UserProfile con campo nome ed email
# Verifica:
# - Ha creato user-profile.component.ts con standalone: true?
# - Ha usato signal() per lo stato?
# - Ha generato il file .spec.ts con almeno 3 test?
# Test 2: Richiesta con routing
> Genera un componente Dashboard che sia una route lazy-loaded
# Verifica:
# - Ha configurato il routing correttamente?
# - Ha applicato OnPush change detection?
# Test 3: Richiesta complessa
> Crea un componente ProductList con paginazione, filtri e ordinamento
# Verifica:
# - Ha gestito lo stato con signal?
# - Ha separato la logica in metodi chiari?
# - I test coprono i casi edge?ステップ 4: 反復して改善する
最高のスキルは時間の経過とともに進化するものです。最初のテストの後、 不足している制約を追加したり、あいまいな指示を明確にしたりする必要があるのが一般的です 特定のケースの例を追加します。
改善チェックリスト
- スキル名はその機能を明確に表していますか?
- 指示は十分に詳細に記載されていますか?
- 制約は遭遇するすべてのエッジケースをカバーしていますか?
- 例は最も一般的な使用例を表していますか?
- 出力形式は一貫していて有用ですか?
- スキルはエラーを正しく処理しますか?
- ドキュメントは新しいチームメンバーにとってわかりやすいものですか?
4. ワークフローへのスキルの統合
スキルは統合されたときに最大限の可能性を発揮します チームの日々の開発ワークフローに有機的に組み込まれます。パターンは次のとおりです より効果的な統合。
パターン1：スキルチェーン
複数のスキルを順番に組み合わせて複雑なタスクを実行します。たとえば、新しいものの場合、
使用できる機能: api-design-first API を定義してから、
tdd-workflow テストのために、それでは angular-component-gen
フロントエンド用。
完全な機能のスキル チェーンの例
# Passo 1: Progettazione API
> Progetta l'API per il modulo notifiche push
> Endpoint: GET /notifications, POST /notifications/subscribe,
> DELETE /notifications/{id}
# La skill api-design-first genera la specifica OpenAPI
# Passo 2: Test first
> Genera i test per il NotificationService seguendo TDD
> Basa i test sulla specifica API appena generata
# La skill tdd-workflow genera i test (fase Red)
# Passo 3: Implementazione
> Implementa il NotificationService per far passare i test
# La skill tdd-workflow guida l'implementazione (fase Green)
# Passo 4: Frontend
> Crea il componente NotificationPanel per visualizzare le notifiche
# La skill angular-component-gen crea il componente
# Passo 5: Documentazione
> Genera la documentazione per il modulo notifiche
# La skill changelog-generator o docx-generator documenta tuttoパターン2：スキルゲート（クオリティゲートとしてのスキル）
重要な操作の前に、品質チェックポイントとしてスキルを使用します。たとえば、
実行する owasp-checklist main にマージする前に、o
dependency-auditor 各リリースの前に。
パターン3：スキルライブラリ（チームスキルライブラリ）
プロジェクト リポジトリでスキルを共有すると、すべてのメンバーが許可されます。
チームの利益を得ることができます。ディレクトリ .claude/skills/ コミットした
リポジトリ内では 1 つになります 共有スキルライブラリ チームの。
エンタープライズチームの組織スキル
.claude/
skills/
# Skill di sviluppo
dev/
angular-component-gen.md
spring-service-gen.md
api-design-first.md
tdd-workflow.md
# Skill di qualità
quality/
code-review-checklist.md
owasp-checklist.md
dependency-auditor.md
performance-analyzer.md
# Skill di documentazione
docs/
docx-generator.md
changelog-generator.md
adr-writer.md
# Skill di analisi
analysis/
csv-data-summarizer.md
log-analyzer.md
root-cause-tracing.md
# Skill di project management
pm/
meeting-analytics.md
sprint-planner.md
standup-reporter.md5. スキル設計のベストプラクティス
数十のスキルを使用した後、何が機能するかについて明確なパターンが現れます 効果的なスキル。コミュニティによって統合されたベスト プラクティスを次に示します。
スキルのベストプラクティス
| 原理 | 説明 | Esempio |
|---|---|---|
| 単一の責任 | 各スキルは 1 つのことだけを行い、それをうまく実行します | 「テストの生成」と「テストの実行」を分離する |
| 明示的な指示 | 明確で曖昧さのない指示 | 「テストフレームワークを使用する」ではなく「テストに Jasmine を使用する」 |
| 具体例 | 入力と予想される出力を含む少なくとも 2 ～ 3 個の例 | 疑似コードではなく、完全なコード テンプレート |
| 制約をクリアする | してはいけないことに関する明示的な制約 | 「ngModule は使用しないでください。スタンドアロンのみを使用してください: true」 |
| 出力フォーマット | 定義された一貫した出力形式 | テンプレートのマークダウン、ファイル構造、命名 |
| エラー処理 | エッジケースとエラーの管理 | 「ファイルがすでに存在する場合は、上書きする前に確認を求めます」 |
| 依存関係の宣言 | 外部依存関係を宣言する | 「必要なもの: npm docx、@types/docx」 |
| バージョン管理 | スキルのバージョンをファイルに含める | 「バージョン: 1.2.0 - 最終更新日: 2026-02-14」 |
避けるべきアンチパターン
スキル作成におけるよくある間違い
- 汎用的すぎるスキル: 「コードの生成」は曖昧すぎます - 言語、フレームワーク、規則を指定してください
- 曖昧な指示: 「良いコードを書く」だけでは何も語られない - 具体的な品質指標を定義する
- 例が不足しています: 具体的な例がなければ、クロードは指示を予測不能に解釈します
- 矛盾する制約: 「TypeScript strict を使用する」と「型アノテーションを使用しない」は矛盾します
- モノリシックスキル: すべてを行う (生成、テスト、文書化、デプロイ) が管理不可能なスキル
- 出力形式がありません: フォーマットが定義されていないと、実行ごとに異なる結果が生成されます。
- 依存関係を無視します。 スキルにnpmパッケージが必要な場合は、明示的に指定してください
6. 高度なスキル管理
スキル構成
スキルを組み合わせて複雑なワークフローを作成できます。 その秘密は、互換性のある入力と出力を備えた各スキルを設計することです。 これにより、ある出力が次の入力にフィードされるようになります。
.claude/skills/full-feature-pipeline.md - 複合スキル
# Full Feature Pipeline
## Descrizione
Orchestrazione completa per la creazione di una nuova feature,
dalla specifica API al deploy. Combina le skill: api-design-first,
tdd-workflow, angular-component-gen, e changelog-generator.
## Pipeline
### Fase 1: Design (api-design-first)
- Input: Requisiti della feature in linguaggio naturale
- Output: Specifica OpenAPI completa
- Gate: Approvazione della specifica da parte dell'utente
### Fase 2: Backend (tdd-workflow)
- Input: Specifica OpenAPI dalla Fase 1
- Output: Service + Controller + Test con copertura 80%+
- Gate: Tutti i test passano
### Fase 3: Frontend (angular-component-gen)
- Input: API endpoints dalla Fase 1 + modelli dati
- Output: Componenti Angular standalone con test
- Gate: Build senza errori + test passano
### Fase 4: Documentazione (changelog-generator)
- Input: Tutti i file creati/modificati nelle fasi precedenti
- Output: Entry changelog + aggiornamento README
- Gate: Review della documentazione
## Vincoli
- Ogni fase richiede approvazione prima di procedere
- Se una fase fallisce, tornare alla fase precedente
- Mantenere git commit separati per ogni faseスキルのバージョン管理
スキルはプロジェクトとともに進化します。ヘッダーを含めることをお勧めします 各スキルのバージョンを確認し、変更の変更ログを保持します。
スキルのバージョン管理ヘッダー
# Angular Component Generator
> Versione: 2.1.0 | Ultimo aggiornamento: 2026-02-14
> Changelog:
> - 2.1.0: Aggiunto supporto per lazy-loaded routes
> - 2.0.0: Migrazione da ngModule a standalone
> - 1.3.0: Aggiunto template per form reattivi
> - 1.2.0: Aggiunto OnPush change detection
> - 1.1.0: Aggiunto supporto signal()
> - 1.0.0: Rilascio iniziale
## Descrizione
...自動スキルテスト
スキルが長期間にわたって正しく機能し続けることを保証するには、 出力を検証する自動テスト スクリプトを作成できます。 事前に定義された期待に反するスキルの向上。
scripts/test-skills.sh - 自動スキルテスト
#!/bin/bash
# Test automatico delle skill di Claude Code
echo "=== Testing Agent Skills ==="
# Test 1: Angular Component Generator
echo "Testing: Angular Component Generator..."
OUTPUT=$(claude --print "Crea un componente TestWidget con un input 'title' di tipo string" \
--output-format json --max-iterations 5 2>&1)
if echo "$OUTPUT" | grep -q "standalone: true"; then
echo " PASS: standalone component generated"
else
echo " FAIL: standalone not found in output"
fi
if echo "$OUTPUT" | grep -q "signal\|input()"; then
echo " PASS: signal/input used"
else
echo " FAIL: signal/input not found"
fi
# Test 2: TDD Workflow
echo "Testing: TDD Workflow..."
OUTPUT=$(claude --print "Scrivi i test per una funzione calculateDiscount(price, percentage)" \
--output-format json --max-iterations 5 2>&1)
if echo "$OUTPUT" | grep -q "describe\|it("; then
echo " PASS: test structure generated"
else
echo " FAIL: test structure not found"
fi
echo "=== Test Complete ==="結論
エージェント スキルにより、クロード コードは一般アシスタントからアシスタントに変わります。 専門スキルのエコシステム プロジェクトに合ったもの そしてチームへ。 10 のスキル カテゴリ - ドキュメント作成から セキュリティからデータ分析からプロジェクト管理まで、すべてをカバーします。 ソフトウェア開発ニーズの範囲。
重要なポイント
- スキルは次の Markdown ファイルです。
.claude/skills/: 作成、バージョン管理、チーム間での共有が簡単 - 10 のカテゴリであらゆるニーズをカバーします。 ドキュメント、開発、データ、研究、執筆、学習、メディア、健康、PM、セキュリティ
- 単一の責任で設計: 各スキルは 1 つのことだけを行い、それをうまく実行します
- 具体的な例は基本的なものです。 クロードは、テンプレートと期待される出力を使用してスキルをより適切に解釈します
- 複雑なワークフローのための構成: スキルチェーン、スキルゲート、フル機能パイプライン
- 継続的な反復: 最高のスキルはプロジェクトとチームのフィードバックによって進化します
- リポジトリ内での共有: コミットされたスキルはチームの知識のライブラリーとなります
Nel 次の記事 を探索してみます 専門のサブエージェント: 内部で独立して動作する特定の役割を持つ自律エージェント クロード・コード著。言語の専門家、DevOps のスペシャリストを作成する方法を見ていきます。 そしてセキュリティ監査人は主任エージェントと協力して作業します。