前言¶
接手陌生仓库或做安全巡检时，往往要先弄清「目录怎么摆、关键文件在哪」。手工 tree、find 可以完成扫描，但交给 Agent 时，若没有统一步骤，容易漏目录、重复扫 node_modules，或把猜测当成结论。
下面介绍 SkillHub 社区技能「分析文件目录结构」（坐标 @user_19fd2d55/analysis-project-content）。它属于 it-ops-security 分类，发布者为 user_19fd2d55，当前版本 1.0.1，来源标注为 community，且 不需要 API Key（requires_api_key=false）。技能包遵循通用 SKILL.md 格式，安装后由 Agent 按技能内说明执行目录与项目内容相关的分析流程。
这是什么¶
「分析文件目录结构」是挂在 SkillHub 上的一条 Agent Skill，用于在对话式环境中规范「看目录、理结构」类任务。公开页面上未附带长文简介，但从技能名称与 slug analysis-project-content 可以确认：定位与项目文件目录结构及项目内容层面的梳理相关，而不是单一语言的代码补全或部署脚本。
维护与分发渠道为 SkillHub 技能页；元数据接口地址为 https://api.skillhub.cn/user_19fd2d55/analysis-project-content（浏览器直接访问可能非 GET 场景，以 SkillHub 页面为准）。
核心功能（以公开元数据为准）¶
已能核对的能力边界如下，不展开未在官方渠道出现的具体命令或检查清单：
- 目录结构分析导向：技能名与分类（
it-ops-security）表明，适用于运维、安全或接手项目时需要先建立「目录地图」的场景。 - 无额外密钥：标签标明
requires_api_key=false，安装后一般无需再配置第三方 API Key 即可按 SKILL.md 使用（若技能内引用本地 CLI，仍以 SKILL.md 为准）。 - 标准 Skill 包形态：与其它 SkillHub 技能一样，以
SKILL.md为入口，由 Agent 在匹配任务时加载说明并执行。
官方页面未公开完整 SKILL.md 正文；具体步骤、输出模板、是否包含忽略规则（如 node_modules）等，需在安装成功后阅读本地技能目录中的 SKILL.md。
安装与启用¶
SkillHub 推荐通过 安装说明文档 配置 CLI，并将包装到当前 Agent 的 skills 目录（否则默认落在 ./skills/，Agent 可能识别不到）。
1. 检查或安装 skillhub CLI¶
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（含默认 Skill）或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本技能¶
安装时必须用 --dir 指向当前环境的 skills 目录。SkillHub 文档给出的常见路径包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
示例（将目录换成你实际使用的 Agent 路径）：
skillhub install user_19fd2d55/analysis-project-content --dir ~/.cursor/skills/
SkillHub 技能页提供的「发给 AI 的安装提示」为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_19fd2d55/analysis-project-content`。
也可将上述提示直接交给 Cursor 等 Agent，由其按文档完成安装。
3. 安装后¶
按各 Agent 要求重启或重新加载 skills 后，在对话中提出与「分析某项目目录结构」相关的需求，Agent 应在命中技能描述时加载该 Skill。
注意：在部分环境中执行 skillhub install user_19fd2d55/analysis-project-content 时，若下载地址返回 HTTP 404，说明索引或包暂不可用，需先在 技能页 确认是否仍可下载，或联系 SkillHub / 发布者，避免文章中的命令与当时仓库状态不一致。
典型用法¶
公开资料未给出可复制粘贴的端到端对话示例。可复现的安装侧用法只有两类：
- CLI 安装（见上一节
skillhub install ... --dir ...）。 - 提示词安装：把技能页上的安装提示发给 Agent，并指明目标 skills 目录（例如 Cursor 使用
~/.cursor/skills/）。
业务侧典型用法应在安装后打开技能包内的 SKILL.md，按其中的触发条件与步骤操作；在未能成功下载包之前，不宜臆造「应先 tree 几层、再输出何种表格」等细节。
适用场景与注意¶
适合谁
- 需要 Agent 在接手仓库、巡检或文档化之前，先系统化查看目录与项目内容布局的开发者与运维 / 安全相关角色。
- 已使用 SkillHub 生态、希望在多 Agent 间用同一坐标复用技能的用户。
限制与注意
- 社区来源（
community）：质量与更新节奏依赖发布者user_19fd2d55，使用前建议阅读SKILL.md与版本号（当前 1.0.1）。 - 统计口径：SkillHub 抓取元数据显示评分 100000、下载 970、安装 2；页面展示可能随时间变化，以安装时 SkillHub 为准。
- 下载可用性：若 CLI 安装失败，应优先排查包是否下线，而不是反复更换未文档化的镜像地址。
- 范围：目录结构分析不能替代代码审计、依赖漏洞扫描或权限模型验证；技能若未写明安全检测项，不应默认具备这些能力。
结尾¶
「分析文件目录结构」把「看清项目目录与内容布局」收拢为一条可安装的 Agent Skill：坐标 @user_19fd2d55/analysis-project-content，版本 1.0.1，免 API Key，归类在 it-ops-security。先做 CLI 或提示词安装到正确的 skills 目录，再在本地 SKILL.md 中落实具体步骤，即可在 Cursor 等客户端中复用。
官方入口：https://www.skillhub.cn/skills/user_19fd2d55/analysis-project-content
