---
title: "Skills:口調・事実・規約をBriksに | Briks"
url: https://briks.dev/ja/docs/skills
description: "文体、会社の基本情報、命名ルールなど、ワークスペースのすべてのプロジェクトで Briks が従うガイドを与えられます。スキルの追加、確認、オフもできます。"
last_updated: 2026-10-08
---

# Skills:口調・事実・規約をBriksに

スキルは、タスクに合うたびに、Briks がワークスペースのプロジェクトで従う短い指示のまとまりです。スキルは、ご自身にしか分からないこと、つまり話し方、すべてのページで正確に伝えるべき事実、名前の付け方に使います。このページでは、スタジオが用意している各方法でのスキルの追加、オフにする方法、すべてのスキルに行われる安全確認、そしてコピーして使える3つの例を紹介します。

読了時間 8 分 2026年10月8日にスタジオで確認済み

## スキルとは

**Skills** ページには、次のようにまとめられています。“Guidance the builder follows on your workspace's projects when a task fits it: your tone, your facts, your conventions. The studio's own design and code rules always come first.”

どこで

1. Skills

スキルはすべて3つの部分でできています。

| 部分 | 概要 | 上限 |
| --- | --- | --- |
| **Name** | ハイフンでつないだ小文字の単語です。例: `tone-of-voice` | 64文字 |
| **使うとき** | スキルが扱う内容を1〜3文で書いてください。Briksはこの1行でスキルを選ぶので、具体的に書いてください。 | 1,024文字 |
| **Instructions** | スキルを使うときにBriksが従うルールと例 | 20,000文字 |

スキルはワークスペースに属します。オンのスキルは、そのワークスペースのすべてのプロジェクトに適用され、他のワークスペースには適用されません。同時にオンにできるのは25個までです。一覧の上に、たとえば「3 of 4 on. The builder receives the ones that are on with every job in this workspace, and only here.」のように件数が表示されます。

## スキルが使われるときと、使われないとき

| 状況 | スキルは使われましたか? |
| --- | --- |
| ウェブサイト、アプリ、ダッシュボードの最初の制作や変更 | はい、**When to use it** の行がそのタスクに合っている場合です |
| スキルがオフになっています | いいえ |
| **Media** からの差し替え、元に戻す・復元、**Apply to the live site**、本番環境への公開 | いいえ、新しく書き込まれるものはありません |
| スタジオで尋ねる質問 | いいえ。質問への回答では制作は行われません |
| スタジオのデザインルールやコードルールと食い違うルール | その部分は脇に置かれています |
| シークレット、外部アドレス、またはサイト外のファイルを要求するルール | その部分は脇に置かれています |

スキルが加えるのは知識であり、デザインではありません。黒いフッターのように見た目を固定したいルールには、**Settings**、**Preferences** の **Rules in your own words** を使ってください。これは “Kept to, build after build.” という設定です。

新しいスキルや編集したスキルは、次のビルドまたは変更から反映されます。それまで公開済みサイトは変わりません。

## スキルを管理できる人

OwnerとAdminは、スキルの追加、編集、切り替え、更新、削除ができます。Adminの役割は「Manages members, settings, templates and skills, and moves projects.」と表示されます。EditorとViewerは **Skills** ページを開いて一覧を読めますが、スイッチはグレー表示で、**Add skill** ボタンはありません。[メンバーと権限](https://briks.dev/ja/docs/members-and-roles) をご覧ください。

## スキルを追加

**Add skill** をクリックします。**Add a skill** というボックスが開き、始め方が3つ表示されます。「Choose how to start. You read and can edit every skill before the builder receives it.」

| オプション | スタジオのメッセージ | 追加後 | 費用 |
| --- | --- | --- | --- |
| **自分で書く** | 名前を付け、使う場面を伝え、指示を書きます。 | オンにするまではオフで、**Written here** のタグが付きます | なし |
| **Draft with AI** | 何をさせたいかを説明すると、編集用の下書きが返ってきます。数クレジットを使います。 | オンにするまではオフです。**Drafted by AI** のタグが付きます | 5クレジットを確保し、作業分が課金されます |
| **Import from GitHub** | SKILL.md、フォルダ、リポジトリへのリンクを貼り付けます。読んだコミットに固定されます。 | 自分でオンにするまでオフ。コミットに **GitHub** のタグが付きます | なし |

自分で書く

1. ボックスを開く

   場所: Skills

   **Add skill** をクリックします。初めての場合は、**No skills yet** の中にあるボタンをクリックします。

2. Write your own を選択してください

   場所: Add a skill

   **Write a skill** というボックスが開き、3つの入力欄が表示されます。

3. 名前を付ける

   場所: Write a skill

   名前を入力してください。欄を離れると、Briksが小文字の単語とハイフンに整えます。「Tone of voice」は `tone-of-voice` になります。

4. 使うタイミングを伝える

   場所: Write a skill

   **When to use it** は、作業について書いた一文にします。例：「当社サイトすべての言葉に使う文体です。文章を書くとき、書き直すときは必ず使ってください。」

5. 指示を書く

   場所: Write a skill

   **Instructions** にルールと例を入力します。ボックスの下のカウンターで、20,000文字のうちどれだけ使ったかが分かります。

6. 保存する

   場所: Write a skill

   **Add skill** をクリックします。スタジオに「tone-of-voice added. It stays off until you turn it on.」と表示されます。

7. オンにする

   場所: Skills

   スキルの右側のスイッチを **On** にします。次のビルドまたは変更から、Briksがそのスキルを使います。

### AIで下書きする

**Draft a skill with AI** の **What the skill should do** に、Briks に知っておいてほしいことや、いつも行ってほしいことを20〜4,000文字で書きます。**Draft it** をクリックすると、スタジオに「Usually under a minute.」と表示されます。下書きは **Review the drafted skill** で開くので、読んで編集してください。**Add skill** の後は、「added. It stays off until you turn it on.」と表示されます。

### GitHubからインポート

**Import a skill from GitHub** に、公開リポジトリのSKILL.md、フォルダー、またはリポジトリ全体への **GitHub link** を貼り付けて、**Read it** をクリックしてください。リンク先に複数のスキルがある場合は、一覧から1つ選んで **Read this one** をクリックします。**Review the imported skill** には、コミットとともに全文が表示されます。「Read it all: the builder follows it as written.」インポートは1時間に30件まで読み込めます。

取り込んだスキルは、読み込んだコミットに固定されたままです。新しいものを取り込むには、スキルのメニューを開いて **Check for update** を選びます。最新の状態であると表示されるか、保存する前に確認できるよう新しいバージョンが開きます。

## 安全性の確認

スキルは、入力するときと保存するときに、毎回内容が確認されます。危険そうな点があると、**Read these before adding it** というパネルに見つかった内容が一覧で表示され、「I have read the instructions and they are safe to follow.」にチェックを入れるまで、**Add skill** は押せません。その後、スキルには一覧で **Read before use** のタグが付き、同じ注意書きが表示されます。確認する内容は次のとおりです。

- 「ビルダーに、先に設定したルールや指示を無視するよう求めている。」
- 「ビルダーの正体や、そのシステムの内容を変えようとしている。」
- 「キー、シークレット、認証情報に触れている。」
- 「他のアドレスへのリクエストを求めています。」
- 「別のアドレスのスクリプトをページに追加します。」
- 「テキストをコードとして実行したり、生のHTMLを設定したりするコードを求めています。」
- 挙げられたウェブアドレスの数です。

スキルにパスワードやキーを入れないでください

スキルは、Briksがビルドのたびに読み込むプレーンテキストです。キーやパスワードは [Secrets](https://briks.dev/ja/docs/secrets) に入れてください。サイトのファイルには残りません。

## オフにする、編集する、削除する

各スキルの右側にはスイッチがあり、メニューには **Edit**、インポートしたスキル用の **Check for update**、**Delete** があります。新しいスキルはすべてオフで始まるので、Briksが使う前にご自身で内容を読めます。オフにしても、スキルは後のために残ります。25個がオンのときは、他のスキルのスイッチはグレーアウトされ、どれかをオフにするまで操作できません。削除する前に確認が表示されます。「The builder stops receiving it from the next change on.」

## コピーして使える3つのスキル

文体のトーン tone-of-voice(リーズの家事法務を扱う法律事務所向け)

> 使う場面：Hollin & Hartのサイトにある、すべての言葉の文体です。見出し、本文、ボタン、フォームのラベル、メッセージが対象です。文章を書くとき、書き直すときは必ず使います。指示：事務所として、「私たち」「当事務所」を使って書いてください。心配しているお子さんの親御さんにも分かる平易な言葉を使い、法律用語は初めて出てくるときに説明してください。落ち着いた調子を保ち、「戦う」「闘う」「勝つ」は決して使わないでください。文は短くし、感嘆符は使わないでください。ボタンには次に起きることを書き、「送信」ではなく「無料20分の電話を予約する」のようにしてください。

新しいページや変更も、その口調で返ってきます。「調停についてのページを追加して」と頼めば、売り込む前にまず調停とは何かを説明する文章が返ってきます。

宿の基本情報 house-facts、シェフィールドの建具工房向け

> 使うタイミング: Oakline Joineryのどのページでも正確に伝えるべき事実です。対応エリア、製品、納期、価格、連絡先、営業時間が含まれます。ページがこれらのいずれかに触れるときに使ってください。指示: 当社の工房はSheffieldにあり、30マイル圏内で取り付けを行います。キッチンはすべて無垢のオークまたはウォールナットで、サイズに合わせて製作します。MDFには決して触れないでください。納期は最終図面から10〜12週間です。キッチンは取り付け込みで£18,000からで、ほかの価格は決して伝えないでください。電話 0114 496 0321。土曜日は休業です。

「FAQセクションを追加して」のような変更では、納期や価格に関する質問に、推測ではなくこれらの数値で答えます。

命名規則 product-naming、茶葉店向け

> 使う場面：Kettle & Leafが、ページ、カード、メニュー、ボタンで紅茶やハーブティーをどう呼ぶかを定めたものです。商品一覧、商品ページ、価格の表示すべてに使います。手順：正式名は、産地、茶園、等級、収穫期の順に表記します。例：Darjeeling, Castleton, FTGFOP1, second flush 2026。カードには産地と茶園だけを使います。価格は100 gあたりです。ルイボスとカモミールはハーブティーであり、紅茶とは呼びません。

新しいショップページでは、すべての商品が同じ形式で並び、100gあたりの価格が表示されます。ハーブティーは専用のグループにまとめられます。

## うまく動くスキルの書き方

- **When to use it** には、「メニューページや料理の一覧」のように、作業内容を書いてください。あいまいな書き方だと、Briksがそのスキルを使わないことがあります。
- ルールは、やるべきこととして書き、理由が分かりにくい場合は理由も添えましょう。
- 良い例と悪い例を挙げましょう。よい例が1つあれば、ルール5つより効くことがよくあります。
- 情報は常に最新に保ちましょう。価格や住所が変わったらスキルを編集し、変更を依頼して公開中のサイトに反映させます。
- スキルは1つにつき1つの主題にしましょう。トーンのスキルと事実のスキルは、両方を詰め込んだ長いスキルよりも、切り替えや更新が簡単です。

### 新しいスキルを追加すると、公開中のサイトはすぐに変わりますか？

いいえ。次回の作成や変更から適用されます。すでにあるページに反映するには、「Rewrite the About page in our house tone」のように変更を依頼してください。

### スキルは有料ですか？

書き込みとインポートは無料です。**Draft with AI** は5クレジットを確保し、実際に行った作業の分だけ請求されます。使用中のスキルはビルドの一部として読み込まれ、ビルドの分は通常どおり請求されます。

### プロジェクトごとにスキルを使わない設定はできますか?

スキルはワークスペース内のすべてのプロジェクトに適用されます。合わないプロジェクトの作業中はオフにするか、そのクライアントを専用のワークスペースに分けてください。

## 次に読む

- [ビルド中 **良い依頼文の書き方** 最初のビルドを成功させるために指示文へ書く内容:ビジネス、対象となる人、ページ、主なアクション、事実、トーン。ビフォーとアフターの例が6つあります。](https://briks.dev/ja/docs/writing-a-brief)
- [プロジェクトで作業する **変更を加える** Briksに書いてサイトを変更する方法です。伝え方、画像の追加、変更の内容と費用、内側のページ、順番待ちのリクエスト、うまくいかなかったときの直し方を説明します。](https://briks.dev/ja/docs/making-changes)
- [ワークスペースとアカウント **メンバーと役割** メールのリンクで人を招待し、Owner、Admin、Editor、Viewer の役割を付けられます。各役割でできることと、プランごとの人数も確認できます。](https://briks.dev/ja/docs/members-and-roles)
- [ワークスペースとアカウント **ワークスペース** ワークスペースには、プロジェクト、メンバー、メディア、スキル、プラン、クレジットがまとまっています。作成、切り替え、名前の変更、不要になったものの削除ができます。](https://briks.dev/ja/docs/workspaces)

まだ解決しませんか?

プロジェクト名と、表示されると思っていた内容を添えて [hello@briks.dev](mailto:hello@briks.dev) までご連絡ください。スクリーンショットがあると助かります。