Skip to content

bestdeejay-design/agent-skills / skills/github-repo-hygiene

github-repo-hygiene

Verified

DEPRECATED meta-skill. Routes to the four focused repository skills that replaced it: repo-readme-assets (README + animated SVG header/footer), repo-community-files (LICENSE/CODE_OF_CONDUCT/CONTRIBUTING/SECURITY/SUPPORT/templates), repo-metadata-health (description/topics/GitHub Pages/community health/audit), repo-social-preview (og:image PNG). Load one of the four directly instead. Triggers: 'github hygiene', 'repo polish', 'github repo docs', 'оформить репозиторий', 'репозиторий готов к публикации'.

FileKindSize
README.mdmarkdown5.0 KB
SKILL.mdskill md2.9 KB
readme.ru.mdmarkdown1.1 KB
showcase.mdmarkdown4.7 KB
skill.jsonconfig1.2 KB

showcase.md

View on GitHub
# Showcase: github-repo-hygiene до / после

> Материал для каталогов и README библиотеки. Показывает, что скилл меняет
> в репозитории на практике.

## «До» — типичный репозиторий без скилла

```
README.md (153 строки устаревшего текста, без визуала)
LICENSE
(и всё)

Community Standards:  ►●○○○○  ~40%
- description: пусто
- topics: none
- social preview: нет
- issue/PR шаблонов: нет
- поиск Google → capsule-render URL-баннер → сервис закрылся → битая картинка
```

## «После» — репозиторий, прошедший скилл

```
README.md (актуальный, EN) + README.ru.md (зеркало заголовков 1:1)
assets/header.svg + assets/footer.svg   ← локальные анимированные SVG
LICENSE (MIT, распознаётся: spdx_id=mit)
CODE_OF_CONDUCT.md (Contributor Covenant 2.1, key=contributor_covenant)
CONTRIBUTING.md · SECURITY.md · SUPPORT.md
.github/ISSUE_TEMPLATE/*.yml + pull_request_template.md
.github/workflows/ci.yml + release.yml
CHANGELOG.md (Keep a Changelog)
description ≤ 350 симв., topics ≤ 20, homepage = GitHub Pages
social preview 1280×640, < 1 MB
релиз v1.0.0 + generate-notes

Community Standards:  ●●●●●●  100%
```

## Как выглядит «шапка»

Баннер генерируется в репозитории — **ноль внешних сервисов**:

```html
<p align="center">
  <a href="https://github.com/USERNAME" target="_blank">
    <img src="assets/header.svg" alt="header" />
  </a>
</p>
```

Локальный SVG (примерно так, в пикселях реального файла):

```
┌──────────────────────────────────────────────────────────────┐
│  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│  ~290px
│  ░░ PROJECT_NAME                               ░░        │  градиент
│  ░░ Short description of the project           ░░        │  COLD→WARM
│  ══≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈   │  волны
│  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░   │  «фон
└──────────────────────────────────────────────────────────────┘    наплывает»
```

Анимация (SMIL, работает в `<img>` на GitHub): переливающийся градиент,
«текущие» волны (морфинг d-path), блик-проход раз в ~16 секунд, плавное
появление текста. Футер — инверсия по вертикали, 60px, с мерцающим `@username`.

## Автоматика повторных прогонов

| Команда | Что даёт |
|---|---|
| `python3 scripts/generate_assets.py --name … --desc … --user … --cold #HEX --warm #HEX` | пере-генерация шапки/футера |
| `python3 scripts/extract_context.py` | авто-определение name/desc/стека/цветов для генератора |
| `python3 scripts/validate_svg.py assets/` | проверка SVG по правилам (CI-гейт) |
| `python3 scripts/validate_repo.py` | 16-пунктовый чек-лист, exit 0/1 (CI-гейт) |

Пример в `.github/workflows/repo-hygiene.yml` (в скилле: `examples/repo-hygiene.yml`)
превращает валидаторы в pre-merge check.

## Пресеты визуала

| Пресет | Когда |
|---|---|
| `default` | большинство проектов: анимированный градиент с волнами |
| `minimal` | документация, стабильные инструменты: статичный градиент |
| `dark-first` | тёмная тема GitHub по умолчанию: глубокий тёмный баннер |
| `monochrome` | книги/печать/спеки: ч/б без анимации |

Все пресеты — локальные файлы, без внешних зависимостей. Удалить баннер —
просто удалить `<p>`-обёртку из README.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall