作成と公開

組み込みのスキルテンプレートを使用して、エージェントスキルをすばやく作成し、レジストリカタログに公開します。

スキル は、AI エージェント向けの再利用可能な指示セットまたはスラッシュコマンドで、バージョン管理されたアーティファクトとしてカタログに保存できます。スキルファイルをその都度共有する代わりに、開発者はバージョンタグを付けてスキルをレジストリに公開します。作成者がスキルを更新すると、新しいバージョンがカタログに公開されるため、利用者はメールや Slack でファイルが届くのを待つことなく、いつでも更新を取得できます。

始める前に

OIDC プロバイダーをセットアップして、ユーザーがレジストリで認証できるようにします。
Solo Enterprise for agentregistry をインストールし、arctl CLI をセットアップします。
まだ実行していない場合は、Solo Enterprise for agentregistry サーバーをポート 12121 でポートフォワードします。レジストリはデフォルトでは外部に公開されないため、ローカルマシンから到達するにはポートフォワードが必要です。
```
kubectl -n agentregistry-system port-forward svc/agentregistry-enterprise-server 12121:12121
```

スキルを作成する

myskill という Claude スキルのスキャフォールドを作成します。次のコマンドは、指定した入力パラメーターに基づいてあいさつ文を生成する hello-world.py スクリプトを含む myskill ディレクトリを作成します。
```
arctl init skill myskill
```

作成されたスキルのスキャフォールドを確認します。必要に応じてファイルを変更し、スキルをさらにカスタマイズできます。

ls myskill

出力例:

assets    LICENSE.txt   references  scripts     SKILL.md    skill.yaml

File	Description
`assets`	スキルが使用する画像、ファイル、その他のリソースなどの静的アセットを含むディレクトリです。
`LICENSE.txt`	スキルのライセンス情報を含むライセンスファイルです。
`references`	スキルに関連するリファレンスドキュメント、リンク、追加リソースを含むディレクトリです。
`scripts`	スキルのビルド、テスト、実行に使用するヘルパースクリプトを含むディレクトリです。
`SKILL.md`	スキルとその機能、メタデータを記述する YAML フロントマターを含む、スキル定義ファイルです。このファイルは、スキルを agentregistry に公開するために必須です。
`skill.yaml`	スキルリソースの Solo Enterprise for agentregistry 定義です。このファイルには、スキルのソースコードが保存されている Docker コンテナーイメージと GitHub リポジトリの場所に関する情報が含まれます。スキルを Solo Enterprise for agentregistry カタログに追加するには、スキルリソースが必要です。

skill.yaml スキルリソースを確認します。

cat myskill/skill.yaml

出力例:

apiVersion: ar.dev/v1alpha1
kind: Skill
metadata:
  name: myskill
spec:
  title: myskill
  description: myskill skill

スキルを公開する

スキルをレジストリカタログに公開します。
```
arctl apply -f myskill/skill.yaml
```

スキルが作成されたことを確認します。

arctl get skills

出力例:

NAME      TAG      DESCRIPTION
myskill   latest   myskill skill

任意: agentregistry UI を開き、Catalog > Skills ビューに移動します。スキルが表示されることを確認します。