SynaLinks/synalinks-skills

このリポジトリの目的

• 単一の「スキル」 – SKILL.md ファイルとサンプルスクリプト、リファレンスドキュメントを提供し、コーディングエージェント（Claude Code、Codex、OpenCode、pi など）に Synalinks Python ライブラリの正しい使い方を教えます。
• このスキルはオープンな Agent Skills 形式に従っているため、その形式を理解するエージェントは自動的に読み込むことができます。

使用方法

1. スキルをインストール するには、skills CLI（Node ベースのツール）を使用します：

   npx skills add SynaLinks/synalinks-skills --skill synalinks
   

   • デフォルトでは、現在のプロジェクトの .claude/skills/（または使用するエージェントに対応するフォルダ）にインストールされます。
   • グローバルにインストールする（--global）か、シンボリックリンクの代わりにコピーする（--copy）こともできます。
2. エージェントは SKILL.md のフロントマターを読み、説明を認識し、Synalinks コードを書くように依頼するとスキルを 自動的に有効化 します。
3. スキルには以下が含まれます：
   • スキャン可能なガイド（SKILL.md）– Synalinks フレームワークをセクション（Core、Programs、Modules、Control flow、Knowledge、Training、Rewards、Optimizers、Providers、Datasets）に分けて解説します。
   • サンプルスクリプト（scripts/）– 使用上の注意と実行ログ付き。
   • 詳細なリファレンスドキュメント（references/）– 各セクションごとに用意。
4. エージェントがコードを生成するとき、スキルの指示により出力が Synalinks に慣用的なものに保たれ、Keras、LangChain、DSPy などの無関係な API が混入するのを防ぎます。
5. 後で npx skills update でスキルを更新できます（再現可能なビルドのためにロックファイルから再インストールも可能）。

役立つユーザー

• Synalinks ニューロシンボリック AI フレームワークでアプリケーションを構築する 開発者 で、Synalinks の規約を尊重する AI 支援コーディングを求める方。
• Claude Code、Codex、OpenCode、pi、または 70 以上のサポート対象エージェントを使用する チーム で、コード品質を向上させるプラグアンドプレイの方法を探している方。
• 環境間でエージェントが同じスキルセットを持つことを保証したい CI パイプライン（このリポジトリには、スキルファイルを仕様に対して検証する CI が含まれています）。

制限事項 / 注意点

• このリポジトリには 1 つのスキルのみ が含まれており、Synalinks ライブラリ自体は含まれていません。
• スキルは バージョン管理されていません – 常に main ブランチを追跡するため、最新のコミットを取得するには skills CLI に依存します。
• インストールには Node.js の npx 環境 が必要です。スキル自体はマークダウンとスクリプトのみで、追加のランタイム依存関係はありません。
• Agent Skills 仕様をサポートするエージェントでのみ動作します。サポートしていないエージェントは無視します。

---

上記の情報はすべて、リポジトリの README から直接取得したものです。