mcpField
Y
your-skill-name

your-skill-name

github.com/nickcrewその他6260 回インストール18 週間前に更新
リポジトリ

your-skill-name について

your-skill-nameは、特定の専門スキルを説明するものではなく、汎用的なスキル文書テンプレートです。概念、利用場面、統合、テスト、トラブルシューティング、保守の章と例のプレースホルダーを備えています。

主な機能

  1. 01スキル概要と利用開始条件の章
  2. 02概念とパターンの文書化セクション
  3. 03統合とベストプラクティスのセクション
  4. 04テストとトラブルシューティングのテンプレート
  5. 05バージョン、保守、ライセンスのセクション

活用シーン

  1. 01構造化されたスキル README の作成
  2. 02例やガイダンスの章立ての計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nickcrew/claude-cortex --skill your-skill-name

インストール後、Claude Code で/your-skill-nameを入力して読み込まれたか確認します。

詳細

スキルのタイトル

このスキルで提供する機能、その目的、対象範囲を説明する概要を記載します。主要な概念と、このスキルの価値についても含めてください。

このスキルを使用する場面

このスキルを有効にする具体的なシナリオを5～10個記載します。

  • シナリオ 1：明確なきっかけを伴う具体的なユースケース
  • シナリオ 2：別の状況
  • シナリオ 3：関連するものの異なる状況
  • シナリオ 4：例外的なケース、または高度な使い方
  • シナリオ 5：他のツールやフレームワークとの連携

コアコンセプト

このスキルを理解するために必要な基礎概念を簡潔に紹介します。

コンセプト 1：基礎

最初の重要な概念を、簡単な例とともに説明します。

// Simple, clear example demonstrating concept
// Include comments explaining key points

重要なポイント：

  • 重要な側面 1
  • 重要な側面 2
  • 重要な側面 3
コンセプト 2：構成要素

2つ目の重要な概念を、基本から中級へと段階的に説明します。

// Example showing concept application
// Demonstrate best practices

使用する場面：

  • ユースケース 1
  • ユースケース 2
  • ユースケース 3

よく使われるパターン

パターン 1：[パターン名]

問題：このパターンで解決する問題を説明します。

解決策：このパターンのアプローチを説明します。

例：

// Complete, working example
// Well-commented to explain approach
// Include edge cases if relevant

function examplePattern() {
  // Implementation details
  // Show best practices
}

メリット：

  • メリット 1
  • メリット 2
  • メリット 3

デメリット：

  • 制限事項 1
  • 制限事項 2

使用する場面：このパターンを適用する具体的な基準

パターン 2：[パターン名]

問題：2つ目の問題領域

解決策：代替または補完的なアプローチ

例：

// Different approach showing variety
// Demonstrate trade-offs

比較：このパターンとパターン 1 との違い

高度な使い方

このセクションでは、複雑なシナリオ向けのより高度なパターンを紹介します。必要な場合にのみ読み込んでください。

高度なパターン 1：[複雑なシナリオ]

高度な使い方が必要となる状況を説明します。

// More sophisticated example
// Show integration with multiple concepts
// Demonstrate production-ready code

class AdvancedExample {
  // Complete implementation
  // Include error handling
  // Show performance considerations
}

検討事項：

  • パフォーマンスへの影響
  • スケーラビリティに関する懸念
  • セキュリティ上の影響
  • メンテナンスの負担
高度なパターン 2：[例外的なケース]

例外的なケースや一般的でないシナリオへの対処方法：

// Edge case handling
// Defensive programming
// Graceful degradation

統合例

[関連技術 1] との統合
// Show how this skill integrates with other systems
// Practical, real-world example
[関連技術 2] との統合
// Different integration scenario
// Demonstrate flexibility

ベストプラクティスのまとめ

このスキルを効果的に実装するためのクイックリファレンスです。

推奨事項
  • 最良の結果を得るために、これを実行します
  • この側面を常に考慮します
  • 可能であれば、このアプローチを優先します
  • 続行する前に、この条件を検証します
  • 保守性を高めるために、この情報を文書化します
非推奨事項
  • このアンチパターンを避けます
  • この重要な手順を忘れないでください
  • 本番環境では、決してこれを行わないでください
  • この例外的なケースを見落とさないでください
  • よくあるこの間違いを避けます
パフォーマンスのヒント
  • 最適化手法 1
  • 最適化手法 2
  • キャッシュ戦略
  • リソース管理
セキュリティ上の考慮事項
  • セキュリティ対策 1
  • セキュリティ対策 2
  • 入力検証の要件
  • 認証・認可に関する懸念

よくある落とし穴

落とし穴 1：[よくある間違い]

問題：何がうまくいかないのかを説明します。

原因：根本原因を説明します。

解決策：回避方法または修正方法

// Incorrect approach (anti-pattern)
// badExample();

// Correct approach
// goodExample();
落とし穴 2：[別の間違い]

問題：2つ目によくある問題

解決策：予防策

テスト戦略

単体テスト
// Example test cases
// Show test structure
// Demonstrate assertions

describe('Feature', () => {
  it('should handle expected case', () => {
    // Test implementation
  });

  it('should handle edge case', () => {
    // Edge case testing
  });
});
統合テスト
// Integration test example
// Show testing across boundaries

実例

例 1：[実用的なシナリオ]

状況：現実の状況を説明します。

実装：

// Complete, production-ready example
// Include error handling
// Show configuration
// Demonstrate best practices

class RealWorldExample {
  // Full implementation
  // Comments explaining decisions
  // Edge case handling
}

結果：得られた成果とメリット

例 2：[異なるシナリオ]

状況：別のユースケース

実装：

// Different approach for different context

得られた教訓：この実装から得られた知見

トラブルシューティング

問題 1：[よくある問題]

症状：ユーザーが確認する現象

原因：一般的な根本原因

解決策：

  1. 最初に試す解決策
  2. 別のアプローチ
  3. 最終手段

予防：この問題を回避する方法

問題 2：[別の問題]

症状：確認できる動作

診断手順：

  1. まずこれを確認します
  2. この条件を検証します
  3. この側面を調査します

解決方法：修正方法

ツールとリソース

推奨ツール
  • ツール 1：機能と使用するタイミング
  • ツール 2：代替ツールとトレードオフ
  • ツール 3：補完的なツール
ライブラリとフレームワーク
  • ライブラリ 1：目的と統合方法
  • ライブラリ 2：代替ライブラリとの比較
ドキュメントへのリンク
さらに詳しく
  • 記事／書籍：概要
  • チュートリアル：対象となる内容
  • ビデオコース：主なポイント

バージョン履歴

  • 1.0.0 (2024-10-17)：初回リリース
    • 中核となるパターンを実装
    • サンプルを検証
    • ベストプラクティスを文書化

関連スキル

このスキルは、次のスキルと組み合わせると効果的です：

  • related-skill-1：相互の補完方法
  • related-skill-2：併用するタイミング
  • related-skill-3：統合ポイント

メンテナンスに関する注記

作者の取り組み：想定される更新頻度とメンテナンス方法

貢献を歓迎します：コミュニティからの貢献が役立つ領域

既知の制限事項：現在の不足点や改善予定

非推奨化ポリシー：破壊的変更への対応方法

ライセンス

このスキルは MIT License のもとでライセンスされています。詳細は LICENSE file を参照してください。

作者へのお問い合わせ

このスキルに関する問題や質問については、次の手順に従ってください：

  1. 上記のドキュメントを確認する
  2. 既存の GitHub issue を検索する
  3. community-skill:your-skill-name ラベルを付けて新しい issue を作成する
  4. 緊急の場合は作者に直接連絡する

コメント

Markdown 対応