Agent skill

github-readme-generator

Generate professional GitHub project README.md with standard structure including project intro, features, installation, usage, documentation, FAQ, contact info, donation, statistics, roadmap, and license. Auto-detects project type and tech stack.

Stars 192
Forks 34

Install this agent skill to your Project

npx add-skill https://github.com/wwwzhouhui/skills_collection/tree/main/github-readme-generator

SKILL.md

GitHub README Generator

专业的 GitHub 项目 README.md 生成器,自动生成符合开源社区规范的文档结构。

功能概述

这个 Skill 可以帮助你:

  • 📝 自动生成标准的 GitHub README.md 文档
  • 🎯 根据项目类型自动调整文档结构
  • 📊 生成项目统计和路线图
  • 🔗 自动生成 Star History 和 Badge
  • 📧 包含作者联系和打赏信息
  • ❓ 生成常见问题 FAQ
  • 📚 支持中英文双语

核心特性

标准文档结构

markdown
# 项目标题
项目简介/副标题

## 项目介绍
- 项目概述
- 核心功能
- 技术栈

## 功能清单
| 功能名称 | 说明 | 状态 |
|---------|------|------|

## 安装说明
### 环境要求
### 安装步骤

## 使用说明
### 快速开始
### 配置说明
### 使用示例

## 项目结构

技术栈

| 技术 | 版本 | 用途 |

文档地址

  • 飞书文档
  • 在线文档

开发指南

本地开发

构建部署

贡献指南

常见问题

技术交流群

欢迎加入技术交流群,分享你的 Skills 和使用心得:

e6ba3a5a-ae85-4826-8e35-82f52a68b845

作者联系

  • 微信: laohaibao2025
  • 邮箱: 75271002@qq.com

微信二维码

打赏

如果这个项目对你有帮助,欢迎请我喝杯咖啡 ☕

微信支付

微信支付

项目统计

代码统计

版本历史

路线图

计划功能

优化项

License

SPDX-License-Identifier: MIT

Star History

[Star History 图片]


## 使用方法

### 方式一:交互式生成

直接提出需求,系统会引导你提供必要信息:

请帮我的项目生成一个 README.md

需要提供的信息:

  1. 项目名称
  2. 项目简介
  3. 技术栈
  4. 核心功能
  5. 安装步骤
  6. 使用示例
  7. 作者信息
  8. 是否需要打赏信息

### 方式二:基于现有项目自动生成

请基于当前项目自动生成 README.md


系统会自动分析:
- 项目结构(目录、文件)
- 技术栈(package.json, go.mod, pom.xml 等)
- 构建脚本(Makefile, build.sh)
- 配置文件
- 现有文档

### 方式三:使用模板快速生成

请使用 [模板名称] 生成 README


可用模板:
- `basic` - 基础模板
- `full` - 完整模板(包含所有章节)
- `minimal` - 极简模板
- `library` - 库/SDK 专用模板
- `webapp` - Web 应用模板
- `cli` - CLI 工具模板
- `api` - API 服务模板

## 文档结构说明

### 必选章节

| 章节 | 说明 | 优先级 |
|------|------|--------|
| 项目标题 | 清晰的项目名称和副标题 | P0 |
| 项目简介 | 一句话描述项目核心价值 | P0 |
| 功能清单 | 表格形式列出主要功能 | P0 |
| 安装说明 | 环境要求和安装步骤 | P0 |
| 使用说明 | 快速开始和基本用法 | P0 |
| License | 开源协议声明 | P0 |

### 推荐章节

| 章节 | 说明 | 适用场景 |
|------|------|----------|
| 项目结构 | 目录树展示 | 中大型项目 |
| 技术栈 | 技术选型说明 | 所有项目 |
| 开发指南 | 本地开发、构建、贡献 | 开源项目 |
| 常见问题 | FAQ | 用户向项目 |
| 文档地址 | 外部文档链接 | 复杂项目 |

### 可选章节

| 章节 | 说明 | 适用场景 |
|------|------|----------|
| 作者联系 | 微信、邮箱 | 个人项目 |
| 技术交流群 | 群二维码 | 社区项目 |
| 打赏 | 收款码 | 个人开源 |
| 项目统计 | 代码量、版本历史 | 成熟项目 |
| 路线图 | 未来计划 | 活跃项目 |
| Star History | Star 趋势图 | GitHub 项目 |

## 内容规范

### 标题规范

[项目名称]

[一句话描述项目核心价值]

[可选:项目图标/Logo]

[可选:项目标语/Slogan]


### 功能清单表格规范

```markdown
## 功能清单

| 功能名称 | 功能说明 | 技术栈 | 更新时间 | 版本 |
|---------|---------|--------|----------|------|
| 功能1 | 说明 | Go | 2025-01-23 | v1.0.0 |
| 功能2 | 说明 | Vue | 2025-01-23 | v1.0.0 |

安装说明规范

markdown
## 安装说明

### 环境要求

- Node.js 16+
- Python 3.8+
- Go 1.19+

### 安装步骤

```bash
# 克隆项目
git clone https://github.com/user/repo.git

# 安装依赖
npm install

# 配置
cp .env.example .env

# 启动
npm run dev

### 常见问题规范

```markdown
## 常见问题

<details>
<summary>安装失败怎么办?</summary>

1. 检查网络连接
2. 尝试使用国内镜像
3. 清理缓存后重新安装

</details>

<details>
<summary>如何配置 xxx?</summary>

详细配置说明...

</details>

项目类型适配

Web 应用项目

特有章节:

  • 在线演示地址
  • 技术架构图
  • API 文档链接
  • 部署说明

库/SDK 项目

特有章节:

  • 快速引入(npm install、go get 等)
  • API 文档
  • 示例代码
  • 更新日志

CLI 工具项目

特有章节:

  • 安装方式(Homebrew、Cargo、npm 等)
  • 命令行参数
  • 使用示例(命令行输出)
  • 配置文件说明

API 服务项目

特有章节:

  • API 端点列表
  • 认证方式
  • 请求/响应示例
  • SDK 链接

高级功能

自动识别项目信息

系统能自动识别:

  • 项目类型(Web/CLI/Library/API)
  • 主要编程语言
  • 构建工具
  • 包管理器
  • 测试框架
  • 代码规范工具

生成 Badge

自动生成项目 Badge:

markdown
![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Version](https://img.shields.io/badge/version-v1.0.0-green.svg)
![Stars](https://img.shields.io/github/stars/user/repo.svg)

生成 Star History

markdown
## Star History

如果觉得项目不错,欢迎点个 Star ⭐

[![Star History Chart](https://api.star-history.com/svg?repos=user/repo&type=Date)]

输出示例

基础模板输出

markdown
# My Project

一个简洁的项目描述

## 功能清单

| 功能 | 说明 |
|------|------|
| 功能A | xxx |
| 功能B | xxx |

## 安装

\`\`\`bash
npm install
\`\`\`

## 使用

\`\`\`javascript
import { MyProject } from 'my-project'

const app = new MyProject()
app.run()
\`\`\`

## License

MIT

完整模板输出

包含所有推荐和可选章节的完整文档。

模板文件

templates/basic.md

基础项目模板,包含核心章节

templates/full.md

完整项目模板,包含所有章节

templates/library.md

库/SDK 专用模板

templates/webapp.md

Web 应用专用模板

templates/cli.md

CLI 工具专用模板

templates/api.md

API 服务专用模板

示例项目

查看 examples/ 目录获取不同类型项目的 README 示例:

  • examples/basic-readme.md - 基础示例
  • examples/full-readme.md - 完整示例
  • examples/library-readme.md - 库示例
  • examples/webapp-readme.md - Web 应用示例

最佳实践

README 撰写原则

  1. 简洁优先: 第一屏展示核心信息
  2. 图文并茂: 适当使用截图和架构图
  3. 代码高亮: 所有代码块标注语言
  4. 版本信息: 明确最低版本要求
  5. 更新及时: 随项目更新同步维护

图片规范

  • 使用图床或 GitHub 仓库存储
  • 图片大小 < 500KB
  • 推荐 PNG/JPG 格式
  • 添加 alt 文本

链接规范

  • 使用相对路径链接内部文档
  • 使用绝对路径链接外部资源
  • 重要链接添加 Badge

故障排查

常见问题

Q: 生成的 README 中文乱码 A: 确保文件使用 UTF-8 编码保存

Q: 表格显示不正常 A: 检查表格对齐,确保每行列数一致

Q: 图片无法显示 A: 确认图片 URL 可访问,使用 HTTPS

Q: 目录链接跳转失败 A: 确保锚点名称与标题一致,空格替换为 -

版本历史

  • v1.0.0 (2025-01-23) - 初始版本,支持基础模板生成

Expand your agent's capabilities with these related and highly-rated skills.

wwwzhouhui/skills_collection

obsidian-search

根据用户的自然语言检索需求,生成合适的 Obsidian CLI 查询命令,执行查询,并将结果总结返回。用于用户想在 Obsidian 仓库中搜索笔记、查找上下文、筛选任务、标签、属性、反链、文件列表或结构化查询时,例如“帮我找最近的会议记录”“搜一下包含某关键词的笔记”“看看某篇笔记有哪些反向链接”。

192 34
Explore
wwwzhouhui/skills_collection

xiaohuihui-dify-tech-article

专为Dify工作流案例分享设计的公众号文章生成器,遵循小灰灰公众号写作规范,自动生成包含前言、工作流制作、总结的完整Dify案例文章,配有详细的节点配置、插件安装步骤、代码示例,并支持自动生成图片上传到腾讯云COS图床

192 34
Explore
wwwzhouhui/skills_collection

dify-dsl-generator

专业的 Dify 工作流 DSL/YML 文件生成器,根据用户业务需求自动生成完整的 Dify 工作流配置文件,支持各种节点类型和复杂工作流逻辑

192 34
Explore
wwwzhouhui/skills_collection

wechat-article-fetcher

获取并解析微信公众号文章。从微信文章链接中提取标题、作者、公众号名称、正文内容、图片和元数据。当用户提供微信文章链接(mp.weixin.qq.com/s/...)并希望阅读、提取、下载或转换文章内容时使用。适用场景包括获取/下载微信文章、提取微信文章文字或元数据、将微信文章转换为Markdown、将微信文章连同图片保存到本地。关键词:微信公众号、文章获取、文章抓取、文章下载。

192 34
Explore
wwwzhouhui/skills_collection

wechat-compliance-reviewer

审查微信公众号文章内容并识别违规风险点。使用场景:当用户写完公众号文章后请求审查、检查是否违规、发布前合规检查、识别诱导分享/欺诈信息/营销推广/版权侵权等违规内容时触发此技能。

192 34
Explore
wwwzhouhui/skills_collection

公众号封面生成器

根据主题和标题生成现代风格的公众号封面图,使用jimeng-mcp-server生成3D插画风格底图,叠加文字层生成HTML,并可选择性转换为高质量PNG/JPG图片

192 34
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results