技匠

[ ][行动] [ ][codecov] [ ][许可证] [ ][PkgGoDev]

[行动]： https://github.com/Songmu/skillsmith/actions?workflow=test [codecov]： https://codecov.io/gh/Songmu/skillsmith [许可证]：https://github.com/Songmu/skillsmith/blob/main/LICENSE [PkgGoDev]： https://pkg.go.dev/github.com/Songmu/skillsmith

用你的 Go CLI 一起交付嵌入式代理技能。

什么是技能匠？

skillsmith 是一个通过您的CLI工具分发代理技能的Go库。代理技能是一种开放格式，为AI代理提供新功能——可移植的指令集，适用于Claude Code、GitHub Copilot、OpenAI Codex及其他兼容代理。

通过 skillsmith，你可以用 embed.FS 将技能文件嵌入 Go 二进制文件中，并暴露一个 skills 子命令，允许用户在自己的机器上安装、更新和管理这些技能。这让你的 CLI 工具对 AI 代理友好，而无需引入完整的 CLI 框架。

剧情简介

这会为你的工具提供以下子命令：

特色

• Drop-in 集成 — 只需几行代码，就在现有的 CLI 中添加 skills 子命令
• 无CLI框架依赖 — 仅使用标准的flag包
• **'embed。

skillsmith

Ship embedded Agent Skills with your Go CLI.

What is skillsmith?

skillsmith is a Go library for distributing Agent Skills through your CLI tool. Agent Skills are an open format for giving AI agents new capabilities — portable instruction sets that work across Claude Code, GitHub Copilot, OpenAI Codex, and other compatible agents.

With skillsmith, you can embed skill files into your Go binary using embed.FS and expose a skills subcommand that lets users install, update, and manage those skills on their machine. This makes your CLI tool AI-agent-friendly without pulling in a full CLI framework.

Synopsis

//go:embed skills
var skillsFS embed.FS

func run(ctx context.Context, args []string) error {
    if len(args) > 0 && args[0] == "skills" {
        s, err := skillsmith.New("mytool", version, skillsFS)
        if err != nil {
            log.Fatal(err)
        }
        return s.Run(ctx, args[1:])
    }
    // ... existing command handling
    return nil
}

This gives your tool the following subcommands:

mytool skills list        # List embedded skills
mytool skills install     # Install skills to ~/.agents/skills
mytool skills update      # Update skills to newer versions
mytool skills reinstall   # Reinstall all managed skills
mytool skills uninstall   # Remove managed skills
mytool skills status      # Show install status and version diff

Features

• Drop-in integration — add a skills subcommand to your existing CLI with a few lines of code
• No CLI framework dependency — uses the standard flag package only
• embed.FS support — embed skill files in your binary; the skills/ prefix is auto-detected and stripped
• agentskills compliant — follows the open Agent Skills specification for SKILL.md format and directory structure
• Metadata tracking — writes .skillsmith.json alongside each installed skill for version-aware update and uninstall
• Semantic versioning — uses semver.Compare for version comparison; prevents accidental downgrades
• Lenient validation — warns on name mismatches; only skips skills with missing descriptions or unparseable YAML