메뉴
Markdownスキルを作成するメタスキル。SKILL.mdのfrontmatterと本文、Progressive Disclosureとcreate_skillの手順を扱う。 Use when: 新規スキル追加、read_memory_file 向けの記述ルール確認、referencesやtemplates付きスキル生成が必要なとき。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | skill-creator |
| description | Markdownスキルを作成するメタスキル。SKILL.mdのfrontmatterと本文、Progressive Disclosureとcreate_skillの手順を扱う。 Use when: 新規スキル追加、read_memory_file 向けの記述ルール確認、referencesやtemplates付きスキル生成が必要なとき。 |
| 役割 | モジュール |
|---|---|
read_memory_file ツール（スキル／手続きの相対パスを指定して本文を読む） | ToolHandler 経由（記憶ツリー内ファイル） |
| システムプロンプト内のスキルカタログ（パス一覧・バジェット付き） | プロンプト構築（例: skills/foo/SKILL.md, common_skills/bar/SKILL.md, procedures/baz.md） |
create_skill ツール（ディレクトリ生成） | core/tooling/skill_creator.py |
| スキーマ（パラメータ定義） | core/tooling/schemas/skill.py |
フロントマター解析（行ベース・本文側の --- で誤分割しない） | core/memory/frontmatter.py の parse_frontmatter() |
メタデータ型・抽出（SkillMeta、手続きパス推定） | core/schemas.py、core/memory/skill_metadata.py の SkillMetadataService.extract_skill_meta() |
| 説明文ベースのスキルメタ抽出（カタログ・検索補助） | core/memory/skill_metadata.py の SkillMetadataService 等 |
*-tool 本文のゲート行除去 | core/tooling/guide.py の filter_gated_from_guide() |
| 許可ツール集合（permissions） | core/config/models.load_permissions() + core/tooling/permissions.get_permitted_tools() |
スキルと手続きは別レイアウトで管理される。
| 種別 | パス | 備考 |
|---|---|---|
| 個人スキル | skills/{name}/SKILL.md | ディレクトリ + SKILL.md |
| 共通スキル | common_skills/{name}/SKILL.md | ランタイムでは ~/.animaworks/common_skills/ 等 |
| 手続き（procedure） | procedures/{name}.md | フラット1ファイル。ディレクトリではない |
create_skill が生成するのは上表のスキル（個人または共通）のみ。手続きは write_memory_file 等で procedures/*.md として別途作成する。
スキル・手続きの本文は read_memory_file(path="...") で記憶ツリー相対パスを指定して読む。システムプロンプトのスキルカタログに、利用可能なパス（例: skills/foo/SKILL.md, common_skills/bar/SKILL.md, procedures/baz.md）が示される。
skills/{name}/SKILL.mdcommon_skills/{name}/SKILL.mdprocedures/{name}.mdpath は Anima ディレクトリ基準の相対パス（共有ツリーは common_skills/ 等のプレフィックス）で渡す。
SKILL.md 先頭の YAML は core/memory/frontmatter.parse_frontmatter() で除去して読む。区切り線 --- は行単位のみ認識されるため、YAML 値や本文中に --- が含まれても誤分割しにくい。
*-tool ガイド）スキル本文では {{now_local}}, {{anima_name}}, {{anima_dir}} 等のプレースホルダが使われる場合がある。外部ツール向けスキル（名前が *-tool で終わる）は、許可設定に応じて animaworks-tool 行のゲート処理が行われる（core/tooling/guide.py の filter_gated_from_guide() 等）。
スキルカタログの Level 1 では name + description がバジェット内に載る。スキル数が多いほど省略されやすいので、description は短く具体的に保つ。全文が必要なときはカタログのパスを read_memory_file で開く。
レガシー互換: description が空のとき、extract_skill_meta() は本文の ## 概要 セクションの最初の非空行をフォールバックとして使う。新規スキルではフロントマターを正とする。
個人 skills/ 直下の ***.md（フラット単一ファイル）**は、カタログやメタ抽出の対象になりうるが、推奨パスは skills/{name}/SKILL.md。運用上は create_skill によるディレクトリ形式を正とする。
SKILL.md はYAMLフロントマターとMarkdown本文で構成される。
フロントマターには name と description を必須とする。
create_skill は allowed_tools だけでなく、信頼・出自・分類・ルーティング補助のメタデータも書き出せる。必須は name / description / body で、任意キーは用途が明確なときだけ使う。
---
name: skill-name
description: >-
スキルが行うことの簡潔な説明（三人称）。
Use when: このスキルを使う具体的な場面をカンマ区切りで列挙する。
allowed_tools:
- read_memory_file
- web_search
trust_level: trusted
source:
type: anima
origin: manual
category: communication
use_when:
- drafting partner emails
trigger_phrases:
- draft a partner email
negative_phrases:
- personal diary
domains:
- gmail
routing_examples:
- Prepare a reply draft for the bank thread
---
主な任意フィールド: allowed_tools, trust_level, source_type, source_origin, category, promotion_status, skill_policy, use_when, trigger_phrases, negative_phrases, domains, routing_examples。create_skill の引数名では source.type は source_type、source.origin は source_origin として渡す。
description の役割新規スキルの記述は Agent Skills 標準に沿い、Use when: で利用シーンを書く（詳細は references/description_guide.md）。作成後は python scripts/lint_skill.py で形式を検証できる。
read_memory_file でパスを指定して読んだ場合: ファイルが存在すれば description のマッチに関係なく 本文が得られる（フロントマター処理・*-tool 関連の扱いは読み込み経路に依存）。name + description がバジェット付きで載る。全文は載らないため、手順が必要なら read_memory_file(path="skills/.../SKILL.md") 等で開く。レガシー互換: description が空のとき、extract_skill_meta() は本文先頭付近の ## 概要 セクションの最初の非空行を description のフォールバックとして使う。新規スキルではフロントマターを正とし、## 概要 依存は避ける。
description の書き方（Use when: パターン・lint）は references/description_guide.md を参照。
スキルの情報は概ね次の段階で開示される。
| Level | 内容 | 表示タイミング |
|---|---|---|
| Level 1 | name + description | システムプロンプトのスキルカタログ（バジェット内）の材料 |
| Level 2 | body（本文） | エージェントが read_memory_file(path="skills/.../SKILL.md") 等で読み込んだとき |
| Level 3 | 外部リソース | 本文の指示に従い、必要時に read_memory_file 等で references/ や templates/ を読む |
Level 1 はカタログでコンテキストを消費しやすいため description は簡潔に。Level 2 は手順の中核。Level 3 で長大な参照を分離する。
※ Priming のスキル本文注入経路は廃止済み。本文が必要なら read_memory_file でスキルパスを開く。
ユーザーの要求を理解する。以下を確認する:
procedures/ への別設計）以下を決定する:
my-skill）。外部ツールガイドなら *-tool 規約を検討Use when: 行（references/description_guide.md を参照）{{now_local}} 等のプレースホルダを利用use_when / trigger_phrases / negative_phrases / domains / routing_examples を必要に応じて設計create_skill ツールでスキルをディレクトリ構造として作成する。
基本（個人スキル）:
create_skill(skill_name="{name}", description="{description}", body="{body}")
共通スキル:
create_skill(skill_name="{name}", description="{description}", body="{body}", location="common")
references と templates を含める場合:
create_skill(
skill_name="{name}",
description="{description}",
body="{body}",
location="personal",
references=[
{"filename": "description_guide.md", "content": "..."},
],
templates=[
{"filename": "skill_template.md", "content": "..."},
],
allowed_tools=["read_memory_file", "write_memory_file"]
)
| パラメータ | 必須 | 説明 |
|---|---|---|
| skill_name | ✓ | スキル名（ケバブケース）。/, \, .. 不可 |
| description | ✓ | frontmatter description（Use when: 推奨。references/description_guide.md） |
| body | ✓ | SKILL.md本文（Markdown）。ビルトイン置換対象 |
| location | personal（デフォルト）または common | |
| references | references/ に配置するファイル群。[{filename, content}, ...] | |
| templates | templates/ に配置するファイル群。[{filename, content}, ...] | |
| allowed_tools | frontmatter の allowed_tools（任意） | |
| trust_level | trusted / community などの信頼レベル | |
| source_type / source_origin | 出自（例: anima, manual, auto_created） | |
| category | 分類タグ | |
| promotion_status | probation / trusted などの昇格状態 | |
| skill_policy | prompt注入方針（use_mode, injection系の設定） | |
| use_when / trigger_phrases / negative_phrases / domains / routing_examples | スキルルーターの候補選択を助ける補助メタデータ |
references / templates の filename にパス成分は含めない。_validate_filename() で親ディレクトリ外に解決されないことを確認し、不正なら黙ってスキップ（そのファイルは作られない）。
※ 新規スキルには必ず create_skill を使うこと。write_memory_file で skills/foo.md のような直下の単一ファイルだけを作る方法は非推奨。この形式は read_memory_file(path="skills/foo/SKILL.md") では開けないため、推奨は skills/foo/SKILL.md のディレクトリ形式。
※ 手続きは procedures/{name}.md（フラット1ファイル）。フロントマターはスキルと同様に name / description（＋任意 allowed_tools）を推奨。
read_memory_file(path="skills/{name}/SKILL.md") で内容確認read_memory_file(path="common_skills/{name}/SKILL.md") 等、カタログに示されたパスで確認read_memory_file(path="procedures/{name}.md") で解決できることを確認python scripts/lint_skill.py で SKILL.md の frontmatter / description を検証（任意だが推奨）保存前に以下を確認する:
--- で始まり --- で閉じるYAMLフロントマターがあるname フィールドがあるdescription フィールドがあるUse when: があり、かつドメイン固有の具体語を含める（旧 「」 列挙は使わない）description を置き、## 概要 だけに説明を依存しない（## 発動条件 等の旧テンプレート形式も避ける）trust_level, source, category, skill_policy, use_when, trigger_phrases, negative_phrases, domains, routing_examples）は実際の用途と一致しているcreate_skill で {name}/SKILL.md を作成している（手続きは procedures/*.md で意図通りか）本スキル同梱の templates/skill_template.md を参照する。または以下をコピーして使用:
---
name: {スキル名}
description: >-
{具体的な対象}の{具体的な操作}スキル（三人称の短い要約）。
Use when: {利用シーンをカンマ区切り}
---
# {スキル名}
## 手順
1. ...
2. ...
## 注意事項
- ...
name と descriptioncreate_skill は信頼・出自・分類・policy・routing補助メタデータも設定できる。不要なキーは増やさず、説明文だけで十分な場合はシンプルに保つreferences/ を活用して本文を簡潔に保つListen-only scribe workflow for Zoom meetings. Silently understand and record meeting transcripts delivered via RTMS, escalate only urgent matters to your supervisor, and post the report only after human approval once the meeting ends. Use when: receiving an inbox message with source=zoom (carrying a "[Zoom会議実況 チャンク#N …]" or "[Zoom会議終了 …]" header).
Zoom会議の聞き取り担当ワークフロー。RTMS経由で届く会議トランスクリプトを黙って理解・記録し、緊急事項のみ上司へエスカレーション、会議終了後に人間の承認を得てからレポートを投稿する。 Use when: source=zoom のinboxメッセージ（「[Zoom会議実況 チャンク#N …]」または「[Zoom会議終了 …]」ヘッダ付き）を受信したとき。
Zoom 회의 청취 담당 워크플로. RTMS를 통해 도착하는 회의 트랜스크립트를 조용히 이해·기록하고, 긴급 사항만 상사에게 에스컬레이션하며, 회의 종료 후 사람의 승인을 받은 뒤 리포트를 게시한다. Use when: source=zoom 인 inbox 메시지(「[Zoom会議実況 チャンク#N …]」 또는 「[Zoom会議終了 …]」 헤더 포함)를 수신했을 때.
cron.mdを正しいフォーマットで読み書きするスキル。定時タスクの追加・更新・削除手順を提供する。 Use when: cron.mdの編集、cron式の追加、LLM型・コマンド型タスクの追加・削除、定時ジョブのメンテナンスが必要なとき。
Skill for hiring and creating new Digital Anima in the AnimaWorks organization. Create a character sheet (Markdown) based on interviews, then use the CLI command (animaworks anima create) to generate identity/injection/permissions in bulk. After creation, self-configure via bootstrap. "Create a new employee", "Hire someone", "New employee", "Hiring", "Create Anima", "Recruitment", "Add team member", "Expand the team", "Add staff", "Create subordinate", "hire", "recruit", "team member"
Skill for operating and managing AnimaWorks server processes. Perform hot reload (server reload) after code updates, Anima process restart, and server status checks (list of running Anima, memory usage). "Reload", "Apply updates", "Refresh", "System status", "Server restart", "Process check"