| okf_version | 0.1 |
|---|
rinse/skills（再利用可能な Agent 向け Skill のリポジトリ）について、一度全体を読まないと見えてこない横断的な法則と、Agent Skills プラットフォームの仕様・ベストプラクティスをまとめた knowledge です。
リポジトリ内の全 SKILL.md を読み通して抽出した、スキル群に共通する規約・設計思想。新しいスキルを書く／既存スキルを直すときの拠り所。
- スキル執筆の規約 - 言語・命名・frontmatter・ファイル構成の取り決め
- スキル設計の思想 - 「核」= 判断と機械作業の分離、合成主義、アクションスキルの共通骨格
- 外向き操作の安全則 - 取り消しづらい操作は実行前に確認、push はまず試し失敗時に委譲、保守的な既定
- ツール検出とフォールバック - 依存ツールの検出・導入提案・「未導入 ≠ 対象外」・MCP フォールバック
- Subagent 委譲と worktree の制約 - 高コスト/並列作業の委譲とオーケストレーターによる判断の保持
Anthropic 公式の Agent Skills の仕組み。一次資料（platform docs / engineering blog）に基づく。
- Skill フォーマットと段階的開示 - SKILL.md の構造・frontmatter の制限値・3 層のロード
- スキル執筆のベストプラクティス - eval 駆動・スケール時の分割・code と reference の使い分け
- ランタイムと配布 - Claude Code での配置・サーフェス間の非同期・実行環境の制約・セキュリティ