前言¶
概念说明、读书笔记、技术要点，常常要先「压成一页能扫完的结构」，再决定要不要写长文或做 PPT。纯 Markdown 笔记适合存档，却不一定适合手机屏上预览或截图发群；自己搭 HTML 版式又费时。下面介绍 SkillHub 上的社区 Skill「九天-知识卡片3.0」：在 Agent 对话里给出主题或素材，由 Skill 指导生成带版式的 HTML 知识卡片，浏览器打开即可预览或截图分享。
这是什么¶
九天-知识卡片3.0（坐标 @user_f842e6fc/jiutian-knowledge-card，当前版本 3.0.1）由社区发布者 user_f842e6fc 维护，在 SkillHub 分类为 knowledge-management，来源标注为 community。Skill 的定位是：将任意主题一键生成精美 HTML 知识卡片，并根据内容类型自动匹配版面风格；标签标明 requires_api_key=false，安装后无需额外配置 API Key。
官方 SkillHub 页：https://www.skillhub.cn/skills/user_f842e6fc/jiutian-knowledge-card
Skill 资源地址：https://api.skillhub.cn/user_f842e6fc/jiutian-knowledge-card
核心功能¶
六种版面模板¶
Skill 支持 6 种版面模板，名称与官方说明一致：
- 经典卡片
- 列表清单
- 左右双栏
- 信息图
- 时间线
- 对比表
生成时会 自动匹配内容类型与版面风格，无需在对话里手动指定每一种 CSS 细节。
视觉与交付形态¶
输出为单页 HTML，视觉为 暖白底 + 噪点纹理 的纸张质感，适配手机屏宽。完成后可在浏览器中直接预览，或截图后用于社群、文档附录等场景。
触发方式¶
官方简介强调触发方式灵活。页面与资料中明确提到的口语示例包括：「知识卡片」、「做张卡」、「来个速览」、「一页纸总结」、「帮我浓缩」 等；用自然语言表达「把某段内容做成卡片 / 速览 / 一页纸」一般即可唤起 Skill。具体匹配规则以安装后的 SKILL.md 为准。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。SkillHub 页面给出的安装提示为：根据官方安装文档安装坐标 @user_f842e6fc/jiutian-knowledge-card。
1. 检查或安装 SkillHub CLI¶
先确认本机是否已有 skillhub 命令：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；否则默认会装到 ./skills/，Agent 可能无法加载。官方文档列出的常见路径包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令示例（将 <skills 目录> 换成上面对应路径）：
skillhub install user_f842e6fc/jiutian-knowledge-card --dir <skills 目录>
也可在对话中把 SkillHub 页上的提示发给 Agent：「请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f842e6fc/jiutian-knowledge-card。」
安装完成后，按你所用客户端的要求 重启或刷新 Agent，使新 Skill 生效。
典型用法¶
官方页面未提供固定示例项目，但能力与触发方式足够复现下面流程。
- 确认 Skill 已装入当前 Agent 的 skills 目录并已启用。
- 在对话中给出 主题（例如某个技术概念）或 已有段落 / 大纲，并带上触发语，例如：「帮我把下面内容做成知识卡片，来个速览。」
- 按 Agent 与 Skill 的指引完成生成，得到 HTML 知识卡片 文件或可直接打开的页面。
- 用浏览器打开 HTML，检查版式（经典卡片、时间线、对比表等是否贴合内容）；需要对外分享时 截图 或发送 HTML 文件。
若内容更适合长文报告、专业数据图表或纯文本笔记归档，应换用其他工具或 Skill；本 Skill 的定位是 结构化、可扫读的一页卡片，而非通用报表或 BI 制图。
适用场景与注意¶
适合：
- 学习笔记、读书摘要、会议要点需要「一页纸」呈现时
- 要把概念对比、步骤清单、时间线等压成 移动端友好 的 HTML
- 团队内快速共享可视化要点，而不立刻投入排版或设计工具
注意：
- 版面由 Skill 根据内容 自动选择；若对某一种模板有硬性要求，需在对话里说明，并仍以 Agent 执行为准。
- 社区 Skill（community）的更新与维护依赖发布者；使用前可在 SkillHub 查看版本 3.0.1 与页面说明。截至资料抓取时，SkillHub 显示评分 100000、下载 1013 次（数据以 SkillHub 实时页面为准）。
- 不要求 API Key，但生成质量仍取决于底层模型与输入素材的完整度；输入越清晰，卡片结构越稳定。
结尾¶
九天-知识卡片3.0 把「总结 / 浓缩 + HTML 卡片」收进一条 Agent 工作流：六种模板、纸张质感与手机适配已在 Skill 说明中写明，安装坐标为 @user_f842e6fc/jiutian-knowledge-card。若你经常在对话里整理知识点并需要可分享的页面，可按上文步骤装入 SkillHub CLI 并安装到对应 skills 目录。详情与安装提示见 SkillHub 官方页：https://www.skillhub.cn/skills/user_f842e6fc/jiutian-knowledge-card
