【要約】🤖 【Claude】自作Skillが「Claude Codeでは動くのにCoworkに出てこない」を解決する [Qiita_Trend] | Summary by TechDistill
> Source: Qiita_Trend
Execute Primary Source
// Problem
開発者がClaudeの自作Skillを運用する際、環境による挙動の乖離に直面する。具体的には、CLIでは動作するSkillが、デスクトップ版のCoworkでは一覧に表示されないという問題である。この問題の背景には以下の技術的要因がある。
- ・CLIとCoworkでSkillの探索メカニズムが異なる。
- ・CLIは~/.claude/skills/を自動走査するが、Coworkは独自のレジストリを参照する。
- ・Coworkはサンドボックス環境であり、ローカルの固定パスへのアクセスが制限される。
// Approach
開発者はCoworkの仕様に基づき、手動での登録プロセスと環境の使い分けを行う必要がある。まず、権限設定を確認した上で、以下の手順でSkillをインポートする。
- ・「設定 > 機能」から「コード実行とファイル作成」を有効化する。
- ・Skill一式をZIPまたは.skill形式でアーカイブする。
- ・Coworkの「カスタマイズ > スキル」からアップロードし、トグルを「オン」にする。
- ・反映のため、新しいセッション（タスク）を開始する。
- ・SKILL.mdのdescriptionは、YAML解析エラーを防ぐため1行で記述する。
// Result
適切な手順を踏むことで、Cowork上でも自作Skillの活用が可能になる。これにより、作業環境に応じた最適な使い分けが実現する。
- ・ローカル依存のSkillはCLI、サンドボックス完結のSkillはCoworkと役割を分離できる。
- ・アカウント単位での有効化により、チャットやプロジェクト間でのスキル共有が可能になる。
- ・記述ルールの遵守により、フロントマターの破損による認識エラーを回避できる。
Senior Engineer Insight
> 開発体験（DX）の観点では、CLIの直感的な操作がCoworkで通用しない点は、環境の抽象化レベルの違いに起因する。実務では、ローカルリソースに依存するツールはCLIに、ドキュメント生成等の純粋なロジックはCoworkに割り振る「環境分離戦略」が、運用コストを最小化する鍵となる。Skillの設計段階で、実行環境の境界線を意識することが不可欠である。