Diagram Design skill
Agentga oddiy so'z bilan diagramma buyuring: 45 turdagi, brendingizga mos, bitta HTML + SVG fayl. Soyasiz, editorial uslub. MIT litsenziya.
Tezkor o'rnatish
npx skills add https://github.com/cathrynlavery/diagram-designTerminalda ishga tushiring. npx uchun Node.js kerak. Boshqa usullar quyidagi qo'llanmada.
Diagram Design nima
Diagram Design — agent skill bo'lib, diagrammalarni bitta mustaqil HTML fayl (ichida inline SVG) ko'rinishida chizadi. Jami 45 ta diagramma turi bor: architecture, flowchart, sequence, quadrant, Gantt, Sankey, Wardley map va boshqalar. Uslub editorial: soyalar yo'q, 1px chiziqlar, hamma koordinata 4px to'rda. Blog, hujjat yoki taqdimotga chop etiladigan diagramma kerak bo'lgan kishilarga mos. Litsenziya: MIT.
O'rnatish
| Usul | Buyruq | Natija |
|---|---|---|
| Ko'pchilik agentlar (Cursor, Claude Code, Codex, Qoder, Copilot, Gemini CLI, Cline, Windsurf, Amp) | npx skills add cathrynlavery/diagram-design |
Skill tanlangan agent papkalariga o'rnatiladi |
| Claude Code plagin | /plugin marketplace add cathrynlavery/diagram-design va /plugin install diagram-design@diagram-design |
Yangilanishlar va slash buyruqlar |
| Codex | codex plugin marketplace add cathrynlavery/diagram-design va codex plugin add diagram-design@diagram-design |
Codex plagini |
| GitHub Copilot | copilot plugin marketplace add cathrynlavery/diagram-design va copilot plugin install diagram-design@diagram-design |
Skill va qo'shimcha imkoniyatlar |
| Factory Droid | droid plugin marketplace add https://github.com/cathrynlavery/diagram-design va droid plugin install diagram-design@diagram-design --scope user |
Droid plagini |
| Pi | pi install https://github.com/cathrynlavery/diagram-design |
Skill; keyin /reload |
| Qoder | git clone qiling, so'ng qoder plugins validate ./diagram-design va qoder plugins install ./diagram-design |
Lokal plagin |
Qo'shimcha:
- Kiro uchun
https://github.com/cathrynlavery/diagram-design/tree/main/skills/diagram-designmanzilini import qiling. - OpenCode uchun
skills/diagram-design/papkasini.opencode/skills/diagram-designga ko'chiring yoki symlink qiling. - Uslub qo'llanmasini o'zingiz tahrirlamoqchi bo'lsangiz, repoyi klonlab lokal yo'lni o'rnating (editable install).
- Yangilash:
npx skills update diagram-design.
Ish jarayoni
- Agentga kerakli diagrammani oddiy so'z bilan ayting.
- Agent turini tanlaydi va rejasini aytadi.
- Bitta
.htmlfayl yoziladi. Uni ikki marta bosib brauzerda oching. - Kerak bo'lsa, agentdan o'zgartirishni qayta so'rang yoki SVG'ni tahrirlang.
Amaliy misol
README'dagi so'rov namunalari:
- "Make me an architecture diagram of my app: frontend, backend, database, Redis cache."
- "I need a quadrant showing Q2 projects by impact vs effort."
- "Give me a sequence of a bearer call with token refresh on 401."
Brendga moslash uchun:
- Agentga yozing: "Onboard diagram-design to https://yoursite.com".
- Agent saytdan palitra va shriftlarni oladi, ularni
paper,ink,muted,accent,linkrollariga bog'laydi. - U o'zgarishlar farqini (diff) ko'rsatadi. Siz "yes, apply it" deb tasdiqlaysiz.
- Tokenlar
references/style-guide.mdga yoziladi va keyingi barcha diagrammalar shu uslubda chiqadi.
Tokenlarni qo'lda ham o'zgartirsa bo'ladi: skills/diagram-design/references/style-guide.md jadvalini tahrirlang.
Muhim imkoniyatlar
- Import: Mermaid, draw.io, Excalidraw va PlantUML fayllarini qayta chizadi.
- Eksport: SVG yoki PNG ga eksport qilinadi.
- Standart palitra: jet-black + tangerine. Brend moslanmasa, shu ishlatiladi.
- Birinchi ishga tushirish: agar
style-guide.mdhali standart holatda bo'lsa, skill to'xtab so'raydi: onboarding, tokenlarni qo'lda kiritish yoki standartni qoldirish. - Kontrast tekshiruvi:
inkningpaperustidagi WCAG AA kontrasti tekshiriladi. Yetarli bo'lmasa, tuzatilgan qiymat taklif qilinadi. - Qulaylik: SVG'larda
role="img",<title>va<desc>bor. - Oflayn shriftlar: odatda Google Fonts'dan Instrument Serif, Geist va Geist Mono yuklanadi, bu yagona tarmoq so'rovi. system fonts so'ralsa, hech qanday tarmoq so'rovi bo'lmaydi.
- Slash buyruqlar:
/export-diagram,/import-mermaid,/import-plantuml,/profile,/doctor(native paketlarda; Pi'da/import-excalidrawham bor).npx skills addfaqat skill'ning o'zini o'rnatadi.
Cheklovlar va maslahatlar
- Natija sifati modelga bog'liq. Bir xil so'rov ikki marta turlicha joylashuv berishi mumkin.
- Chiqish tahrirlanadigan manba format emas: PR'da diff qilib bo'lmaydi va canvas'da qutini sudrab bo'lmaydi.
- Git'da yashaydigan, har sprintda o'zgaradigan hujjatlar uchun Mermaid qulayroq. Bu skill chop etiladigan diagramma uchun.
- Falsafa: "eng yaxshi harakat — o'chirish". Bir diagrammada taxminan 9 tadan ortiq tugun bo'lsa, uni ikkiga bo'ling. Accent rangi faqat 1–2 asosiy elementga ishlatiladi.
- Faqat ro'yxat yoki atribut taqqoslash uchun diagramma shart emas, jadval yetadi.
- Yangi loyihada brendni bir marta moslab, keyin profil sifatida saqlash mumkin (
references/profiles.md). - Rasmiy versiyalar faqat shu repodan keladi. Tarmoqqa nima yuborilishi
PRIVACY.mdda yozilgan.