← ドキュメントMarkdownログイン

エージェント用プレイブック

MCP を使うコーディングエージェント向けの簡潔な手順。

あなたは Skillkren に接続されています。再利用可能な AI スキルとその出力例のライブラリです。スキルはオープンな Agent Skills 形式に従います。SKILL.md(name と description の frontmatter 付き指示)と、任意の references/、scripts/、assets/ ファイルです。

ブランド名: 常に Skillkren。ドメイン: skillkren.tech。

最初の手順

  1. 必要なら get_docs を topic agent で呼ぶ(またはリソース https://skillkren.tech/docs/agent.md を読む)。
  2. 重複作成の前に list_skills でユーザーのスキルとチームのライブラリを確認する。他の人が共有したスキルを開くには、リンクの id で get_skill を使う。
  3. Free プランでは最大 25 スキル。上限では upsert_skill がエラーを返す。回避しないこと。
  4. 明確なタイトルで upsert_skill を使う。同タイトルの自分のスキルを更新するか、新規作成する。チームライブラリでは team を渡す。
  5. 新しいスキルを公開するときは、必ず少なくとも 1 つの 例 を付ける(add_example)。

スキルの使い方

  1. get_skill で読み込み、指示に従う。
  2. get_skill は同梱の files をパスで一覧する。指示が指しているとき、またはタスクに必要なときだけ get_skill_file で読む。
  3. スキルの例を、形式・トーン・品質の基準にする。

良いスキルの書き方

  • 説明: スキルが何をするか、そしていつ使うか。ユーザーが実際に言う言葉で。エージェントはこれだけで読み込むか判断する。
  • 指示(content): 生の Markdown。HTML ではない。手順、ルール、良い出力の姿。おおよそ 500 行以内。
  • 参照: 長い内容(スタイルガイド、API メモ、チェックリスト)は put_skill_file で references/ に移し、指示内でパスを名指しする。例: "For banned words, read references/banned-words.md"。テンプレートとデータは assets/、実行コードは scripts/。
  • ライセンス: ユーザーが選んだときだけ license を設定(例: MIT、Apache-2.0、CC-BY-4.0、Proprietary)。尋ねること。勝手に選ばない。
  • 要件: 特定のツールやアクセスが必要なときだけ compatibility を設定。

スキルフォルダのアップロード

ユーザーがローカルスキル(例: ~/.claude/skills/pdf-processing/)のアップロードを依頼したら:

  1. SKILL.md を読む。name(読みやすいタイトルに)、description、license を使う。frontmatter の後の本文が content。
  2. それらのフィールドで upsert_skill を呼ぶ。フォルダに LICENSE があれば、そのテキストを licenseText として渡す。
  3. references/、scripts/、assets/ 配下の各ファイルについて、同じ相対パスで put_skill_file を呼ぶ。例: references/forms.md。
  4. テキストファイルのみ、各 100 KB まで、スキルあたり 30 個、サブフォルダは 1 段まで。バイナリ(画像、PDF)はスキップし、スキップしたファイルをユーザーに伝える。
  5. 完了したらスキルのリンクを渡す。

逆方向では、ユーザーはスキルページから zip をダウンロードし、アプリの skills フォルダに展開できます。

公開範囲

新しいスキルは Private(所有者のみ)。Unlisted はリンクを持つ誰でも開ける。Public は所有者のプロフィール https://skillkren.tech/u/<username> にも掲載される。

公開範囲は変更できない。ユーザーが共有したい場合はスキルページへ案内し、タイトル横のスイッチを使うよう伝える。秘密情報入りのスキルの共有は勧めないこと。

認証の文脈

接続は 1 人のユーザーに属します。作成したものはそのユーザーの所有で、そのユーザーが変更できるものだけ変更できます。

引用する URL

  • アプリ: https://skillkren.tech/app
  • スキル: ツールが返す url を使う。https://skillkren.tech/u/<username>/skills/<id> の形式。
  • 例: スキル URL に /examples を付ける。参照: スキル URL に /references を付ける。
  • ドキュメント: https://skillkren.tech/docs
  • エージェント向けドキュメント(生): https://skillkren.tech/docs/agent.md

禁止事項

  • ユーザーが確認するまでスキルやファイルを削除しない。
  • 秘密情報をスキル、ファイル、例に貼り付けない。
  • クライアント側レンダリングに頼らない。Markdown ソースを保存する。