メインコンテンツへスキップ
スキルは、Droidができることを拡張する再利用可能な機能です。指示が書かれたSKILL.mdファイルを作成すると、Droidがそれをツールキットに追加します。Droidは関連する場合にスキルを使用するか、/skill-nameで直接呼び出すことができます。
Explore the skills guides for examples.
Custom slash commands have been merged into skills. A file at .factory/commands/review.md and a skill at .factory/skills/review/SKILL.md both create /review and work the same way. Your existing .factory/commands/ files keep working. Skills add optional features: a directory for supporting files, frontmatter to control who can invoke them, and the ability for Droids to load them automatically when relevant.
主な特徴:
  • 柔軟な呼び出し – あなたとDroid の両方がスキルを呼び出せます。/skill-nameと入力するか、Droidに使用するタイミングを決めさせることができます。
  • 組み合わせ可能 – より大きなワークフローの一部として連鎖させることができます
  • トークン効率 – 軽量で焦点を絞っており、未使用のツールや繰り返しの指示で肥大化していません
スキルの例:
  • ワークフロー – 段階的な指示（例：「URLに移動し、スクリーンショットを取り、データを抽出する」）
  • 専門知識 – ドメインの知識と慣例（例：「デザインシステムでフロントエンド機能を実装する方法」）
  • 両方 – 指示 + ツール + ベストプラクティスをまとめたもの
スキルの例:
  • browser – CDPツールでChromeを自動化（ナビゲート、スクリーンショット、JS評価）
  • linear – CLIツールでLinearの課題を管理（リスト、ステータス更新、チーム移動）
  • frontend-ui-integration – チームの慣例に従った型付きReactフローの実装

​
スキルとは何か？

スキルは以下を含むディレクトリ（例：.factory/skills/frontend-ui-integration/）です：
  • YAMLフロントマターとmarkdown指示を含むSKILL.mdまたはskill.mdx
  • オプションのサポートファイル（スクリプト、スキーマ、チェックリスト）
各スキルは、解決する問題、期待する入力、成功の姿を定義します。Droidは現在のタスクに適用される場合、適合するスキルを自動的に呼び出します。

​
スキルファイル形式

スキルはYAMLフロントマターを持つMarkdownで定義されます。小さく焦点を絞ったスキルは、短いSKILL.mdだけで済みます： 
---
name: summarize-diff
description: Summarize the staged git diff in 3–5 bullets. Use when the user asks for a summary of pending changes.
---

# Summarize Diff

## Instructions

1. Run `git diff --staged`.
2. Summarize the changes in 3–5 bullets, focusing on user-visible behavior.
3. Call out any migrations, risky areas, or tests that should be run.
動作を制御するために、追加のフロントマターフィールドを含めることもできます。利用可能なすべてのオプションについてはFrontmatter referenceを参照してください。

​
スキルの保存場所

スキルは、少数の既知の場所から発見されます：
スコープ場所目的
ワークスペース<repo>/.factory/skills/チームメートと共有するプロジェクトスキル；gitにチェックイン。
個人~/.factory/skills/マシン上でプロジェクト間を移動する個人的なスキル。
互換性<repo>/.agent/skills/.agentフォルダ慣例との互換性のために発見。
各スキルは、これらのルートの下の独自のディレクトリに配置されます：
  • ワークスペース：<repo>/.factory/skills/<skill-name>/SKILL.md
  • 個人：~/.factory/skills/<skill-name>/SKILL.md
大きなmonorepoでは、以下のどちらかを選択できます：
  • ルートに単一の共有スキルフォルダを保持： 
    .factory/skills/
  frontend/
    SKILL.md
  payments-service/
    SKILL.md
  data-warehouse-querying/
    SKILL.md
  • またはプロジェクト毎の.factoryフォルダを追加し、スキルを各サブプロジェクトと一緒に配置： 
    services/payments/.factory/skills/
  payments-service/
    SKILL.md
apps/frontend/.factory/skills/
  dashboard-ui/
    SKILL.md
プロジェクトスキルは、エンジニアリング組織内で機能を共有し標準化する主要な方法です；個人スキルは個人のワークフローや実験に理想的です。

​
フロントマターリファレンス

スキルはSKILL.mdファイルの上部で---マーカー間のYAMLフロントマターフィールドをサポートします： 
---
name: my-skill
description: What this skill does and when to use it
user-invocable: true
disable-model-invocation: false
---

Your skill instructions here...
フィールド必須デフォルト説明
nameいいえディレクトリ名スキルの表示名。小文字、数字、ハイフンのみ。
description推奨—スキルの機能と使用タイミング。Droidがスキルを適用するタイミングを決めるために使用。
user-invocableいいえtruefalseに設定すると/スラッシュコマンドメニューから隠します。ユーザーが直接呼び出すべきでないバックグラウンド知識に使用。
disable-model-invocationいいえfalsetrueに設定するとDroidがこのスキルを自動読み込みしません。/skill-nameで手動でトリガーしたいワークフローに使用。

​
スキルを呼び出せる人の制御

デフォルトでは、あなたとDroidの両方が任意のスキルを呼び出せます。/skill-nameと入力して直接呼び出すことができ、Droidは会話に関連する場合に自動的に読み込めます。2つのフロントマターフィールドでこれを制限できます：
  • disable-model-invocation: true: あなただけがスキルを呼び出せます。/deployや/send-notificationのような副作用があるワークフローや、タイミングを制御したいワークフローに使用します。コードが準備できて見えるからといって、Droidがデプロイを決定することは望ましくありません。
  • user-invocable: false: Droidだけがスキルを呼び出せます。コマンドとして実行可能でないバックグラウンド知識に使用します。legacy-system-contextスキルは古いシステムの動作を説明します。Droidは関連する場合にこれを知っているべきですが、/legacy-system-contextはユーザーが取る意味のあるアクションではありません。

​
呼び出しサマリー

フロントマターユーザーが/invoke可能Droidが呼び出し可能
（デフォルト）はいはい
disable-model-invocation: trueはいいいえ
user-invocable: falseいいえはい

​
クイックスタート

1

Create a skill folder

Under your repo, create a directory in .factory/skills/, for example .factory/skills/frontend-ui-integration/.
2

Add SKILL.md or skill.mdx

Inside the folder, create SKILL.md or skill.mdx with YAML frontmatter (name, description) and markdown instructions that define the capability, inputs, and success criteria.
3

Add supporting files (optional)

Co-locate any types, schemas, or checklists the Droid should use when the skill is active (for example types.ts, schemas/, or rollout-checklist.md).
4

Restart and use

Restart droid or your integration so it rescans skills, then describe your task normally. The Droid will automatically invoke matching skills when they apply.

​
スキルと他の設定の違い

スキルはDroidの動作を形作る他の方法と並行して機能します：
  • カスタムDroid – どのモデルとツールを使用し、どの自律レベルで使用するかを定義；これらは完全なエージェント設定です。
  • レガシースラッシュコマンド（.factory/commands/） – ユーザーが呼び出すマクロで、まだ動作しますがスキルに置き換えられました。スキルは同じ/command機能に加えて、オプションのDroid呼び出しとサポートファイルを提供します。
  • MCPサーバー – 外部システム（API、データベース、SaaSツール）をツールとして公開；これらはリソースの接続に関するもので、ワークフローのエンコーディングではありません。
スキルが異なるのは以下の理由です：
  • 作業の実行方法（エンジニアリングプレイブック）を再利用可能な機能としてパッケージ化
  • 柔軟な呼び出しをサポート – あなた（/skill-name経由）とDroidの両方がトリガーでき、誰が何を呼び出せるかのfine-grained control
  • 発見可能で組み合わせ可能 – Droidは計画内で複数のスキルを連鎖できます
  • ツール、カスタムDroid、MCPサーバーの上に位置し、それらを安全にオーケストレーション
実際には以下のようになります：
  • MCPを使用して内部デプロイAPIを公開
  • カスタムDroidを使用してCIで許可されるツール/モデルを定義
  • スキルを使用してそのAPIとDroid設定を使った「カナリアデプロイメントを安全にロールアウトする方法」をエンコード

​
エンタープライズコードベースでスキルが重要な理由

スキルは以下が必要なエンタープライズ環境で特に価値があります：
  • Droidがフロントエンド実装、サービス統合、データクエリ、内部ツールを実行する方法を標準化
  • チームの慣例、安全ルール、SLAを一度エンコードし、プロジェクト間で再利用
  • 自動化を発見可能、監査可能、共有可能にする（git経由）、単なる「一つのチャットで起こったこと」ではなく
Factoryのためにゼロからスキルを作成するか、他のエージェントのために既に投資した既存のスキルを再利用し、それらをインポートしてDroid設定に配線できます。

​
ベストプラクティス

Design skills around a single responsibility (e.g., “implement a typed React UI for an existing endpoint”), not “build the whole feature”. Define a crisp success criterion: what artifacts should exist when the skill finishes (files changed, tests added, docs updated, approvals gathered). Prefer several small skills composed by a Droid over one giant “do everything” skill.
Document required inputs: repo path, services involved, APIs, schemas, feature flag names, etc. Use structured fields (JSON snippets, bullet lists, tables) instead of long prose when describing APIs or data models. For security-sensitive workflows, include explicit “never do” constraints and escalation conditions.
Bake in your testing, observability, and rollout requirements so the skill always follows them. Reference your existing AGENTS.md, runbooks, and design docs instead of inlining everything. Require proof artifacts: tests, screenshots, log queries, or links to dashboards depending on the domain.
Assume large monorepos, multiple services, and layered approvals. Be explicit about which directories Droids may touch, which languages/frameworks are in-bounds, and which are not. Include guidance for cross-team dependencies – when to stub, when to coordinate with another team, and when to stop and ask.
Prefer idempotent skills: safe to rerun on the same branch/PR. Design skills to produce machine-parseable output where possible (for example, a short summary block that other skills can consume). Keep skills stateless beyond the current branch: no hidden assumptions about prior runs.
Always include a “Verification” section that lists commands Droids must run before completing the skill. Call out fallbacks when verification fails (rollback steps, feature flags, or canary paths). For production-adjacent skills, require that Droids open PRs but never merge without human review.

​
クックブック

クックブックは、一般的なエンタープライズソフトウェアワークフローを対象とした意見のあるスキルテンプレートを提供します。 7つのスキルファミリーに焦点を当てています：
  1. Frontend implementation skills – 既存のAPIと統合するUIサーフェスの構築
  2. Integration skills for complex codebases – 大きなmonorepoでのサービスの拡張または配線
  3. Internal data querying skills – 内部分析またはデータサービスへの安全で監査可能なアクセス
  4. Internal tools skills – 開発者と運用者のワークフローを改善する小さくても堅牢な内部アプリの構築
  5. Vibe coding skills – 完全なモダンWebアプリケーションをゼロから迅速にプロトタイピングし構築（Lovable/Bolt/v0の代替）
  6. AI data analyst skills – 包括的なデータ分析、可視化、統計モデリング（データアナリストツールの代替）
  7. Product management skills – PRD、機能分析、PMワークフローの支援（PMツール拡張）
  8. Browser automation skills – CDP経由でChromeを起動し、ライブタブをナビゲートし、DOM状態を評価し、MCPサーバーを実行せずにスクリーンショットまたはセレクターを収集

Frontend UI integration

Implement typed, tested frontend flows against existing backend APIs using your design system, routing, and testing conventions.

Service integration in complex codebases

Extend or wire backend services in a shared monorepo while respecting ownership boundaries, observability, and rollout requirements.

Internal data querying

Safely query internal analytics and data services, producing reproducible queries and shareable analysis artifacts.

Internal tools

Build or extend internal-facing tools (admin panels, consoles, utilities) with strong RBAC, audit logging, and operational safeguards.

Vibe coding

Rapidly prototype and build complete modern web applications from scratch using React, Next.js, Vue, or other frameworks. Local-first alternative to Lovable, Bolt, and v0.

AI data analyst

Perform comprehensive data analysis, statistical modeling, and create publication-quality visualizations using Python and the full data science ecosystem.

Product management

Assist with product management workflows including writing PRDs, analyzing features, synthesizing research, and planning roadmaps.

Browser automation

Launch Chrome with remote debugging, drive tabs, evaluate DOM state, and capture screenshots or selectors without deploying extra infrastructure.
実際には、各スキルフォルダにはエージェントがコアプロンプトテンプレートと一緒に使用するサポートユーティリティも含めることができます。例：
  • SKILL.mdまたはskill.mdx – メインのスキル仕様
  • references.md – コードベースに既に存在する型、API、モジュールへのリンクとポインター
  • schemas/ – スキルによって参照されるJSON/YAMLスキーマまたはOpenAPIスニペット（信頼できるソースのサービスコードではない）
  • checklists.md – 再利用可能な検証またはロールアウトチェックリスト
これらの同じ場所に配置されたファイルは、スキルが呼び出されたときに、プロダクションコードを複製または再配置することなく、エージェントが作業する予測可能で構造化されたコンテキストバンドルを提供します。 これらを出発点として使用し、入力、制約、検証手順をあなたのスタックとガバナンス要件に合わせて調整してください。