核心理念
像 Obsidian 管理知识一样，管理你的技能
Obsidian 用三句话概括它的信念。Flint 把它们逐条搬到了技能管理上——只把打磨的对象，从知识换成技能。
本地即私有
技能只以普通文件存在你的本地磁盘，无云端、无账号、无上报。
开放格式，永不锁定
skill 本体就是磁盘上的 SKILL.md 目录，随时可打开、编辑、diff、用 git 提交；换工具、换生态，资产照常带走。
磨砺你的技能
收拢、去重、打标签，再一键投放到需要它的 Agent 与项目，让个人技能库越攒越趁手。
六大模块
一条「收拢 → 整理 → 投放」的主路径
界面上的六个模块，各管一件事。前四个串起来就是主路径，诊断和设置是兜底。
技能库
01浏览、搜索、过滤所有 skill，预览 SKILL.md、编辑标签、追溯来源；登记自有与第三方仓库，从任意目录批量导入。
智能体
02每个实际技能目录一张卡片。设为活跃、关联预设、逐个开关技能，甚至按单个技能切换软链还是复制。
预设
03一组 skill 套餐——显式成员加关联标签命中的技能。成员或标签一变，立刻分发到关联的活跃 Agent。
项目
04登记项目路径和标签，匹配的 skill 自动进入项目的 .agents 目录，可提交进 git、跨机器自包含，还能回写仓库。
诊断
05六个维度的体检——同步、重复、失效软链、配置、仓库、项目，问题集中列出，确认后一键修复。
设置
06默认安装方式（软链/复制）、复制模式的增量同步 watcher、自定义 Agent、日志查看。
为什么需要它
模型越强，skill 越不能散着
很多人说「模型变强了，skill 没用了」。对也不对：那些给模型能力补缺的通用 skill 确实会被吸收，但「复用性不高不低」的事永远存在——你的工作流、你的公司知识、你带真实 cookie 的浏览器，模型拿不到语料自主学会这些。
复用性的边界
太普世的 skill 早被模型吸收；真正值得固化的，是只有你（或你的团队）才知道的那部分——它就该像工具包里的扳手，而不是语言的默认特性。
切换 Agent 的成本
今天在 A 里写好的日报 skill，明天打开 B 用不了。npx 能装到现有 Agent，但一旦使用新 Agent、或想把自有 skill 纳入管理，就成了负担。
Token 与检索的开销
几百个 skill 全量安装，等于每次对话上万 token 的固定开销，还埋下模型选错或漏选的风险。精细管理，才能既省钱又选得准。
四条步骤跑通
第一次使用，四步就够
需要 Node.js ≥ 20。一条脚本启动，本地起前端与后端。
- 1
安装
仓库根目录执行 ./start.sh（或 npx flint-skills-hub），脚本自动检查环境、装依赖、打开浏览器。
- 2
登记仓库
仓库是 skill 的集合与事实源。自有仓库正常维护，第三方仓库作为只读来源登记，随时可导入收用。
- 3
新建预设
一个预设就是一份 skill 套餐——显式成员并上关联标签命中的技能。
- 4
应用到 Agent
在 Agent 详情页设为活跃、关联预设。此后成员或标签一变，已关联的活跃 Agent 立刻拿到这套 skill。
让你的每一块燧石，都能敲出火花
项目已开源。clone 下来执行 ./start.sh 就能跑起来体验，欢迎试用、提 issue、点个 star。
本文阐释了 Flint 的来历、理念与最小通路，也写给所有开始认真打理自己技能库的人。