技能 read-github

📦

read-github

Name: read-github
Author: am-will

内容修订 r2 高风险 ⚙️ 外部命令🌐 网络访问

使用 GitMCP 阅读 GitHub 文档

在 AI 聊天中查看仓库文档可能很慢。此技能使用 GitMCP 获取文档、搜索文档并搜索代码。

支持: Claude Codex Code(CC)

⚠️ 38 差

安装前请停下并请求确认。

请审查安装计划，并在更改文件前获得用户明确同意。

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。

智能体请求

Review the Skillstore skill "read-github" from https://skillstore.io/skills/am-will-read-github.md and its manifest at https://skillstore.io/api/skills/am-will-read-github/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/am-will-read-github.md 已签名 manifest GET /api/skills/am-will-read-github/manifest 已签名 lockfile GET /api/skills/am-will-read-github/lockfile

测试它

正在使用“read-github”。 Read the docs for facebook/react and explain the main setup path.

预期结果:

简明的项目概览、设置摘要，以及指向最相关文档部分的提示。

正在使用“read-github”。 Search owner/repo for authentication configuration guidance.

预期结果:

匹配文档主题的简短列表，并用通俗语言说明每个相关结果。

正在使用“read-github”。 Find where a feature is documented and implemented in a repository.

预期结果:

结合文档和代码的摘要，列出可能的文件并解释该功能的关联方式。

安全审计

高风险

v5 • 2026/7/23 打开版本化报告

Two subprocess launches are confirmed high-risk because they use npx -y to download and execute unpinned mcp-remote; the Popen type annotation is safe. Active GitMCP URL construction is a low-risk intentional network boundary, while Markdown backticks, comments, and examples are false positives. Semantic review also found arbitrary endpoint acceptance and untrusted remote content reaching the agent without prompt-injection safeguards.

已扫描文件

381

分析行数

复核项

已忽略误报

已确认安全问题 (2)

高

scripts/gitmcp.py:15-32 scripts/gitmcp.py:203-209

Arbitrary MCP Endpoint Connection

Unrecognized repository input is returned unchanged and later passed to mcp-remote. A caller-supplied URL can therefore select an arbitrary MCP server.

The direct data flow from args.repo through convert_github_to_gitmcp into list_tools or call_tool is explicit, with no scheme or hostname allowlist.

高

SKILL.md:89-94 scripts/gitmcp.py:219-227 scripts/gitmcp.py:261-268

Untrusted Repository Content Reaches the Agent

Repository documentation and fetched URLs are printed without trust labeling or prompt-injection filtering. A repository author can embed instructions in agent-consumed content.

The workflow tells the agent to consume remote documentation, and the script emits remote text verbatim without separating data from instructions.

能力复核项 (3)

这些是真实的本地能力，对此技能可能是预期行为，因此需要复核，但不会按已确认恶意行为计分。

高

scripts/gitmcp.py:76

Python subprocess.Popen

proc = subprocess.Popen(

This call runs npx with -y, which can download and execute the unpinned mcp-remote package without confirmation. Fixed argument arrays prevent shell injection but do not remove the package supply-chain risk.

高

scripts/gitmcp.py:107

Python subprocess.Popen

proc = subprocess.Popen(

This second path also runs npx -y with an unpinned mcp-remote package. It silently permits downloaded package code to execute locally whenever a tool is called.

低

scripts/gitmcp.py:29

Hardcoded URL

return f"https://gitmcp.io/{parts[0]}/{parts[1]}"

This constructs the active gitmcp.io endpoint later passed to mcp-remote. The intended behavior sends repository identifiers and requests across a third-party network boundary.

审计者: codex 查看审计历史 →

分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告

复制报告链接

https://skillstore.io/skills/am-will-read-github/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/am-will-read-github/security.svg)](https://skillstore.io/skills/am-will-read-github?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/am-will-read-github?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/am-will-read-github/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/am-will-read-github.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

学术引用 (APA · BibTeX · CFF)

APA 引用

am-will. (2026). read-github security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/am-will-read-github/audits/5

BibTeX 引用

@techreport{am-will-am-will-read-github-2026,
  author = {am-will},
  title = {read-github security audit report (audit version 5)},
  institution = {Skillstore},
  year = {2026},
  number = {5},
  url = {https://skillstore.io/skills/am-will-read-github/audits/5},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "read-github security audit report (audit version 5)"
version: "unspecified"
type: report
authors:
  - name: "am-will"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/am-will-read-github/audits/5"
identifiers:
  - type: other
    value: "skillstore:am-will-read-github:audit:5"
    description: "Skillstore immutable audit report identifier"

Skillstore 评分

评分依据证据置信度: 中

架构

可维护性

内容

社区

规范符合性

你能构建什么

评估新库

在决定某个依赖是否适合项目之前，审阅仓库文档。

回答仓库相关问题

无需手动浏览文件即可查找设置步骤、功能和使用指南。

追踪 API 用法

在文档和代码中搜索函数、类或配置名称。

试试这些提示

总结仓库

阅读 owner/repo 的文档，并总结该项目的用途、使用人群以及主要设置步骤。

查找设置说明

搜索 owner/repo 的文档，并找出安装、配置和首次运行指南。包含你找到的任何版本要求。

比较文档和代码

获取 owner/repo 的文档，然后搜索代码中的主要 API 名称。说明文档是否与实现一致。

调查功能路径

在 owner/repo 中使用文档搜索和代码搜索来追踪某个命名功能的工作方式。报告关键文件、概念和未解问题。

最佳实践

先使用 fetch-docs，再进行更窄范围的搜索。
使用仓库文档中的具体搜索词。
在准确性很重要时，通过代码搜索确认关键答案。

避免

除非访问权限和数据处理方式清晰，否则不要将其用于私有仓库。
不要从仓库内容中获取无关的外部 URL。
不要在未检查主文档的情况下将搜索结果视为完整答案。

常见问题

此技能连接到什么？

它通过 mcp-remote 命令连接到 gitmcp.io MCP 服务。

它能像搜索文档一样搜索代码吗？

可以。该脚本包含文档搜索和精确代码搜索命令。

它需要网络访问权限吗？

需要。它需要网络访问权限，以访问 gitmcp.io、解析 npm 包以及获取远程仓库数据。

它适合用于私有仓库吗？

此技能未说明私有仓库身份验证或数据控制。

哪些助手可以使用此技能？

报告列出了对 Claude、Codex 和 Claude Code 的支持。

用户应该验证什么？

用户应验证仓库名称、搜索查询和获取的 URL 是否适合发送到 GitMCP。

开发者详情

作者

am-will

许可证

MIT

Skillstore 修订

版本提示

作者未声明版本。

仓库

https://github.com/am-will/codex-skills/tree/main/skills/read-github/

引用

89edfdc710d0846129dcee6a929477b04f08052c

维护新鲜度

2026/7/24

使用量

15 次下载 · 149 次浏览

文件结构

📁 scripts/

📄 gitmcp.py

📄 SKILL.md

am-will 的更多技能

查看全部

📦

role-creator

创建 Codex 自定义代理

自定义 Codex 代理需要精确的 TOML 文件和清晰的运行时设置。此技能可指导角色设计、编写配置，并验证必填字段。

编码与开发查看

📦

vercel-react-best-practices

优化 React 和 Next.js 应用

React 和 Next.js 应用常常受瀑布式请求、大体积 bundle 和无效渲染影响。此技能为智能体提供具体的 Vercel 性能规则，以实现更安全的重构。

编码与开发查看

📦

frontend-design

构建独具特色的前端界面

通用化界面会削弱产品清晰度和信任感。此技能指导 Claude、Codex 和 Claude Code 创建精致的前端页面，并具备明确的视觉方向。

设计与创意查看

📦

swarm-planner

规划并行智能体工作流

大型编码变更很难在多个智能体之间拆分而不出现依赖错误。此技能会创建具备依赖感知能力的实施计划，其中包含研究、澄清、审查和并行执行分组。

编码与开发查看

📦

planner

规划分阶段实施工作

当范围、依赖项和验证步骤缺失时，复杂的编码工作可能会变得不清晰。此技能会创建包含冲刺、原子任务和验证检查点的分阶段计划。

效率查看

📦

parallel-task

运行并行开发计划

大型实现计划很难在多个代理之间协调。此技能会将 markdown 计划转换为面向 Claude、Codex 和 Claude Code 的依赖感知波次。

编码与开发查看

查看全部

📦

fusion-issue-authoring

Draft and Publish Clear GitHub Issues

由 equinor

Unclear issue requests create rework, duplicates, and weak acceptance criteria. This skill produces reviewed GitHub issues with consistent structure and controlled publishing.

效率查看

📦