github-discover SKILL.md skillA

github-discover from joe-qai/qa-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add joe-qai/qa-skills/github-discover@git:20260905.15a2c36

Pins git:20260905.15a2c36 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
joe-qai/qa-skills
Path
github-discover/SKILL.md
Versions recorded
1
Latest version
git:20260905.15a2c36, committed Sep 5, 2026
Size
15,825 bytes
Repository stars
30
License
none declared

Use when the user wants to discover, search, clone, or deeply analyze open-source projects on GitHub — including trending repos, fuzzy keyword search, exact repository lookup, and technical framework extraction for learning purposes. Triggers on phrases like "搜一下GitHub热门项目", "看看有没有类似xxx的开源库", "帮我把这个项目clone下来研究", "这个项目用什么技术栈", "帮我调研一下XX领域的开源方案".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# GitHub Discover & Research

## 概述

这是一个 GitHub 开源项目发现与深度研究工具。支持四种模式:

1. **热门趋势发现** — 搜索当前热门/趋势开源项目(纯 API,无需 clone)
2. **模糊搜索** — 按关键词模糊查找相关仓库(纯 API,无需 clone)
3. **精确研究** — 先通过 API 获取元数据,分析 README 和topics;**仅当用户明确要求 clone 或需要读取源码时**才执行 clone,clone 完成后做技术拓印并生成报告,研究完成后提示用户是否保留本地副本
4. **每日热榜发现** — 自动挑选一个近期热门项目,完整走 clone → 分析 → 生成公众号/知乎长文 → 生成视觉卡片 → 输出到日期目录的流水线

所有操作均通过 GitHub REST API v3(无需 token 可匿名查询,建议配置 token 提升限频)。

**核心原则:Clone 是可选操作,只在用户明确要求或研究需要时才执行。研究完成后可清理沙箱。**

---

## 触发场景速查

| 用户意图 | 匹配关键词 | 推荐模式 |
|---------|-----------|---------|
| "看看最近热门的AI框架" | 热门、趋势、热门项目 | Mode A |
| "找一下Python爬虫框架" | 找找、看看有没有、推荐一个 | Mode B |
| "帮我调研一下这个项目" | 技术栈、依赖、框架、架构 | Mode C(API 分析,不 clone)|
| "把langchain clone 下来研究" | clone、拉下来、本地研究 | Mode C(需 clone)|
| "深入看看这个项目的源码" | 源码分析、看代码、深入分析 | Mode C(需 clone)|
| "今天的GitHub热榜项目是什么" | 每日热榜、今天热门、今日开源 | Mode D |
| "生成一篇公众号文章介绍这个项目" | 写篇文章、发公众号、生成推文 | Mode D |

---

## GitHub API 基础

### 端点与限频

```
无认证:60 次/小时
有 token:5000 次/小时
```

通过环境变量 `GITHUB_TOKEN` 或手动传入即可启用认证模式。

### 缓存策略

免费 token 限频严重,所有查询结果缓存至本地 JSON 文件:

```
<工作目录>/.github_cache/<query_hash>.json
```

缓存有效期 30 分钟;若缓存命中则直接读取,跳过 API 调用。

缓存脚本:见 `scripts/github_api.py`。

---

## Mode A:热门趋势发现
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add joe-qai/qa-skills/github-discover@sha256:e801644430a0e8f7

The line at the top of this page pins the label git:20260905.15a2c36, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_h6exp7iq4iadqgzq.svg)](https://markdownregistry.com/a/art_h6exp7iq4iadqgzq)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 5, 2026.

versioncommittedcommitsizeaudit
git:20260905.15a2c36 latest2026-09-05 15a2c36 15,825 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15825 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

joe-qai/qa-skills · 30 stars · license none declared · pushed 2026-09-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_h6exp7iq4iadqgzq
GET https://markdownregistry.com/api/v1/resolve?ref=joe-qai/qa-skills/github-discover
GET https://markdownregistry.com/api/v1/blob/e801644430a0e8f76c90f95160ee9906922f93abd5d227de17742decfdab7ed1

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from joe-qai/qa-skills

AGENTS.md AGENTS.md file
joe-qai/qa-skills · AGENTS.md
git:20260915.bc5a8d6 · audit A · 30 stars
CLAUDE.md CLAUDE.md file
joe-qai/qa-skills · CLAUDE.md
git:20260915.bc5a8d6 · audit B · 30 stars
agent-browser SKILL.md skill
joe-qai/qa-skills · agent-browser/SKILL.md · Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages…
git:20260325.34f3a7e · audit A · 30 stars
ai-agent-testing SKILL.md skill
joe-qai/qa-skills · ai-agent-testing/SKILL.md · Use this skill when you need to generate a concrete test suite for AI agent behavior, planning, tool usage, memory, and…
git:20260915.bc5a8d6 · audit A · 30 stars
browser-use SKILL.md skill
joe-qai/qa-skills · browser-use/SKILL.md · Direct browser control via CDP for web interaction: automation, scraping, testing, screenshots, and site/app work.
git:20260906.d616bee · audit A · 30 stars
capacity-planning-analysis SKILL.md skill
joe-qai/qa-skills · capacity-planning-analysis/SKILL.md · Use this skill when you need to produce a structured capacity planning report with load models, headroom analysis…
git:20260915.bc5a8d6 · audit A · 30 stars
darwin-skill SKILL.md skill
joe-qai/qa-skills · darwin-skill/SKILL.md · Darwin Skill (达尔文.skill): autonomous skill optimizer inspired by Karpathy's autoresearch. Evaluates SKILL.md files…
git:20260904.004eda6 · audit A · 30 stars
dev-environment-setup SKILL.md skill
joe-qai/qa-skills · dev-environment-setup/SKILL.md · 全栈开发环境配置器。用于检测、选择、安装各类开发运行时与性能测试工具,并为新项目生成脚手架代码。当用户提到"创建开发环境"、"初始化项目"、"设置开发栈"、"安装…
git:20260904.004eda6 · audit A · 30 stars
dialog-requirements-refiner SKILL.md skill
joe-qai/qa-skills · dialog-requirements-refiner/SKILL.md · 专业需求分析师,通过多轮对话将简短想法转化为详细需求文档。使用此技能当用户需要:(1) 分析和记录需求,(2) 将 EPIC 分解为需求和用户故事,(3) 对多个需求进行优先级排序,(4) 识别利益相关者和依赖关系,(5)…
git:20260915.bc5a8d6 · audit A · 30 stars
doc-based-testcase-generator SKILL.md skill
joe-qai/qa-skills · doc-based-testcase-generator/SKILL.md · 基于需求文档、PRD 或接口文档自动生成结构化测试用例文档。默认采用通用测试用例设计策略(正向、反向、边界值、等价类等);当用户提到参考 Excel/Word 模板时从 assets 加载模板,提到接口/性能/功能等专用标准时从…
git:20260915.bc5a8d6 · audit A · 30 stars
doc-coauthoring SKILL.md skill
joe-qai/qa-skills · doc-coauthoring/SKILL.md · Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation…
git:20260515.0de2506 · audit A · 30 stars
doc-requirements-extractor SKILL.md skill
joe-qai/qa-skills · doc-requirements-extractor/SKILL.md · 专业需求分析专家。当用户需要从Excel、PNG图片、TXT、PDF、Word等文档中提取需求时,必须使用本技能。擅长识别功能需求、非功能需求、业务规则、约束条件,输出包含需求依赖关系图和待确认问题清单的结构化文档。触发场景:分析需求、整理…
git:20260915.bc5a8d6 · audit A · 30 stars

Every file in joe-qai/qa-skills

Browse by kind, by grade A, or by owner.