用途：claude-osint 不是应用，而是 Claude 技能包，产物为 skills/offensive-osint/ 与 skills/osint-methodology/ 下的两个 SKILL.md，以及 offensive-osint/scripts/ 下的两个可运行 Python 辅助脚本。没有 GUI、服务器或 TUI，“运行”指 SKILL.md 的 frontmatter 能被解析且完整，并让辅助脚本正常工作。
主要能力：驱动脚本 .claude/skills/run-claude-osint/smoke.sh 一次完成六项检查：编译两个辅助脚本；secret_scan.py 从 stdin 检测 AWS 密钥与 JWT；递归扫描 skills/ 并输出 JSONL（约 11 条示例令牌）；校验每个 SKILL.md 的 YAML frontmatter 含 name/description/version/triggers 且 triggers 不少于 5 个；sync-skill-content.sh --check 退出 0；h1_reference.py 拉取一条公开披露报告（离线非致命）。
使用方式：需 Python 3 与 PyYAML，缺失时 pip install pyyaml 或 apt-get install -y python3-yaml；辅助脚本其余仅用标准库，h1_reference.py 需访问 hackerone.com 的 HTTPS。在仓库根目录运行 .claude/skills/run-claude-osint/smoke.sh，加 --no-net 可跳过 HackerOne 实时检查。单独运行示例：printf 'AKIAIOSFODNN7EXAMPLE\n' | python3 skills/offensive-osint/scripts/secret_scan.py；python3 skills/offensive-osint/scripts/secret_scan.py skills/；python3 skills/offensive-osint/scripts/h1_reference.py --top-voted --limit 3；安装技能用 cp -r skills/* ~/.claude/skills/。
适用场景与限制：适合校验该技能仓库、扫描示例密钥、查询 HackerOne 公开报告。CI 含 markdownlint-cli2、frontmatter 检查、secret_scan 冒烟与 shellcheck，后两者未预装。sync-skill-content.sh 在全新克隆中是空操作，会提示源缺失并退出 0，属预期。secret_scan.py 会跳过 .git、node_modules、pycache、.venv、dist、build、.cache 及大于 10 MB 的文件。h1_reference.py 使用未公开的公开 GraphQL 端点，无需认证但受 HackerOne 变更与限流影响，失败视为环境问题，每页上限 50 条，可用 --pages N 扩大范围。该仓库无视觉界面。