feat(skill): delegate skill install to vercel-labs/skills ecosystem - #3
Merged
Conversation
Brainstorming output: replace self-built skill install (mysql-cli init / skill install + internal/agents + internal/skillscheck + bundle.go + scripts/install-skills.sh) with delegation to the vercel-labs/skills ecosystem via `npx skills add AllenMuu/mysql-cli`. mysql-cli stops self-building install/TUI; skill becomes a repo-side asset consumed by the 75+-agent skills ecosystem.
11-task plan: delete init/skill subcommands + agents/skillscheck/bundle packages + install-skills.sh; add .well-known/agent-skills/index.json; migrate README/README-zh/AGENTS/CHANGELOG to npx skills add; final verification (build/vet/test/cover/skill-format-check/npx install).
Drops mysql-cli init (agents-based install) and the skill subcommand group (list/version/check/install). Registration removed from root.go. agents/skillscheck/bundle now have no consumers and will be deleted in follow-up tasks. Skill install is delegated to npx skills add (see spec 2026-07-27-skill-install-npx-skills-design).
internal/agents (7-agent detect/install/merge) is obsolete after delegating skill install to npx skills add. No remaining consumers.
skillscheck compared installed skills against the binary-embedded version. With skills no longer embedded and install delegated to npx skills (which provides its own update/list), this package is obsolete.
//go:embed skills was the install source for mysql-cli skill install. With install delegated to npx skills add (source = GitHub repo), the embedded tree is dead weight. Skill version truth moves to repo skills/*/SKILL.md frontmatter.
Removes the shell-based installer (replaced by npx skills add). Drops the stale reference to mysql-cli skill version in version.go comment.
Declares the 3 mysql-cli skills for vercel-labs/skills' preferred discovery mechanism. Hints that all three should be installed together (mysql-query/schema reference ../mysql-shared/SKILL.md).
Replaces mysql-cli init / skill install / install-skills.sh references with npx skills add AllenMuu/mysql-cli. Notes the all-three install requirement and the no-Node manual-copy fallback.
Removes bundle/agents/skillscheck/install-skills.sh references. Documents npx skills add as the install path, .well-known discovery, all-three install requirement, and repo frontmatter as version truth.
…kflow - Remove installer tests step (script deleted in 8294163) - Remove install-skills.sh and install-skills-test.sh from push/pull_request paths - Add trailing newline to .well-known/agent-skills/index.json
AllenMuu
added a commit
that referenced
this pull request
Jul 27, 2026
Commands table still listed `init` and `skill <sub>` after PR #3 removed those subcommands. Task 7 missed them (grep for 'mysql-cli skill' didn't match the bare 'skill <sub>' table row).
AllenMuu
added a commit
that referenced
this pull request
Jul 27, 2026
…lease) PR #3 (skill install migration to npx skills) is a user-facing breaking change. Bump all three skills to 2.0.0 to align with the project's next major release. Previous: shared 1.2.1, query 1.1.1, schema 1.0.1.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
把 mysql-cli 自研 skill 安装委托给 vercel-labs/skills 生态(
npx skills add AllenMuu/mysql-cli),删除所有自研 skill 安装代码。mysql-cli 二进制不再内嵌 skill / 不写安装 TUI,skill 成为仓库侧资产由通用 skills 包管理器管理(75+ agent)。Breaking Change
mysql-cli init、mysql-cli skill install/list/version/check及scripts/install-skills.sh全部移除。改用:无 Node 环境可手动复制仓库
skills/目录。skill 版本真相源从二进制内嵌迁移至仓库skills/*/SKILL.mdfrontmatter。详见 CHANGELOG。Changes
删除(-2151 行):
mysql-cli init命令 +mysql-cli skill子命令组internal/agents(7-agent 自研安装)、internal/skillscheck(版本同步)、bundle.go(//go:embed skills)scripts/install-skills.sh+ 自测 + CI 工作流引用ExitInitFailed清理 + version.go 注释新增:
.well-known/agent-skills/index.json(vercel-labs/skills 首选发现机制,声明 3 skill + 全装提示)文档:README / README-zh / AGENTS / CHANGELOG / dist npm README 全改
npx skills addWhy
调研飞书
larksuite/cli发现其 skill 安装完全委托通用 vercel-labs/skills 包管理器(不自研)。接入生态获得 75+ agent 支持 + 成熟交互式 TUI(multiselect agent / select scope / select install method / confirm),mysql-cli 不再维护自研安装逻辑。spec:
docs/superpowers/specs/2026-07-27-skill-install-npx-skills-design.mdplan:
docs/superpowers/plans/2026-07-27-skill-install-npx-skills.mdVerification
go build ./.../go vet ./...greengo test ./...190 passed in 11 packages./scripts/skill-format-check.sh skills/3/3 OKnpx skills add AllenMuu/mysql-cli --list列出 3 skill(mysql-shared/query/schema)mysql-cli skill install/init已移除(EXIT 10)mysql-cli init/mysql-cli skill/install-skills残留npx skills add AllenMuu/mysql-cli --skill '*' -a claude-code -y装到 ~/.claude/skills(reviewer 可验证)Notes
mysql-shared被 query/schema 引用(../mysql-shared/SKILL.md),vercel-labs/skills 不连带装被引用 skill,故文档强调"务必全装 3 skill"。init/skill落 REPL exit 10 而非 unknown command(pre-existing cobra 怪癖,非本次引入)。docs/research-lark-cli.md是调研历史记录,未改。