安装你的第一个开源 Skill：从找到、安装到真正用起来

先看这篇文章能帮你解决什么

如果你刚接触 Qoder，看到别人说“装个 Skill，AI 就会更专业”，但又不知道该从哪里找、怎么装、装完怎么用，这篇文章就是写给你的。

读完后，你会掌握 4 件事：

  1. Skill 到底是什么，它为什么能让 AI 更“懂行”
  2. 去哪里找开源 Skill
  3. 如何在 Qoder 中安装你的第一个 Skill
  4. 常用 npx skills 命令怎么用
  5. 一个真实场景：让 AI 按最佳实践帮你制作产品宣传视频

整篇内容尽量用白话来讲，遇到命令和专业词，也会顺手解释，方便你直接照着操作。

一、先弄明白：Skill 是什么？

你可以把 Skill 理解成 AI 的“专长插件”或“经验包”。

默认情况下，AI 虽然很聪明，但它不一定知道某个领域最好的工作流程。
比如：

  • 做视频时，AI 可能会给你一堆零散方案
  • 做前端页面时，AI 可能能写代码，但不一定符合团队规范
  • 做产品分析时，AI 可能会输出内容，但结构不稳定

而安装了对应的 Skill 后，AI 会更像一个“受过专项训练的助手”：

  • 知道这个任务通常该怎么拆解
  • 知道应该优先使用哪些工具和方法
  • 知道这个领域常见的坑和最佳实践

一个更直观的理解

  • AI 模型：像一个很聪明、知识面很广的人
  • Skill：像给这个人发了一套行业 SOP（标准操作流程）、模板和经验手册

这样它做事就不只是“能做”，而是更接近“专业地做”。

二、安装前准备：你需要先有这些环境

在正式安装 Skill 之前，先确认本机具备基本环境。

1. 安装 Node.js

因为后面会用到 npm 和 npx。

  • Node.js：一个常用的 JavaScript 运行环境
  • npm：Node.js 自带的包管理工具，用来安装命令行工具和依赖
  • npx：可以直接运行 npm 包里的命令，不一定要先全局安装

你可以在终端里执行下面两条命令检查是否已安装：

node -v
npm -v

如果能看到版本号，说明环境没问题。

三、去哪里找 Skill？

目前可以重点关注两个入口。

1. skills.sh

地址：https://skills.sh

这是目前比较流行的开放 Skill 市场，能找到不少热门 Skill，比如：

  • Remotion：偏视频生成、程序化视频制作
  • from-design：偏前端页面生成、设计稿转代码等方向

如果你是第一次接触 Skill，建议先从这里逛起，比较容易快速找到现成能力。

2. Qoder 官方 Skill 门户

这是 Qoder 官方的 Skill 门户，未来会提供：

  • 中英双语
  • 按角色分类浏览
    • 开发
    • 运营
    • 产品
    • AI 技术

如果你更偏向在 Qoder 生态内使用 Skill，这会是后续很重要的入口。

四、先安装 Qoder CLI

要在命令行里使用 Qoder，先安装 Qoder 的命令行工具。

npm install -g @qoder-ai/qodercli

这条命令是什么意思？

  • npm install：用 npm 安装一个包
  • -g：表示全局安装
  • @qoder-ai/qodercli：Qoder 的命令行工具包名

安装完成后，你就可以在终端里使用 qodercli 相关命令了。

五、安装你的第一个 Skill

基本命令

安装 Skill 最常见的命令是：

npx skills add <source>

如果你想从一个 Skill 仓库里只安装某一个具体 Skill，可以加上 --skill 参数：

npx skills add <source> --skill <skill-name>

例如：

npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practices

这里的两个参数分别是什么？

  • <source>：Skill 来源
    可以是：

    • GitHub 仓库简写
    • 完整 GitHub URL
    • GitLab URL
    • 本地路径

  • <skill-name>：要安装的具体 Skill 名称
    因为一个仓库里，可能不止一个 Skill。

六、安装时你会看到哪些选项？

运行安装命令后，CLI 一般会进入交互式流程。你通常会依次看到下面几类选择。

1. 选择要安装的 Skill

如果一个仓库里有多个 Skill，系统会先让你勾选。

常见操作方式：

  • 空格：勾选
  • a：全选
  • 回车：确认

2. 选择安装到哪个 AI 助手

例如：

  • Qoder
  • Claude Code
  • Cursor

具体支持哪些助手，以你本地 CLI 实际显示为准。

3. 选择安装级别：Global 还是 Project

这是很多人第一次会犹豫的地方。

Global（用户级）

安装位置通常是：

~/.qoder/skills/

适合：

  • 你自己长期使用
  • 不依赖某个具体项目
  • 想在所有项目里都能用
Project（项目级）

安装位置通常是：

<项目根目录>/.qoder/skills/

适合：

  • 某个项目必须使用特定 Skill
  • 团队希望统一工作方式
  • 想把 Skill 配置和项目一起管理

4. 选择安装方式：Symlink 还是 Copy

这一步也值得理解一下。

Symlink（符号链接）

“符号链接”可以理解成一个“快捷方式”。

它不会真的复制一份文件，而是让目标位置指向原始文件。

优点：

  • 节省空间
  • 原始 Skill 更新后，通常更容易同步

适合：

  • 本地开发
  • 想方便更新和调试
Copy（复制）

会把 Skill 文件直接复制一份到安装目录。

优点：

  • 更独立
  • 不依赖原始位置
  • 对某些协作或分发场景更稳

适合：

  • 希望保留固定副本
  • 不想受源目录变化影响

简单记：
Symlink 更灵活，Copy 更稳定。

七、npx skills 常用命令速查表

下面这张表，适合收藏起来随时查。

指令 说明 使用示例
npx skills add <source> 从远程仓库或本地路径安装 Skill 包。支持 GitHub 简写、完整 URL、GitLab URL 或本地路径。 npx skills add vercel-labs/agent-skills
npx skills add https://github.com/someone/my-skills
npx skills add ./my-local-skills
npx skills add vercel-labs/agent-skills -a claude-code -g -y
npx skills list 查看已安装的 Skill。 npx skills list
npx skills list -g
npx skills list -a claude-code
npx skills remove <skill> 卸载指定 Skill。 npx skills remove frontend-design
npx skills update 更新已安装的 Skill 到最新版本。 npx skills update
npx skills check 检查是否有可更新的 Skill。 npx skills check
npx skills find [keyword] 搜索可用 Skill。支持交互式搜索或关键词搜索。 npx skills find
npx skills find typescript
npx skills find "react testing"
npx skills init [name] 在当前目录或指定目录创建一个新的 Skill 模板。 npx skills init
npx skills init my-new-skill

八、常见参数解释：看懂命令不再靠猜

-a, --agent <name>

指定安装到哪个 AI 助手。

例如：

npx skills add vercel-labs/agent-skills -a claude-code

-s, --skill <name>

指定安装某个具体 Skill，而不是整个仓库里全部 Skill。

例如：

npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practices

-g, --global

全局安装，也就是安装到用户目录，而不是当前项目目录。

-y, --yes

跳过确认提示，适合自动化场景，比如 CI/CD。

CI/CD：持续集成 / 持续交付。
简单说，就是把安装、测试、部署这些步骤交给自动化流程去完成。

九、一次典型的安装流程，实际会发生什么？

当你运行：

npx skills add <source>

CLI 一般会按下面顺序引导你：

  1. 选择 Skill

    • 从 Skill 包里挑选你要装的具体能力

  2. 选择 AI 助手

    • 例如 Qoder、Claude Code、Cursor

  3. 选择安装范围

    • Project：项目级
    • Global：全局级

  4. 选择安装方式

    • Symlink：符号链接
    • Copy：复制副本

这个流程看起来有几步，但实际并不复杂。第一次装完后，你对整个机制就会很清楚。

十、实战场景：用 Skill 让 AI 帮你制作产品宣传视频

下面用一个非常典型的场景，看看 Skill 的价值到底体现在哪里。

场景背景

你是运营或产品同学，想快速做一个产品宣传视频，最好最后能拿到一个可下载的视频文件。

但你本人：

  • 不懂专业视频软件
  • 不会写复杂动画
  • 也不想只得到一堆零散素材

这时，Skill 的作用就出来了。

十一、如果没有 Skill，AI 往往会怎么“跑偏”？

没有合适 Skill 时，AI 常见的输出可能是：

  1. 建议你用某个 Python 视频库
  2. 给你一份纯 HTML 动画方案
  3. 只帮你生成文案、图片素材或脚本片段

这些方案并不一定错，但它们可能都不是你真正想要的结果。
你的目标是：一条完整、可渲染、可交付的视频。

这就是 Skill 的意义：它帮 AI 理解“这个任务最终应该交付什么”。

十二、操作步骤：安装 Remotion 相关 Skill

第一步：安装 Skill

你可以这样安装：

npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practices

如果你已经知道某个简写命令可用，也可以按实际仓库说明来执行。

注意：
不同仓库里的 Skill 名称可能略有差异，例如 remotion-best-practice 和 remotion-best-practices。
请以仓库中实际列出的 Skill 名称为准。

在交互安装时，通常可以选择：

  • 助手：Qoder
  • 安装范围：Global
  • 安装方式：Copy

如果你更希望长期自己使用，这样选很合适。

$ npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practices

███████╗██╗  ██╗██╗██╗     ██╗     ███████╗
██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝
███████╗█████╔╝ ██║██║     ██║     ███████╗
╚════██║██╔═██╗ ██║██║     ██║     ╚════██║
███████║██║  ██╗██║███████╗███████╗███████║
╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝

┌   skills
│
◇  Source: https://github.com/remotion-dev/skills.git
│
◇  Repository cloned
│
◇  Found 1 skill
│
●  Selected 1 skill: remotion-best-practices
│
◇  54 agents
│
●  Installing to: Qoder
│
◇  Installation scope
│  Global
│
◇  Installation method
│  Copy to all agents

│
◇  Installation Summary ───────────────────────────────────╮
│                                                          │
│  ~/.agents/skills/remotion-best-practices                │
│    copy → Qoder, Amp, Antigravity, Cline, Codex +9 more  │
│                                                          │
├──────────────────────────────────────────────────────────╯
│
◇  Security Risk Assessments ─────────────────────────────────────────────╮
│                                                                         │
│                           Gen               Socket            Snyk      │
│  remotion-best-practices  Safe              0 alerts          Med Risk  │
│                                                                         │
│  Details: https://skills.sh/remotion-dev/skills                         │
│                                                                         │
├─────────────────────────────────────────────────────────────────────────╯
│
◇  Proceed with installation?
│  Yes
│
◇  Installation complete

│
◇  Installed 1 skill ────────────────────────────╮
│                                                │
│  ✓ remotion-best-practices (copied)            │
│    → ~/.qoder/skills/remotion-best-practices   │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│    → ~/.agents/skills/remotion-best-practices  │
│                                                │
├────────────────────────────────────────────────╯

│
└  Done!  Review skills before use; they run with full agent permissions.

十三、在 Qoder 中发起任务

安装完成后，你可以进入 Qoder 的 Quest 模式。

方式 1：先启动 Quest，再输入任务

qodercli /quest

然后输入你的需求，例如：

帮我为可口可乐制作一个中文宣传视频，请先访问官网了解产品特性。

方式 2：直接创建 Quest 任务

qodercli quest create "帮我为可口可乐制作一个中文宣传视频，请先访问官网了解产品特性。"

在这里插入图片描述
在这里插入图片描述

十四、安装了 Skill 之后，AI 的执行方式会有什么变化？

装好对应 Skill 后，AI 通常不再是“随便给几个思路”，而是更可能按专业流程推进。

一个比较合理的执行链路通常是：

  1. 自动识别并加载 Remotion Skill
  2. 访问官网或相关资料
    • 先理解产品定位、卖点、视觉特征
  3. 按 Skill 的最佳实践搭建 Remotion 工程
    • 包括依赖、项目结构、脚本组织等
  4. 生成分镜或分页视频脚本
  5. 渲染输出最终视频文件

Remotion 是什么？

Remotion 是一个用代码生成视频的工具。
简单理解，它让你可以用前端/程序化方式制作视频，而不是完全依赖传统剪辑软件。

它特别适合：

  • 自动化生成宣传视频
  • 批量生成视频内容
  • 把品牌素材、文案、数据动态组合成视频

十五、后续你还可以怎么继续提需求？

有了 Skill 之后，你可以继续往下细化要求，例如：

  • “把配色调整得更接近官网主视觉”
  • “替换成官网 Logo”
  • “加入更强的 3D 动效”
  • “把语气改得更偏年轻化”
  • “生成适合社交平台传播的 15 秒版本”
  • “再输出一个横版和一个竖版”

也就是说，Skill 不只是帮你“启动任务”，更重要的是让后续迭代更顺畅。

十六、什么时候该选 Global，什么时候该选 Project？

这是最实用的经验之一。

适合选 Global 的情况

如果你符合下面任意一种，优先选 Global：

  • 这是你个人常用的 Skill
  • 你希望多个项目都能复用
  • 你正在试用和摸索，不想绑定某个仓库

适合选 Project 的情况

如果你符合下面任意一种，优先选 Project：

  • 这个 Skill 是某个项目工作流的一部分
  • 团队成员都要按同样方式工作
  • 你希望 Skill 跟项目一起被版本管理

一句话总结：

  • 个人长期使用，选 Global
  • 团队项目规范，选 Project

十七、给新手的 3 个使用建议

1. 第一次先装一个最贴近任务的 Skill

不要一上来装很多。
先围绕一个明确目标，比如“做视频”、“写前端”、“做测试”，装一个最相关的 Skill，就够了。

2. 先用交互模式，再考虑命令参数

新手建议先直接执行：

npx skills add <source>

跟着提示一步步选。
等你熟了，再用 -a、-g、-y 这些参数加快流程。

3. 如果一个仓库里有多个 Skill，优先读名称和说明

不要只看仓库名。
真正决定效果的，往往是里面具体的 Skill 名称和用途说明。

十八、最后总结：把 Skill 理解成 AI 的“行业经验包”

如果只记住一句话，那就是：

Skill 的本质，是把某个领域的最佳实践提前交给 AI。

所以它的价值，不只是“多装一个插件”，而是：

  • 让 AI 更懂任务目标
  • 让输出更贴近专业流程
  • 让结果更容易落地交付

对于 Qoder 用户来说，一个最自然的上手路径是：

  1. 去 skills.sh 找到合适的 Skill
  2. 安装 Qoder CLI
  3. 用 npx skills add 装上第一个 Skill
  4. 在 Quest 模式里直接给出真实任务
  5. 观察 AI 是否比“裸跑”时更稳、更专业

如果你是第一次尝试，最推荐从一个实际需求开始——
比如“做一个宣传视频”，或者“为当前项目补一个前端开发 Skill”。
一旦你体验过 Skill 带来的差异，就会很容易理解它为什么会成为 AI 工作流里越来越重要的一环。

Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

Blender家具模型下载｜9000+个室内家居资产库下载和资产库导入教程 Blender家具模型下载、Blender资产库、Blender室内模型、Blender家居模型、

avatar AtomGit开源社区
cover

AI Agent实现CODESYS自动化编程

avatar AtomGit开源社区
cover

【Linux网络编程】12. 多路转接 select

avatar AtomGit开源社区