nft-standards

nft-standardsスキルの概要

nft-standardsスキルでできること

nft-standardsスキルは、ERC-721 と ERC-1155 を軸に、NFTコントラクトと関連するプロダクトロジックの設計・実装を支援します。対象には、メタデータ、ミント方式、ロイヤリティ、マーケットプレイスでの挙動、Soulbound型のバリエーション、Dynamic NFT まで含まれます。単発の Solidity スニペットが欲しい場面というより、NFT機能のコード構成や設計判断まで含めて整理したいときに特に有効です。

nft-standardsが向いている人

この nft-standards skill は、次のようなケースに適しています。

• ERC-721 と ERC-1155 のどちらを選ぶべきか判断したい Web3 開発者
• NFTコレクションやゲームアセットを立ち上げるチーム
• メタデータやトランスファー設計を扱うマーケットプレイス開発者
• ロイヤリティ、リビール機能、譲渡不可トークンを組み込みたいプロダクトエンジニア

「自分のユースケースに合うNFT実装を正しく進めたい」という課題なら、汎用的なスマートコントラクト用プロンプトより、このスキルのほうがタスクに近いです。

実際に解決したい仕事

多くのユーザーが気にしているのは規格名そのものではなく、実装に直結する判断です。

• どのNFT標準が自分のプロダクトに合うのか？
• メタデータはどこに保存し、どう公開すべきか？
• どんなミント上限や価格チェックが必要か？
• ロイヤリティやマーケットプレイス側の期待はコントラクト設計にどう影響するか？
• どんな場合に soulbound や dynamic NFT パターンを使うべきか？

nft-standards の価値は、こうした選択肢を実装前提で整理してくれる点にあります。

汎用プロンプトと違う点

このスキルの元データは、Web3 における NFT 標準にテーマを絞っています。そのため、「NFTコントラクトを書いて」だけの依頼よりも、モデルが最初から適切な前提で考えやすくなります。カバーしているのは以下です。

• 一意なトークン向けの ERC-721
• マルチトークンや半代替可能な設計向けの ERC-1155
• メタデータの設計パターン
• ロイヤリティや高度なNFT挙動

この絞り込みによって、特にコードを書く前に標準選定をきちんと考えさせたい場面で、プロンプトのブレが起きにくくなります。

インストール前に知っておきたい制約

このスキルはコンテンツのみで構成されており、リポジトリ上のパスには SKILL.md しかありません。補助スクリプト、テスト、参照ドキュメント、意思決定表などは付属しません。つまり、nft-standards install 自体は軽量ですが、出力の質は与えるプロンプトに大きく左右されます。監査済みフレームワークや本番向けコントラクト集としてではなく、実装判断をガイドする文脈として使うのが適切です。

nft-standardsスキルの使い方

nft-standardsのインストール前提

親リポジトリからスキルをインストールします。

npx skills add https://github.com/wshobson/agents --skill nft-standards

このスキルは plugins/blockchain-web3/skills/nft-standards に配置されているため、スキル単体で追加のパッケージ設定は必要ありません。インストール後は、依頼内容が NFT 標準に明確に関係していれば、エージェントがこのドメイン知識を参照できます。

まず読むべきファイル

最初に確認するのは次です。

• SKILL.md

このスキルフォルダには README.md、rules/、resources/、補助ファイルといった追加資料がありません。実用的なガイダンスの大半は、この1ファイルに集約されています。評価しやすく、手早く全体を見て、自分のスタックに合うか判断できます。

nft-standardsが特に役立つ使いどころ

nft-standards usage は、エージェントに次のようなことをさせたいときに有効です。

• ERC-721 と ERC-1155 のどちらを採用すべきか決める
• ミント制約付きのNFTコントラクトの骨組みを作る
• メタデータ項目と token URI 戦略を定義する
• ロイヤリティ対応やマーケットプレイスを意識した挙動を追加する
• dynamic NFT や soulbound への発展案を出す

特に、後から標準選定を覆すコストが高いアーキテクチャ初期や初回実装段階で効果を発揮します。

スキルがうまく機能するために必要な入力

このスキルは、以下を渡すと精度が大きく上がります。

• 既に決まっているなら対象標準、未確定ならビジネスモデル
• 利用するチェーンや EVM 環境
• メタデータを on-chain、IPFS、中央集権型のどれに置くか
• ミントモデル: public mint、allowlist、lazy mint、admin mint
• トランスファーポリシー: transferable、restricted、soulbound
• 総供給ルールと per-wallet / per-tx 上限
• ロイヤリティに関する期待値
• マーケットプレイス互換性の要件
• トークンが一意資産、エディション、ゲーム内アイテムのどれか

これらがないと、モデルはあなたの制約ではなく、一般的なサンプルに寄ってしまいます。

曖昧な要望を強いプロンプトに変える

弱いプロンプト:

Build me an NFT contract.

より強い nft-standards guide プロンプト:

Use the nft-standards skill to recommend ERC-721 or ERC-1155 for a game with unique character NFTs and stackable item NFTs. We need IPFS metadata, OpenSea-compatible metadata, creator royalties, admin minting for rewards, and a soulbound achievement badge. Explain the standard split, then generate Solidity contracts using OpenZeppelin and list security and marketplace tradeoffs.

これが優れている理由:

• プロダクトの形が見える
• 単にコードではなく、標準の判断を求めている
• メタデータとマーケットプレイス上の制約が明示されている
• 複数契約が必要になりうる混在アセットを表に出している

コントラクト生成用のプロンプトパターン

安定して使いやすい構成は次の通りです。

1. アセットモデルを説明する
2. 譲渡可能性のルールを明示する
3. メタデータの配置場所を定義する
4. ミント権限と上限を示す
5. 外部互換性の要件を挙げる
6. コードに加えて理由説明も求める

例:

Use nft-standards for Web3 contract design. Build an ERC-1155 for in-game items with fungible and semi-fungible token IDs, URI substitution metadata, batch minting, operator approvals, and royalties. Include admin-only mint, pause controls, and a short explanation of why ERC-1155 is better than ERC-721 here.

ERC-721とERC-1155をどう選ぶか

これはこのスキルの中でも特に価値が高い使い方です。

ERC-721 を使うべきなのは、次のような場合です。

• 各トークンが本質的にユニークである
• コレクションとしての個別性が重要である
• 1/1 アセットとしてのマーケットプレイス表示やウォレット表示を優先したい

ERC-1155 を使うべきなのは、次のような場合です。

• 1つのコントラクトで多くのトークン種別を扱いたい
• バッチ転送やバッチミントが重要である
• 一部アイテムが半代替可能、または供給数ベースで管理される
• 多数のアセットクラスをまたいでガス効率が重要である

選定理由は、在庫モデル、メタデータ構造、トランスファー挙動の観点で説明させるのがおすすめです。

Web3向け nft-standards の実践ワークフロー

おすすめの流れは次の通りです。

1. まずスキルにNFTモデルを分類させる
2. 推奨標準とコントラクトの形を提案させる
3. ミント、メタデータ、トランスファー前提を見直す
4. 本番投入に向けた不足点を洗い出させる
5. その後で、自分のリポジトリ向けにコード生成またはリファクタリングを行う

最初から完成コードを求めるより、この順番のほうが有効です。NFTプロジェクトは、文法ミスより要件ミスマッチで失敗することのほうが多いためです。

出力で確認すべきポイント

エージェントが nft-standards を使った場合、返答に次が含まれているか確認してください。

• どの標準を選ぶか、その理由
• metadata URI の設計
• ミント権限と供給上限
• ロイヤリティの仕組み
• マーケットプレイス互換性に関する前提
• トランスファー制限が標準的な期待を壊していないか
• reveal、metadata freeze、状態変化のようなエッジケース

これらが抜けているなら、出力はまだ汎用的すぎます。

導入時によくある障害

主な障害はインストールではなく、実装要件の曖昧さです。

• ERC-721 と ERC-1155 の違いが不明確
• メタデータ戦略が決まっていない
• ロイヤリティが常に on-chain で強制されると誤解している
• soulbound 挙動を求めているのに、エコシステム互換性を考えていない
• ユニーク資産と代替的資産のモデルを曖昧なブリーフのまま混在させている

このスキルは、こうしたプロダクト上の判断を最初に明文化できるほど効果が高まります。

nft-standardsスキルのFAQ

nft-standardsは初心者にも向いていますか？

はい。ただし、Solidity とトークンの基本概念をある程度理解していることが前提です。nft-standards skill は実装の方向付けには役立ちますが、スマートコントラクト、デプロイ、セキュリティ監査の完全な入門教材ではありません。

nft-standardsを使わないほうがいいのはどんなときですか？

次のようなタスクが主目的なら、nft-standards は適任ではありません。

• 代替可能トークンのトークノミクス設計
• コントラクト設計を伴わないウォレット連携
• マーケットプレイスのバックエンドインデックス処理のみ
• 法務・コンプライアンスの助言
• 本番セキュリティレビューや監査承認

このスキルが最も強いのは、NFTコントラクトとメタデータ設計であって、ローンチ全体のライフサイクルではありません。

nft-standardsはOpenZeppelin docsの代わりになりますか？

いいえ。代替ではなく補完です。まずスキルで解決方針を整理し、目的に合った実装計画を作り、その後で継承の選び方、hooks、拡張機能の挙動を公式ライブラリのドキュメントで確認してください。

nft-standardsはSoulbound NFTにも対応できますか？

はい。元のスキルには soulbound のユースケースが明示的に含まれています。ただし、トランスファーを禁止するとウォレット対応、マーケットプレイス側の前提、ユーザー期待値にどう影響するかは、エージェントに説明させるべきです。というのも、「譲渡不可NFT」の実装には複数の流儀があるためです。

nft-standardsだけでマーケットプレイス連携まで十分ですか？

マーケットプレイスを意識した設計、特にメタデータやロイヤリティ関連の前提整理には役立ちます。ただし、すべてのマーケットプレイスとの互換性を保証するものではありません。対象プラットフォーム上で、メタデータ表示、ロイヤリティ処理、承認フロー、インデックス挙動は別途テストが必要です。

シンプルなコレクション用コントラクトだけ欲しい場合でも使えますか？

はい、使えます。ただしプロンプトは絞ってください。固定供給の標準的なコレクションだけが欲しいなら、そのように明示しましょう。そうしないと、ロイヤリティや高度なメタデータ設計など、不要なオプション機能まで追加されることがあります。

nft-standardsスキルを改善するには

nft-standardsにより具体的なプロダクト文脈を与える

nft-standards の出力を最も手早く改善する方法は、コントラクト種別だけでなく、アセットシステム自体を説明することです。たとえば次のように伝えます。

• “10,000 unique profile-picture NFTs with reveal metadata”
• “game items with stackable consumables and unique skins”
• “non-transferable completion badges”

この粒度まで文脈を与えると、標準選定の精度が上がり、不要な機能も減ります。

メタデータのルールは早めに指定する

質の低い出力の多くは、メタデータ指示の弱さが原因です。次の点をスキルに伝えてください。

• メタデータが不変か、更新可能か
• URI がトークンごとか、テンプレート型か
• 画像や属性を IPFS に置くのか、それ以外に置くのか
• reveal や evolution が必要か

ここが変わると、ストレージ設計もコントラクトの表面積も変わります。

コードだけでなくトレードオフも聞く

より良いプロンプトの例:

Use nft-standards to propose two designs, compare ERC-721 and ERC-1155, then recommend one.

こうすることで、モデルが実装に踏み切る前に見落としやすい判断を表に出せます。混在型コレクション、ゲームアセット、dynamic NFT では特に有効です。

よくある失敗パターンを監視する

典型的な弱い出力には、次のようなものがあります。

• バッチ処理が多いのに、ERC-1155 より ERC-721 を使っている
• メタデータのホスティング前提を無視している
• ロイヤリティを常に強制可能なものとして扱っている
• ガス面のトレードオフ説明なしに enumerable 拡張を追加している
• エコシステム上の注意点を説明せず soulbound 制約を実装している

こうした兆候が見えたら、制約とトレードオフを明示したうえで設計を出し直させてください。

初稿のあとに1回だけ具体的に詰める

最初の回答を受けたら、やり直しよりも、狙いを絞った追加入力のほうが効果的です。

• “Optimize for gas over convenience.”
• “Keep marketplace compatibility high.”
• “Remove all optional features not needed for launch.”
• “Separate unique and semi-fungible assets into different contracts.”
• “Explain security risks around minting and metadata updates.”

多くの場合、最初から全部作り直すよりこちらのほうがうまくいきます。

リポジトリ固有の制約を渡してnft-standardsを改善する

実際にマージできるコードが欲しいなら、次も含めてください。

• Solidity version
• OpenZeppelin version
• upgradeable か non-upgradeable かの方針
• 既存のアクセス制御モデル
• テストフレームワーク
• デプロイ環境

nft-standards skill 自体にはリポジトリ文脈を読む機能がないため、こうした制約は利用側が与える必要があります。

nft-standardsを意思決定レイヤーとして使う

nft-standards の最も良い使い方は、コードを書く前にアセットモデル、メタデータ計画、トランスファーロジックを先に検証させることです。その判断が固まってから、2回目のプロンプトで実装可能なコードを作らせます。この2段階の進め方は、最初からフルのNFTコントラクトを一発で求めるより、一貫して良い Web3 の結果につながります。