beautiful-article
Beautiful Article превращает предоставленный материал в одну автономную HTML-статью, которую можно открыть без сети и переслать как готовый документ. Входом может быть URL, PDF, DOCX, Markdown, обычный текст, скриншот или вставленный материал. Цель навыка — не просто перенести текст в браузер, а повысить плотность информации, ясность визуального ритма, удобство проверки и возможность поделиться результатом. В статье могут быть таблицы, SVG, CSS, кодовые фрагменты, регулируемые элементы, кнопки копирования или экспорта и небольшие интерактивные блоки, если они помогают чтению, объяснению, аргументации или навигации по материалу. У workflow есть жёсткая граница: основной результат — single HTML article, а не web application. Raw-слой допускает HTML, CSS, JS, React, SVG и canvas, но он служит конкретному абзацу, доказательству, визуальному объяснению или ритму чтения. Навык не генерирует backend, forms, drag-and-drop workspace, полноценный dashboard, product prototype или общий Web App. Если пользователю нужна именно программа, а не статья, процесс останавливается для уточнения. По умолчанию сохраняется 100% информации и выбирается длинный формат; сокращение, перестановка и изменение тона допускаются только в рамках подтверждённой информационной плотности. Сначала Phase 0 Intake определяет, действительно ли нужен формат статьи, тип материала и язык. В Phase 1 источник приводится к source/source.md; для URL, PDF и DOCX можно использовать MarkItDown или предусмотренный fallback, а сомнения фиксируются в extraction-notes.md. Если язык не задан, итоговый текст следует языку исходника. Если пользователь указал другой язык, сначала создаётся естественная переводная версия source.<lang>.md, которая становится фактической базой следующих этапов; термины, числа, код, формулы и цитаты должны остаться точными. После извлечения основной агент делает пять inline-проверок и только сложный или низкоуверенный источник передаёт отдельному reviewer. Phase 2 — редакционное планирование без немедленной записи HTML. В единственном plan/plan.md фиксируются четыре блока: Brief с читателем, типом, долей сохранения, языком и целью чтения; Outline с Hero, Lead, Summary и разделами; Theme с выбранной темой и причиной выбора; Assets с политикой изображений и планом по каждой иллюстрации. Среди типов есть longform с примерно 100% сохранением, full-report, tutorial, explainer, dialogue, review, essay, interactive-explainer, briefing и visual-essay с разной стандартной плотностью. TOC по умолчанию включён, но остаётся изменяемым решением. Перед сборкой проходит Checkpoint 1, и пять независимых решений нельзя скрытно принять за пользователя: тип статьи вместе с процентом сохранения, тема, ширина narrow/regular/wide/full, режим изображений none/user-assets/placeholders/ai-generated и cover. Можно рекомендовать вариант, но работа ждёт отдельного подтверждения каждого пункта. Затем Phase 4 создаёт first spread — обложку, первый экран и представительный визуальный блок — и проходит второй checkpoint с отдельной проверкой приёмки и выбором режима разработки. Only after this comes Phase 5 Full Article Build; по умолчанию секции строятся одним агентом последовательно, а reviewer секции возвращает pass или fail без лишних файлов. Финальная часть состоит из трёх точек контроля. Phase 6 делает editorial, visual и technical review в final-review.md. Проверяются полнота и язык, соответствие выбранной теме, польза Raw-слоёв, читабельность, визуальная иерархия, автономность HTML и отсутствие технических дефектов. Phase 7 исправляет только найденные проблемы и пишет repair-log.md лишь если ремонт действительно был. Phase 8 доставляет article/article.html как основной offline-артефакт; PDF является опциональным результатом и создаётся только если это отдельно выбрано на финальном checkpoint. К deliverable добавляется краткое описание редакторских решений: тип статьи, информационная плотность, тема, изображения и существенные ограничения. Практические сценарии навыка — длинный briefing из исходной страницы, визуальный tutorial по PDF, объяснительная статья с таблицами и схемами или review, который должен быть одновременно читаемым и проверяемым. Ограничения тоже важны: Beautiful Article не придумывает фактический материал без источника, не должен превращать статью в dashboard и не может молча пропустить обязательное checkpoint-решение. Большая свобода Raw не отменяет семантических компонентов и theme tokens: визуальный эффект должен обслуживать текст, а не маскировать недостающие факты. Поэтому навык полезен, когда на выходе нужна законченная, переносимая и автономная статья, но не когда требуется постоянное приложение с серверной логикой или интерактивная рабочая среда.
Для чего подходит
- Создание HTML-статьи из URL
- Преобразование PDF, DOCX или Markdown
- Редакторская проверка структуры и оформления
Установка
Сначала прочитайте SKILL.md и scripts в исходном репозитории. Затем выполните команду в каталоге проекта:
npx skills add https://github.com/ConardLi/garden-skills/tree/main/skills/beautiful-article