Przejdź do treści
Biblioteka skilli
Marketing i treści · Pisanie

github-repository-presentation

/github-repository-presentation

Pisze lub poprawia dwujęzyczne README, opis, tematy i zrzuty ekranu repozytorium GitHub według jednego szablonu.

Licencja
MIT
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
2
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (2). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Pisze lub poprawia dwujęzyczne README, opis, tematy i zrzuty ekranu repozytorium GitHub według jednego szablonu.

Oryginalny opis (EN)

为 GitHub 仓库按统一模板编写或优化中英双语 README、项目 Description、Topics、使用说明等公开解释性文字,规范真实功能截图与 GitHub Release Notes 的双语表达。当用户要求仓库首页、封面、功能截图、技术徽章、文案或展示质量时使用;不负责 Git 提交、版本事实判定或远端发布。

Jak działa

  1. 使命与边界
  2. 统一文字与视觉标准
  3. README 统一模板规范
  4. 其他解释性文字
  5. Release Notes 双语排版约束
  6. 完成前核对
Sekcje z nagłówków SKILL.md, w oryginale · 107 linii, 340 słów
Podgląd SKILL.md
---
name: github-repository-presentation
description: 为 GitHub 仓库按统一模板编写或优化中英双语 README、项目 Description、Topics、使用说明等公开解释性文字,规范真实功能截图与 GitHub Release Notes 的双语表达。当用户要求仓库首页、封面、功能截图、技术徽章、文案或展示质量时使用;不负责 Git 提交、版本事实判定或远端发布。
---

# GitHub 仓库呈现规范(统一双语模板)

## 使命与边界

为不同仓库应用**同一套 README 结构、视觉语言和中英双语写作规则**,得到高级、克制、清晰、准确的 GitHub 页面。根据项目事实填入内容,而不是按项目类型切换模板。

- 先按需读取真实 README、入口、依赖与配置、使用方式、许可证、相关图片和版本信息;不为写文案遍历整个仓库。
- 本 Skill 主导 README、Description、Topics、公开说明的结构与文字呈现;Release Notes 只规定表达模板与可读性,版本范围、变更事实、提交与发布操作由 `git-release-hygiene` 或实际任务证据决定。
- 在获准的文件范围内可修改文档;修改 GitHub 远端 About/Topics、推送或发布必须符合明确授权和实际权限。
- 不修改业务功能,不夸大能力,不虚构命令、链接、性能、许可证、截图、版本状态、验证经历或变更数量。

## 统一文字与视觉标准

1. **双语用两个文件,不在一个文件里逐段对照**:主 `README.md` 写英文(GitHub 默认展示),`README.zh.md` 写中文;两份都在顶部放指向对方的语言切换链接(如 `[中文](README.zh.md)` / `[English](README.md)`)。两份内容完整对应、各自可独立阅读,语序和章节顺序一致。技术名、命令、文件路径、代码和既有专有名词不强行翻译。代码块各自保留一份。
2. **单一视觉系统**:采用克制、现代、专业的技术项目气质。统一标题层级、图片宽度、徽章风格、段落节奏;默认避免无意义 Emoji、营销形容词、花哨分隔线及装饰性表格。
3. **具体胜于空泛**:说明项目做什么、适用于谁、如何开始、现有限制。避免“最强”“革命性”“全面支持”等无依据表达。
4. **事实分级**:实际文件和已确认行为优先;项目自述、未验证示例、计划功能与模型推断不得混写。未知事实标注或向用户确认;不把尚未运行的命令说成已验证。
5. **同一骨架、按需减法**:README 核心部分顺序固定。配置、目录结构、扩展说明等确实不适用时可省略,不能为凑齐章节制造内容。

## README 统一模板规范

按以下顺序组织;不另外设计 A/B/C 多套风格。

1. **顶部封面图(默认必备)**:README 的首个可见主体是一张横幅封面,建议约 `2:1`,宽度适配 GitHub。封面应以简洁图形、真实产品界面或准确抽象示意传达项目内容;少字或无字,避免虚构功能界面。图像需位于仓库可访问的稳定路径,具有与当前文件语言一致的 `alt`。
   - **缺少封面时**:先寻找现有可用素材;若没有,提出封面设计方案并请求提供素材或授权创建。未取得可用图片前不要写失效的 `src`,也不把占位图当成最终成品。可先交付其余 README 草稿并明确封面待补。
2. **项目身份**:居中的项目名与一句话定位;当前文件用哪种语言,定位就用哪种语言,不在一行里并列两种语言。短而准确,不叠加多个口号。
3. **可点击技术栈徽章**:紧接项目定位,优先展示约 3–8 项确实使用的核心技术或依赖平台;采用风格统一的 Badge,点击后指向对应官方文档或项目主页。无依据不得添加技术,不使用 `#` 假链接;非软件项目可使用实际相关的运行环境、数据格式或技术平台,不能强造“技术栈”。
4. **其他状态徽章(可选)**:仅在信息真实且有有效目标链接时展示 License、Release、CI、Docs、Demo 等;建议少量且一致,不为装饰而堆积。
5. **简短导航(可选)**:仅在 README 较长时添加 4–7 个真实可用的章节链接,核对 GitHub 实际锚点。
6. **简介 / Overview**:用一到两段说明项目是什么、解决什么问题、适用对象与主要价值;标题按当前文件语言书写。
7. **核心特性 / Features**:按用户可感知的能力列出精炼要点,只写已实现或明确标为实验性的功能,不把开发计划列为当前能力。
8. **安装 / Installation**:给出最短可信安装路径、必要前提、可复制命令。若不需要安装,明确说明获取与使用方式,而不是编造安装命令。
9. **使用方式 / Usage**:至少展示一个适用的最小操作示例、命令或实际 UI 流程;技术细节复杂时链接到已有文档,README 不变成完整手册。
10. **配置 / Configuration(按需)**:只列关键配置和重要环境变量;不得展示真实密钥,复杂配置链接到已有文档。
11. **项目结构 / Project Structure(按需)**:只呈现帮助首次理解的核心目录;不逐文件罗列。
12. **更新与发布 / Releases(按需)**:仅提供真实 Releases 或 Changelog 入口及必要状态,不在 README 内复制完整版本历史。
13. **许可证 / License**:如有真实许可证,准确说明并链接 LICENSE;如未声明,不推断为 MIT、Apache 或其他开源许可,必要时明确“尚未声明许可证 / No license specified”。

### 排版约定

一个主封面;`<h1>` 仅用于项目标题,章节用 `##`;居中只用于首页头部,正文左对齐;图片用仓库相对路径并适配窄屏;重要命令与链接必须可核对,不输出伪造徽章、无效锚点或占位符成品。

### 功能截图与操作说明

当真实界面、运行结果或操作流程比文字更容易解释功能时,可在对应章节配少量真实截图。截图用于补充理解,不替代可复制的命令、参数和步骤。

- **位置与数量**:优先在「使用方式 / Usage」放主界面或最小真实流程图;「核心特性 / Features」「配置 / Configuration」仅在确有理解收益时配图。主 README 默认配 **0–5 张功能截图**(不含顶部封面);只有复杂流程、多个核心界面或长文档确有需要时才增加,并逐张说明必要性。安装命令、License、目录结构等用文字或代码块已能清楚表达的内容不强行配图。
- **真实与授权**:优先使用仓库已有素材或经授权获取的真实运行截图;缺少素材时明确待补或不放,不伪造 UI、运行结果、数据、性能或功能状态。示意图必须明确标注,不得冒充真实界面或功能证据。
- **敏感信息**:公开前检查并清理令牌、账号、内部域名、隐私数据、密钥和本机敏感路径;无法安全清理时不使用该图。
- **文件与排版**:图片放在仓库内稳定、可公开访问的路径(如 `docs/images/`),使用有意义的小写 kebab-case 文件名和仓库相对路径。静态截图优先 PNG;短动画只在确实能解释流程时使用。保持原图比例,适配窄屏,不拉伸、不用失真的放大图。
- **双语与图注**:`README.md` 与 `README.zh.md` 可共用图片文件,但 `alt` 与图注按各自语言书写,准确说明图片对应的真实功能,不写营销口号。同一截图不重复使用,除非确有不同解释目的。

### README 固定结构示意

双语的骨架较长,已拆到 `references/readme-template.md`:真要落笔写 README 时再打开,
按槽位替换成真实值。只调整措辞、不改结构时不必读它。

## 其他解释性文字

- **Description**:使用一条精炼的中英双语介绍,优先保证准确和自然;遵守 GitHub 字符上限。若双语信息确实无法在限制内准确表达,向用户提出取舍而不是自行改成单语或截断。
- **Topics**:只使用真实领域、用途和生态关键词;遵守 GitHub 当前格式与数量约束。Topics 本质是检索标签,不要求硬译成中英两套。
- **补充文档**:写明适用语言,或同样提供两个文件互链;侧重读者真实操作,不重复 README 全文。
- **PR、Changelog、Release Notes**:使用完整中文版 + 完整英文版两个独立段落,不逐句对照;具体变更归属、Git 证据、版本判定与发布流程以 `git-release-hygiene` 为准。

## Release Notes 双语排版约束

**完整中文版在前,完整英文版在后,两个独立段落**:不逐句对照、不左右并列。GitHub 已有版本标题时正文不再重复大标题。

1. **结构**:`## 中文` 与 `## English` 各写完整一份,类别、条目数和事实完全一致。
2. **变更数量**:中文用 `新增/优化/修复`,英文用 `Added/Improved/Fixed`;计数单位是归并后、面向用户的变更事项,不是代码行数、文件数或 Commit 数。
3. **具体变化**:突出用户可感知变化,不贴实现细节、长日志或逐条 Commit;无相应变化的组直接省略。
4. **重要提醒**:不兼容变更、必要迁移、已知风险必须在两种语言里都写明;无证据时不得宣称“无破坏性变更”。
5. **事实不足**:版本范围、数量无法核实时标明待核实,不编造数字与日期,不把草稿说成已发布。

### Release Notes 固定结构示意

````markdown
## 中文
本次更新主要……。
**变更概览**:新增 X 项 · 优化 Y 项 · 修复 Z 项
**新增** / **优化** / **修复**(仅保留有内容的类别)
- 中文事项。
<!-- 必要时增加 **重要说明** -->

## English
This release focuses on ... .
**Summary**: Added X · Improved Y · Fixed Z
**Added** / **Improved** / **Fixed** (only non-empty groups)
- English item.
<!-- Add **Important Notes** only when needed -->
````

`X/Y/Z` 仅为槽位;最终只保留有变更且计数可核实的类别,版本与日期用已确认信息。

## 完成前核对

- README 是否从真实、可访问的项目封面开始?技术栈徽章是否真实且可点击?
- 是否沿用唯一固定骨架,且 `README.md` 与 `README.zh.md` 互链、内容完整对应、没有虚构或多余填充?
- 安装、使用、许可证、重要链接和视觉素材是否与工作区事实相符?未知项是否明确处理?
- 功能截图是否默认控制在 0–5 张,超出是否确有必要,且每张图都服务于明确章节,而不是装饰或重复?
- 截图是否真实、可访问、与当前版本一致,并已清理敏感信息?是否存在失效路径、伪造界面或未标注的示意图?
- 两份 README 的图片引用是否一致且有效,`alt` 与图注是否符合各自语言?命令、参数与操作步骤是否仍保留可复制文本?
- Description、Topics 与 README 是否保持一致?
- Release Notes、CHANGELOG 与 PR 描述是否为「完整中文段 + 完整英文段」,而不是逐句对照?数量是否真实、是否保留必要升级警示?
- 是否仅执行了本次授权的文件改动和远端操作?交付时是否准确说明未验证与未执行事项?
Pliki w paczce (2)
  • SKILL.md 11 KB
  • references/readme-template.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · HaoyanZhang123/control-your-skills100MIT
jaxhu1108/dsh-agent-team-presets100MIT

Migawka bazy z 13.11.2026 · wersja paczki 6af5bf9b5053 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100repo-cleaner
    Poprawia wizerunek repozytorium GitHub: README, banery, prawdziwe przykłady, odznaki, instrukcje instalacji, opis i podgląd w mediach społecznościowych.
  • 100github-repo-curator
    Porządkuje repozytoria GitHub pod profesjonalną prezentację i utrzymanie: szablony README, standardy dokumentacji, wzorce organizacji repozytorium i optymalizacja profilu.
  • 100write-readme
    Tworzy lub przepisuje dwujęzyczne README GitHub, sprawdzając funkcje, polecenia i linki według faktów z projektu.
  • 100repo-readme-optimizer
    Pisze lub audytuje README i wizytówkę repozytorium GitHub tak, by lepiej pozycjonowało się w Google i było cytowane przez asystentów AI.
  • 100release-notes
    Generuje notatki Markdown do najnowszego wydania repozytorium GitHub na podstawie podanego adresu owner/repo lub URL.
  • 100github-seo
    Sprawdza nazwę, opis, tematy i README otwartego repozytorium GitHub pod kątem wyszukiwania, przed publikacją i rejestracją w katalogach MCP.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.