mcpField
M
my-first-skill

my-first-skill

github.com/numman-aliエージェントワークフロー10.8k52 回インストール40 週間前に更新
リポジトリ

my-first-skill について

AI コーディングエージェント向けのサンプルスキルです。Anthropic SKILL.md 形式と段階的な情報開示を示し、手順や関連リソースの構成方法を説明します。

主な機能

  1. 01SKILL.md の構成ガイド
  2. 02YAML frontmatter の例
  3. 03段階的な情報開示
  4. 04関連リソースの整理方法

活用シーン

  1. 01スキルの構成方法の学習
  2. 02OpenSkills ローダーのテスト
  3. 03詳細な手順とリソースの整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/numman-ali/openskills --skill my-first-skill

インストール後、Claude Code で/my-first-skillを入力して読み込まれたか確認します。

同梱ファイルreferences/skill-format.md

詳細

最初のスキル

これは、Anthropic の SKILL.md 形式を紹介するスキルの例です。

目的

このスキルでは、段階的な情報開示を用いて、AI コーディングエージェント向けの手順ガイダンスを構成する方法を説明します。

使用するタイミング

以下の場合に、このスキルを読み込みます。

  • スキルの仕組みを学ぶ場合
  • OpenSkills ローダーをテストする場合
  • SKILL.md 形式を理解する場合

手順

スキルを作成するには、次の手順に従います。

  1. ディレクトリを作成します：mkdir my-skill/
  2. YAML フロントマターを含む SKILL.md を追加します。 
    ---
name: my-skill
description: When to use this skill
---
  3. 命令形で手順を記述します（二人称は使いません）。
  4. 必要に応じて、同梱リソースを参照します。

同梱リソース

SKILL.md の仕様について詳しくは、次を参照してください。

references/skill-format.md

ベストプラクティス

  • 命令形／不定詞形で記述します：「X を行うには、Y を実行する」
  • 二人称は使いません：「〜してください」などの表現は避けます
  • SKILL.md は 5,000 語未満にします
  • 詳細な内容は references/ に移動します
  • 実行可能なコードには scripts/ を使用します
  • テンプレートと出力ファイルには assets/ を使用します

リソースの解決

このスキルが読み込まれると、ベースディレクトリが提供されます。

Base directory: /path/to/my-first-skill

相対パスはベースディレクトリを基準に解決されます。

  • references/skill-format.md → /path/to/my-first-skill/references/skill-format.md
  • scripts/helper.sh → /path/to/my-first-skill/scripts/helper.sh

コメント

Markdown 対応