Theme Builder для Gridea Pro

---

Что это такое

AI Agent Skill для сборки тем, предназначенный исключительно для Gridea Pro. После загрузки Skill в AI-клиент, поддерживающий спецификацию Skill (Claude Code / Claude Desktop / Cursor / Cline и др.), достаточно описать стиль и требования на естественном языке — AI сформирует полноценный каталог темы Gridea Pro, который можно сразу скопировать в папку themes/.

Встроенная поддержка трёх шаблонизаторов: Jinja2 (рекомендуется), Go Templates, EJS, а также полный справочник переменных, руководство по типичным ошибкам и скрипты рендер-тестирования.

Как использовать

1. Загрузите Skill — передайте каталог репозитория вашему AI-агенту (например, клонируйте в ~/.claude/skills/ или в корень проекта).

2. Дайте команду на естественном языке:

Сгенерируй с помощью gridea-theme-builder тему Jinja2 с названием "minimal-ink": минималистичный стиль, чёрно-чернильный с молочно-белым, поддержка тёмного режима.

3. Получите каталог темы — AI автоматически выполнит полный цикл scaffold → validate → render, передаст вам каталог темы, прошедший все тесты. Скопируйте его в themes/ Gridea Pro — и тема готова к работе.

Лучше работает в связке с дизайн-скиллом

Данный Skill отвечает только за «генерацию работающей темы» — эстетика не его конёк. Рекомендуемый рабочий процесс:

frontend-design → gridea-theme-builder → web-design-guidelines (визуальное направление) (реализация темы) (проверка a11y/адаптивности)

Часто используемые в связке скиллы: frontend-design, ui-ux-pro-max, brand-guidelines, web-design-guidelines, theme-factory (названия скиллов экосистемы Claude; для других агентов подберите аналоги).

Шаблоны промптов

Этап 1: с помощью frontend-design разработай визуальное направление для личного технического блога. Позиционирование: {хардкор / минимализм / уют} Референсы: {paulgraham.com / Ghost Casper} Результат: цветовая палитра (включая тёмный вариант), подбор шрифтов, эскизы главной и страницы статьи. Этап 2: с помощью gridea-theme-builder реализуй направление в виде Jinja2-темы "{name}". Тема должна пройти тесты validate и render. Извлеки дизайн-язык сайта {URL} и сгенерируй с помощью gridea-theme-builder Jinja2-тему "{name}". Требования: поддержка тёмного режима / основной текст на китайском — шрифт Source Han Serif / на главной — 10 анонсов + облако тегов / на странице статьи — прогресс-бар чтения и оглавление / в config.json — два настраиваемых параметра: основной цвет и шрифт. Перенеси Hugo-тему {URL} в Go Templates-тему Gridea Pro с названием "{name}". Обязательно замени имена переменных согласно references/template-variables.md, для CustomConfig используй доступ по индексу; тема должна пройти тесты validate и render. С помощью gridea-theme-builder создай минималистичную Jinja2-тему "{name}": белый фон, sans-serif, одна колонка без сайдбара, поддержка тёмного режима. После прохождения тестов передай каталог.

Структура каталога

. ├── SKILL.md # Точка входа Skill: 5-шаговый рабочий процесс + 16 ключевых правил ├── references/ # Справочник переменных, руководства по трём шаблонизаторам, архитектура, SEO, CSS-паттерны и др. ├── scripts/ │ ├── scaffold_theme.py # Генерация скаффолдинга │ ├── validate_syntax.py # Статическая проверка синтаксиса и имён переменных │ └── render_test.py # Рендеринг всех страниц на mock-данных └── assets/ ├── starters/ # Стартовые шаблоны для трёх шаблонизаторов └── mock-data.json # Тестовые фикстуры

CLAUDE.md — мета-файл с инструкциями, специфичными для Claude Code; пользователи других агентов и люди могут его игнорировать.

Окружение разработки

pip install -r requirements.txt # требуется только jinja2

Лицензия

GPL-3.0 — следует лицензии основного проекта Gridea Pro.