SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场crypto-skill-creator

crypto-skill-creator

智能体与模型

查看项目

更新于 10-16 07:07

技能介绍

用途

Crypto Skill Creator 是 CryptoSkills 目录的权威创建指南，用于指导开发者按照统一模式构建“增强型”加密协议 Agent 技能。当需要为目录贡献新的协议技能、理解目录结构，或让技能兼容各类 AI 编码代理时，可使用本技能。

CryptoSkills 遵循 agentskills.io 规范，技能与代理无关，可配合 Claude Code、Cursor、Cline、Codex 及任何兼容的 AI 编码代理使用。

主要能力

本技能纠正了关于技能结构的常见误解，并给出完整规范：

  • 一个增强型技能不是单个 markdown 文件，而是跨 5 个目录的 10 个以上文件：SKILL.md、4 个示例、docs、resources 和 starter template。仅 SKILL.md 就有 300–1500 行。
  • 必须使用带特定必填字段的 YAML frontmatter。分类和链需对照白名单校验，自由格式值无法通过验证。
  • 每个技能恰好 4 个示例，各自位于独立目录并含 README.md。每个代码块必须可直接复制粘贴并独立运行。
  • 章节顺序固定。“What You Probably Got Wrong”必须位于 Quick Start 之前。合约地址需要“Last verified”日期。该结构在 95+ 技能中强制执行以保持一致。
  • 技能必须注册到 .claude-plugin/marketplace.json（按字母顺序），并通过 validate-marketplace.ts 校验且 0 错误后才能合并。

技能结构

每个增强型技能生成如下结构：

skills/<protocol>/ ├── SKILL.md # 主技能（300-1500 行） ├── docs/ │ └── troubleshooting.md # 常见问题 + 调试清单（100-300 行） ├── examples/ │ ├── <use-case-1>/README.md # 4 个示例，每个 150-300 行 │ ├── <use-case-2>/README.md │ ├── <use-case-3>/README.md │ └── <use-case-4>/README.md ├── resources/ │ ├── contract-addresses.md # 多链地址表 │ └── error-codes.md # 错误参考与解决方案 └── templates/ └── <protocol>-client.ts # 起始模板（250-350 行）

总计：至少 10 个文件——1 个 SKILL.md、1 个 troubleshooting 文档、4 个示例、2 个资源、1 个模板。

使用方式

创建技能按以下步骤进行：

  1. 研究协议：获取官方文档、GitHub 仓库、合约 ABI 与部署地址，使用 cast code <address> 或区块浏览器验证链上地址，并阅读 1–2 个现有技能作为模式参考。
  2. 创建目录结构：使用 kebab-case 命名协议目录（无 web3- 前缀），示例目录描述用例，资源文件与模板文件按规范命名。
  3. 编写 SKILL.md：包含必填 YAML frontmatter（name、description、license、compatibility、metadata、tags），可选字段（allowed-tools、mcp-server），并严格按固定章节顺序撰写：标题、简介、What You Probably Got Wrong、Quick Start、核心概念/模式、合约地址、常见模式、错误处理、安全/最佳实践、技能结构、指南、参考。
  4. 编写示例：恰好 4 个，每个独立目录含 README.md，150–300 行，可独立运行。
  5. 编写文档：docs/troubleshooting.md 覆盖 5–8 个常见问题，含调试清单。
  6. 编写资源：resources/contract-addresses.md 与 resources/error-codes.md，按需添加 fee-tiers.md、reserve-config.md、service-urls.md、token-mints.md 等。
  7. 编写模板：templates/<protocol>-client.ts，250–350 行，包含配置、合约地址、ABI、客户端与核心函数。

适用场景

  • 为 CryptoSkills 目录构建新的协议技能。
  • 向目录贡献技能并确保通过校验。
  • 理解增强型技能的文件结构与规范。
  • 让技能兼容 Claude Code、Cursor、Cline、Codex 等 AI 编码代理。

限制

  • 分类与链必须使用白名单中的精确值，自由格式值无法通过验证。
  • SKILL.md 正文中不得出现 XML 尖括号（<tag>），以免与 Claude 系统提示解析冲突。
  • name 字段不得包含 claude 或 anthropic（保留命名空间）。
  • 技能根目录不得放置 README.md，只能使用 SKILL.md 作为规范入口。
  • 技能不得尝试覆盖代理行为或注入系统级指令。
  • 技能必须注册到 .claude-plugin/marketplace.json 并通过 validate-marketplace.ts 校验（0 错误）才能合并。
  • 关于收费、价格、平台或效果等具体信息，资料中暂未提供。