skillsmith は何をしますか?
一行のアイデアから仕様準拠のエージェントスキルをスキャフォールディングし、SKILL.mdファイルをリントします(名前ルール、説明の長さと「Use when」句、互換性制限、メタデータマップ、本文の長さ、シークレット漏洩)。
ゼロ依存のCLIcli.jsがSkillSmithリポジトリのルートにあり、処理を実行します。
使用するタイミング
- ユーザーがタスク用の新しいスキルを希望する場合(「~するスキルを作って」など)。
- ユーザーがスキルフォルダやSKILL.mdが標準に従っているかどうかを知りたい場合、または修正を希望する場合。
手順
- 検証するには、
node <path-to-skillsmith>/cli.js validate <skill-dir>を実行します(複数のフォルダを指定可能)。終了コード0は有効を意味します。 - すべての
errorを報告し、ユーザーのSKILL.mdで修正します:名前を小文字ハイフン区切りに変更し、フォルダ名をnameと一致させ、descriptionを1024文字以内にし、「Use when …」を含めます。その後、手順1を再実行します。 - スキルを作成するには、
GEMINI_API_KEYが設定されていることを確認し(決して表示しない)、次を実行します:node <path-to-skillsmith>/cli.js new "<機能と使用するタイミング>" --out <skills-dir> --author "<名前>" - 生成された
SKILL.mdをユーザーに表示し、新しいフォルダに対して手順1を実行します。必要に応じて編集します。CLIは既存のSKILL.mdを上書きしません。
例
node cli.js validate skills/commitcraft skills/skillsmithnode cli.js new "CSVファイルを要約し、グラフを提案する。ユーザーが.csvを共有したときに使用" --out ./skills
注意事項
- 未知のトップレベルフィールドは警告を生成します。カスタムデータは
metadataの下に配置してください。 - 仕様では本文を500行未満にすることを推奨しています。長いドキュメントは
references/に移動してください。