SKILLKnowledge Workdeployment

create-skill

プラグイン: Val Town
ソース: 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エージェントに対して、Val Town MCPサーバーを通じて、ユーザーの好みや知識を尊重した「慣用的なval」の書き方を指示します。

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

フロントマター

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

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

descriptionとtriggersフィールドは、スキル検出（ユーザーのAIエージェント（Claude CodeやCursorなど）がいつそれを使うべきかを伝える機能）を実現します。より具体的であるほど効果的です。利用を促すべき重要な用語を含めてください（これらはtriggersに列挙することもできます）。フロントマターのないスキルは黙って無視され、TownieやMCPからアクセスできなくなります。

ベストプラクティス

Claude Platformドキュメントには、スキル作成のベストプラクティスが紹介されています:

簡潔に書く。コンテキストウィンドウ（言語モデルが一度に処理できる情報量）は貴重なリソース
常に三人称で記述する
前提条件：AIエージェントは既に十分に優秀
できるだけ具体的に（例：英文よりもコードの方が望ましい）
使用状況とテストに基づいてスキルを改善する

例

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

- `.css`ファイルを使用し、インラインスタイルやTailwindは避ける
- Reactコンポーネントは `/components` ディレクトリに配置し、1ファイルにつき1コンポーネント
- サンセリフのウェブ標準フォントスタックを使用、外部フォントは不使用
- ...

リミックス

別のユーザーのスキルをリミックス（複製・改変）して、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 による自動翻訳です。

フロントマター

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

name: スキルの名前（ケバブケース）。小文字、数字、ハイフンのみを含む

description: エージェントがそのスキルが必要な場面を判断するのに役立つ説明。優れたスキル説明は、エージェントがスキルを見つけるうえで極めて重要です

triggers: （オプション）スキルの利用を促すキーワードのリスト

ベストプラクティス

Claude Platformドキュメントには、スキル作成のベストプラクティスが紹介されています:

簡潔に書く。コンテキストウィンドウ（言語モデルが一度に処理できる情報量）は貴重なリソース

常に三人称で記述する

前提条件：AIエージェントは既に十分に優秀

できるだけ具体的に（例：英文よりもコードの方が望ましい）

使用状況とテストに基づいてスキルを改善する

例

--- name: design description: valのUIをスタイリングするときに使用。JSXまたはHTMLを返すフロントエンドvalに使用 triggers: [css, styling, layout, theme] --- - `.css`ファイルを使用し、インラインスタイルやTailwindは避ける - Reactコンポーネントは `/components` ディレクトリに配置し、1ファイルにつき1コンポーネント - サンセリフのウェブ標準フォントスタックを使用、外部フォントは不使用 - ...

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

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 - ...