mcpField
S
skill-forge-publish

skill-forge-publish

github.com/agricidanielAgent 工作流18636 次安装29 周前更新
代码仓库

关于 skill-forge-publish

面向 Claude skill 发布者的分发流程指南，涵盖发布前检查、打包、仓库配置和发布后验证，并整理多种分发渠道的要求。

主要功能

  1. 01发布前审查清单
  2. 02安装脚本编写指引
  3. 03仓库 README 结构
  4. 04Claude.ai 打包准备
  5. 05发布与后续检查清单

适用场景

  1. 01准备通过 GitHub 分发 skill
  2. 02为上传到 Claude.ai 打包 skill
  3. 03规划团队范围的 skill 部署

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/agricidaniel/skill-forge --skill skill-forge-publish

安装后在 Claude Code 中输入/skill-forge-publish确认已加载。

详细介绍

技能发布与分发

流程

步骤 1：发布前验证

发布前完成全面审查：

  1. 执行 /skill-forge review <path>，并确保评分 >= 80/100
  2. 修复所有严重或高优先级问题
  3. 使用至少 5 条触发查询进行测试
  4. 验证所有交叉引用均有效
步骤 2：创建安装脚本

生成 install.sh，用于处理：

#!/usr/bin/env bash
# Install script for [skill-name]
# Usage: bash install.sh

set -euo pipefail

SKILL_DIR="$HOME/.claude/skills"
AGENT_DIR="$HOME/.claude/agents"
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

echo "Installing [skill-name] skill..."

# Create directories
mkdir -p "$SKILL_DIR" "$AGENT_DIR"

# Copy main skill
cp -r "$SCRIPT_DIR/skill-name" "$SKILL_DIR/"
echo "  Installed: skill-name"

# Copy sub-skills
for skill in "$SCRIPT_DIR/skills"/skill-name-*/; do
    if [ -d "$skill" ]; then
        skill_basename=$(basename "$skill")
        cp -r "$skill" "$SKILL_DIR/"
        echo "  Installed: $skill_basename"
    fi
done

# Copy agents (if any)
if [ -d "$SCRIPT_DIR/agents" ]; then
    cp "$SCRIPT_DIR/agents"/*.md "$AGENT_DIR/" 2>/dev/null || true
    echo "  Installed agents"
fi

echo ""
echo "Installation complete!"
echo "Test with: /skill-name"
步骤 3：创建 README.md（仓库级，不要放在技能文件夹内）
# [Skill Name]

[1-2 sentence description focusing on outcomes, not features]

## What it does

[Bullet list of key capabilities]

## Installation

### Claude Code

git clone https://github.com/[user]/[repo] cd [repo] bash install.sh


### Claude.ai
1. Download the latest release (.zip)
2. Go to Settings > Capabilities > Skills
3. Click "Upload skill"
4. Select the downloaded .zip file

## Commands

| Command | Description |
|---------|-------------|
| `/skill-name` | [description] |
| `/skill-name cmd` | [description] |

## Examples

### [Example 1 title]

用户：“[example input]”

[Description of what happens and expected output]

## Architecture

[文件树示意图]


## License

[License type]
步骤 4：打包以供分发

上传到 Claude.ai： 运行 python scripts/package_skill.py <path> <output-dir>，创建 .skill zip 文件。

发布到 GitHub：

  1. 创建仓库，并在根目录放置 README.md
  2. 在根目录放置技能文件夹
  3. 在根目录放置 install.sh
  4. 添加 LICENSE 文件
  5. 添加 .gitignore（排除 .tmp/、pycache/、*.pyc）

团队部署（Claude.ai 管理员）：

  • 管理员可以在整个工作区部署技能
  • 将技能打包为 .skill zip，并通过管理控制台上传
步骤 5：创建 .gitignore
__pycache__/
*.pyc
*.pyo
.tmp/
*.egg-info/
dist/
build/
.env
*.skill
步骤 6：发布检查清单
  • 所有文件均已验证（评分 >= 80）
  • 已在干净的系统上测试 install.sh
  • README.md 涵盖安装、使用和示例
  • 已包含 LICENSE 文件
  • 已配置 .gitignore
  • 所有文件均不包含密钥或 API 密钥
  • 已记录测试查询
  • 已标记版本（如果使用 git）
步骤 7：发布后

发布后：

  1. 在干净的环境中从头测试安装
  2. 运行所有触发测试查询
  3. 收集初步用户反馈
  4. 根据反馈规划首次迭代
  5. 设置用于提交错误报告的问题模板

分发渠道

渠道最适用场景格式
GitHub开源、社区仓库 + install.sh
Claude.ai 上传个人使用.skill zip
团队管理员整个组织通过管理控制台上传 .skill zip
Claude Plugin Marketplace广泛分发.claude-plugin/ 清单

评论

支持 Markdown