SKILLOfficialdeployment

create-skill

プラグイン: valtown
ソース: GitHub で見る ↗

説明

次のような場合に使用: - ユーザーが設定、スキル、知識などを保存しておきたい場合 - 将来の開発で参考になるよう、何かを最適に作成する方法の記憶を保存すると役立つ場合

原文を表示

Use when the user wants to persist a preference, skill, or knowledge. Use when it would aid future val development to store a memory of how best to build something.

ユースケース

設定やスキルを保存したい
知識を保存しておきたい
最適な作成方法を記憶したい

本文（日本語訳）

Val Townのスキルは、Townie（タウンのAIアシスタント）やその他のAIエージェントに対して、Val Town MCPサーバーを通じて、ユーザーの好みと知識に合った自然なvalの書き方を教えるものです。

任意のval内では、ユーザーが /skills/<name>/SKILL.md というファイル（例：/skills/design/SKILL.md）を作成できます。TownieとVal Town MCPサーバーは、ユーザーの全てのval内で、このディレクトリ構造のスキルをインデックス化します。ユーザーは、すべてのスキルを1つのvalに集約することも、複数のval全体に分散させることもできます。

フロントマター

スキルのマークダウンファイルには、以下のフロントマター（メタ情報）が必須です：

name: スキルの名前（ケバブケース - 小文字、数字、ハイフンのみ）
description: エージェントがそのスキルを使うべき場面を判断するのに役立つ説明。スキルの説明が優れていることは、エージェントが見つけやすくするために極めて重要です
triggers: （オプション）エージェントに使用を促すキーワードのリスト

description と triggers フィールドは、スキル検出を実現します。つまり、ユーザーのAIエージェント（Claude CodeやCodexなど）にいつそのスキルを使うべきかを伝えます。より具体的であるほどよく、使用をトリガーするキーワード（triggersに列挙することもできます）を含める必要があります。フロントマターのないスキルは無視されるため、Townie/MCPはアクセスできません。

ベストプラクティス

Claude Platform Docsにはスキル作成のベストプラクティスが記載されており、以下が含まれます：

簡潔にする。コンテキストウィンドウ（処理できる情報量）は共有資源です
常に三人称で書く
デフォルト想定：AIエージェントは既に非常に優秀である
できる限り具体的にする（例：平文よりもコードが優れています）
使用状況やテストに基づいてスキルを改善する

例

---
name: design
description: valのUIをスタイリングするときに使用します。JSXまたはHTMLを返すフロントエンドのvalに使用してください
triggers: [css, styling, layout, theme]
---

- `.css`ファイルを使用し、インラインスタイルとTailwindは避ける
- Reactコンポーネントを `/components` ディレクトリに配置し、1ファイル1コンポーネント
- サンセリフの標準的なWebフォントスタックを使用し、外部フォントは使わない
- ...

リミックス

別のユーザーのスキルをリミックス（改変・再利用）して、SKILL.md ファイルをカスタマイズすることで、新しいスキルを作成できます。val.town UIにはリミックスボタンがあり、Val Town MCPサーバーには remix_val ツールがあります。

原文（English）を表示

Skills in Val Town instruct Townie and other AI agents using the Val Town MCP server how to write idiomatic vals that respect a user's preferences and knowledge.

In any val, a user can create a /skills/<name>/SKILL.md file, e.g. /skills/design/SKILL.md. Townie and the Val Town MCP server index skills with that directory/file structure across all of a user's vals. A user may choose to centralize their skills in one val or co-locate skills across multiple vals.

Frontmatter

A skill markdown file must have frontmatter:

name: kebab-case name of the skill; contains lowercase letters, numbers, and hyphens
description: helps the agent decide when the skill is relevant. A good skill description is critical for agent discovery
triggers: (optional) is a list of keywords to tip off the agent

The description and triggers fields enable skill discovery, i.e. tells the user's AI agent (e.g. Claude Code, Codex, Cursor) when to use it. The more specific the better, including key terms that should trigger use (which can also be enumerated in triggers). Skills without frontmatter will be silently skipped, so Townie/MCP will not be able to access them.

Best practices

The Claude Platform Docs offer skill authoring best practices, including:

Be concise. The context window is a public good
Always write in third person
Default assumption: AI agents are already very smart
Be as specific as possible (e.g. code is better than plain english where possible)
Improve skills based on usage and testing

Example

---
name: design
description: Use when styling a val's UI. Use for frontend vals that return JSX or HTML
triggers: [css, styling, layout, theme]
---

- Use `.css` files, avoid inline styles and Tailwind
- Locate React components in a `/components` directory, one component per file
- Use a sans-serif web-native font stack, no external fonts
- ...

Remixing

A new skill can be created by remixing another user’s skill and customizing the SKILL.md file. There is a remix button in the val.town UI, and a remix_val tool in the Val Town MCP server to do so.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。