In addition to the built-in official skills, StoreClaw supports custom skills added through local upload or a remote URL such as GitHub or ClawHub. This makes it possible to integrate private automation logic, industry-specific AI instructions, or proprietary toolchains into your workflow.

Available Methods

On the My Skills page, click Add My Skill in the upper-right corner. You can then choose one of the following methods:

Upload from Local Files

For local skills, upload a packaged file.

  • Supported formats: .zip
  • Required file: A .zip package must include a SKILL.md file.
  • Content requirement: The SKILL.md file must contain the skill name and description in YAML format.

Add from URL (GitHub or ClawHub)

You can also reference a package hosted in a remote repository.

  • ClawHub: Copy the link from the skill detail page, for example https://clawhub.ai/pskoett/self-improving-agent.

  • GitHub: Enter the exact URL of the skill directory.

    • Tip: The URL must point to the folder that contains the SKILL.md configuration file.
    • Example: https://github.com/org/skills/tree/main/skills/xxx

Configure and Enable the Skill

  1. Submit the source by uploading a local file or pasting a source link.
  2. The system validates the package automatically. StoreClaw parses the SKILL.md file. If the YAML format is invalid or required fields such as name or description are missing, the system returns an error.
  3. Find the skill in My Skills and make sure its switch is turned on.

  4. Use the skill:

    • Type / in the chat box to confirm that the skill has loaded successfully.
    • Or describe your request directly and let StoreClaw trigger the skill automatically based on the Description field.

Version Updates

  • Version sync: When the code in a Git repository is updated, it is recommended that you remove the skill from StoreClaw and add it again so the latest logic is loaded.

FAQ

Q: Why does the system say it cannot find SKILL.md?

A: Check the following:

  • File name: Make sure the file name is exactly SKILL.md, in uppercase.
  • Path accuracy: Confirm that the Git URL points to the deepest folder that contains the file.
  • Encoding: Only UTF-8 is supported. If the file is encoded in GBK, convert it to UTF-8 before pushing it.

Q: Can a third-party skill access sensitive data such as Shopify orders?

A: A skill must declare the permissions it requires. It can access specific platform data only if you have completed authorization in Connectors and the skill has been defined to use that data.

Q: How can I make StoreClaw match a skill more accurately?

A: Write the Description field clearly. Include the intended scenario, input requirements, and expected output.

  • Less effective: "A tool for analyzing Amazon."
  • Better: "Designed to analyze seasonal product trends and inventory risk for Amazon Europe marketplaces, including Germany, the UK, and France."

Q: Are skills from ClawHub safe to use?

A: Community-contributed skills go through an initial compliance review by StoreClaw, but when sensitive business workflows are involved, it is still best to review the source code yourself or prioritize official skills.

除了官方预设技能外，StoreClaw 支持通过本地上传或远程 URL（GitHub/ClawHub）接入自定义技能。这允许您将私有的自动化逻辑、特定行业的 AI 指令或专有工具链集成到运营流中。

接入方式

在 我的 Skill 页面点击右上角的 添加 Skill，您可以选择以下两种方式：

本地上传

对于本地技能，您可以将其打包上传。

  • 支持格式：.md, .zip, .skill
  • 必备文件：.zip 或 .skill 压缩包内必须包含一个 SKILL.md 文件。
  • 内容要求：SKILL.md 文件需包含以 YAML 格式编写的 Skill 名称和描述。

从 URL 添加 (GitHub 或 ClawHub)

您也可直接引用托管在远程仓库的代码包。

  • ClawHub：复制技能详情页的链接，例如 https://clawhub.ai/pskoett/self-improving-agent。

  • GitHub：输入指向技能目录的精确地址。

    • 提示：地址必须指向包含配置文件（SKILL.md）的文件夹。
    • 示例：https://github.com/org/skills/tree/main/skills/xxx

配置与启用流程

  1. 提交资源：选择上传本地文件或粘贴来源链接。
  2. 系统校验：StoreClaw 会自动解析 SKILL.md 文件。如果 YAML 格式错误或缺少核心字段（如名称/描述），系统将提示报错。
  3. 启用技能：在 我的 Skill 列表中找到该技能，确保其开关按钮处于开启状态。

  4. 调用技能：

    • 在对话框输入 / 确认该技能已成功加载。
    • 或直接描述需求，系统将根据技能的 Description (描述) 自动触发。

版本更新

  • 版本同步：当 Git 仓库中的代码更新后，建议在 StoreClaw 后台删除该技能并重新添加，以确保获取最新的代码逻辑。

常见问题 (FAQ)

Q：为什么系统提示“找不到 SKILL.md 文件”？

A： 请按照以下三点进行排查：

  • 文件名校验：确保文件名为 SKILL.md (注意全大写)。
  • 路径准确性：确认 Git 地址指向的是包含该文件的最内层文件夹。
  • 编码格式：仅支持 UTF-8 编码。如果您的文件是 GBK 格式，请在编辑器中将其转换为 UTF-8 后再推送。

Q：第三方技能能否访问我的敏感数据 (如 Shopify 订单)？

A： 技能必须在定义中声明所需权限。只有当您在 连接器 中完成了授权，且该技能被声明为需要读取特定平台数据时，它才具备分析权限。

Q：如何让 StoreClaw 更准确地匹配技能？

A： 在编写技能的 Description 时，请尽可能写清楚适用场景、输入要求和输出目标。

  • 欠佳：“分析亚马逊的工具。”
  • 推荐：“专门用于分析 Amazon 欧洲站点 (德、英、法) 季节性选品趋势及库存风险预警。”

Q：ClawHub 里的技能是安全的吗？

A： 社区贡献的技能均会经过 StoreClaw 的初步合规性检查，但在处理敏感业务时，建议您先查看其源代码逻辑或优先选择官方技能。