Zyx Content Design

Plugin untuk membuat dan mereview konten visual Zyx. Satu repo menyimpan empat skill, satu design system bersama, 108 aset merek, komponen React, font, dan alat pemeriksaan.

Instalasi

Target distribusi plugin adalah Zyx Tools Marketplace. Langkah instalasi di bawah berlaku setelah repository sumber tersedia dan registrasi marketplace digabungkan.

Claude Code:

/plugin marketplace add soezyxstt/zyx-marketplace
/plugin install zyx-content-design@zyx-tools

Pada Codex, tambahkan marketplace GitHub soezyxstt/zyx-marketplace melalui pengaturan plugin, lalu pilih Zyx Content Design. Ketersediaan pengaturan bergantung pada versi host. Repo menyediakan katalog kompatibel dan manifest, bukan bukti instalasi pada perangkat Anda.

Tidak memerlukan server MCP, login tambahan, atau API key. Ini plugin berbasis skill dan file pendukung. Alat lokal memerlukan lingkungan Python dan Chromium.

Skill

Skill	Tugas
`zyx-content-pipeline`	Alur lengkap dari brief sampai hasil dan review
`zyx-content-brief`	Menyiapkan brief, sumber fakta, aset, dan caption
`zyx-visual-design`	Mendesain dari brief yang sudah disetujui
`zyx-design-review`	Memeriksa copy, layout, aset, dan hasil ekspor

Contoh permintaan: “Gunakan zyx-content-pipeline untuk membuat carousel dari brief ini.”

Cakupan: Instagram feed, carousel, story, poster, presentasi, dan dokumen A4. Sistem ini tidak menggantikan UI website atau pipeline authoring akademik Zyx.

Struktur dan sumber resmi

plugin.json                 Manifest Agent Plugins 1.0
.codex-plugin/plugin.json   Kompatibilitas Codex
.claude-plugin/plugin.json  Kompatibilitas Claude Code
skills/                     Empat alur kerja
references/                 Aturan aktif dan adapter platform
templates/                  Brief dan laporan review
design-system/              Snapshot asli, aset, token, font, komponen, tools
scripts/                    Adapter aset, render HTML, validasi, packaging
examples/                   Fixture carousel tiga slide
assets/                     Ikon plugin dari logo asli Zyx

Aturan aktif ada di references/design-rules.md. Detail visual ada di design-system/README.md. Riwayat kegagalan ada di design-system/lessons.md. Instruksi pengguna saat ini tetap didahulukan.

Repo ini menjadi sumber resmi untuk versi plugin ini. Snapshot awal berasal dari backup yang diberikan pengguna pada 23 Oktober 2026, versi artifact 25. Repo tidak melakukan sinkronisasi otomatis ke versi aktif Claude. design-system/upstream-lock.json mencatat checksum 203 file asli dan arsip sumber. File asli dipertahankan tanpa perubahan; aturan portable dan adapter baru berada di luar snapshot.

Render dan pemeriksaan lokal

python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python -m playwright install chromium
python scripts/validate.py
python scripts/render_html.py examples/carousel.html --out out/smoke
python scripts/check_negative.py
python scripts/package.py

Pada Linux yang belum memiliki library Chromium, gunakan python -m playwright install --with-deps chromium. Jika direktori cache default tidak writable, set PLAYWRIGHT_BROWSERS_PATH ke direktori writable untuk instalasi dan render.

Renderer melayani file repo melalui server loopback sementara, menunggu font dan gambar, mengambil satu PNG per .zx-canvas, dan menulis report.json. Periksa setiap PNG secara visual. Error, gambar gagal, atau runtime failure menghasilkan exit code 1. Warning carousel memerlukan review; perintah yang berhasil tidak otomatis menyetujui copy atau kualitas visual.

examples/carousel.html berisi copy sintetis untuk memverifikasi komponen, bukan brief kampanye. Mulai desain dari brief asli. Simpan pekerjaan di out/<project>/, sesuaikan URL resource relatif terhadap HTML, dan jangan commit output kerja.

Untuk .dc.html milik Claude Design canvas, gunakan renderer asli dalam design-system/tools/ dan baca references/platforms.md. Pemeriksaan ekspor editor berbeda dari screenshot Chromium.

Pemeliharaan dan rilis

Ubah instruksi pada skill terkait; simpan aturan bersama di references/design-rules.md.
Untuk update design system, impor snapshot baru, perbarui provenance dan checksum, lalu review perubahan token, aset, dan komponen. Jangan menimpa snapshot secara diam-diam.
Perbarui versi pada ketiga manifest dan CHANGELOG.md bersama. Pertahankan nama skill agar pemanggilan tetap stabil.
Jalankan validasi, render fixture, inspeksi PNG, negative integration check, dan packaging. CI menjalankan pemeriksaan yang sama dan menyimpan bukti render serta ZIP.
Setelah push ke main, pastikan CI berhasil. Perbarui katalog marketplace bila nama/source/ref plugin berubah. Host dapat memerlukan refresh atau reinstall untuk mengambil update.

ZIP self-contained tersedia setelah python scripts/package.py pada dist/zyx-content-design-<version>.zip. Archive mencakup resource bersama yang dibutuhkan skill, tanpa .git, output kerja, cache, atau kredensial.