skill-authoring

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

skill の作成・変更

Creating and modifying skills

大本は https://github.com/cursor/plugins/blob/main/pstack/skills/poteto-mode/playbooks/authoring-a-skill.md 。

skill の書きぶりはあなたが責任を持つ。

skills CLI の
```
skills init <name>
```
で
```
SKILL.md
```
を作る。複数のリポジトリで使う skill は masseater/skills の
```
skills/
```
に置く。
検証する。frontmatter に
```
name
```
と
```
description
```
があること、参照するファイルが存在すること、他の skill へのリンクが解決することを確かめる。
構造的な内容ならテストケースを書く。主観的な内容なら書かない。
リポジトリの手順で PR を出す。

迷ったら消す。判断を変える文だけを残す。何をするかを命じ、理由は書かない。理由がないと混乱する規則にだけ説明を付ける。文の調子は扱う範囲に合わせる。構造的な情報源（型、README、設定）を指し示し、繰り返す指示は文を足さずに lint・メタデータ・実行時の検査・スクリプトにする。他の skill にはパスで委ね、言い直さない。繰り返し踏むのに skill になっていない手順があれば、新しい skill を提案する。

返答: skill の要約、主な設計判断、検証の結果。

The source of truth is https://github.com/cursor/plugins/blob/main/pstack/skills/poteto-mode/playbooks/authoring-a-skill.md .

You are responsible for how a skill is written.

Use
```
skills init <name>
```
from the skills CLI to create
```
SKILL.md
```
. A skill used across multiple repositories belongs in the
```
skills/
```
directory of masseater/skills.
Validate it. Ensure that the frontmatter contains
```
name
```
and
```
description
```
, referenced files exist, and links to other skills resolve correctly.
Write test cases for structural content. Do not write them for subjective content.
Open a PR using the repository's process.

When in doubt, delete it. Keep only sentences that change a decision. State what to do, not why. Explain only rules that would be confusing without an explanation. Match the tone of the writing to its scope. Point to sources of structural information (types, README, configuration), and turn repeated instructions into lint, metadata, runtime checks, or scripts instead of adding more sentences. Delegate to other skills by path, and do not restate their content. If a procedure is performed repeatedly but has not been turned into a skill, propose a new skill.

Response: A summary of the skill, the main design decisions, and the validation results.