# Fmcp Project Rules > F-MCP Bridge kullanım kuralları — Design Token Kuralı, Bağlı Token Kuralı, kütüphane yönetimi, otomatik yanıt kuralları. Tüm F-MCP skill'leri için geçerli temel kurallar. Her Figma işleminde bu kurallar otomatik olarak geçerlidir. - **Type:** Skill - **Install:** `agentstack add skill-atezer-fmcp-fmcp-project-rules` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [atezer](https://agentstack.voostack.com/s/atezer) - **Installs:** 0 - **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [atezer](https://github.com/atezer) - **Source:** https://github.com/atezer/FMCP/tree/main/skills/fmcp-project-rules - **Website:** https://www.npmjs.com/package/@atezer/figma-mcp-bridge ## Install ```sh agentstack add skill-atezer-fmcp-fmcp-project-rules ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # F-MCP Temel Kurallar Bu skill, tüm F-MCP skill'leri ve komutları için geçerli olan temel kuralları tanımlar. Her Figma işleminde bu kurallar otomatik olarak uygulanır. ## Kullanıcı İstekleri — Otomatik Yanıt ### "F-MCP'yi güncelle" / "update" / "güncelle" Terminal komutu verme. `bash scripts/update.sh` çalıştır, sonucu bildir: > Güncelleme tamamlandı (vX.Y.Z). Claude'u yeniden başlat ve Figma'da plugin'i kapat-aç. ### "F-MCP'yi kur" / "setup" / "kur" / "bunu kur" / GitHub linki verildi Kullanıcı GitHub linki (github.com/atezer/FMCP) verip "kur" derse veya herhangi bir şekilde kurulum isterse: 1. Repo zaten clone edilmişse: `bash scripts/setup.sh` çalıştır 2. Repo clone edilmemişse: `git clone https://github.com/atezer/FMCP.git && cd FMCP && bash scripts/setup.sh` 3. Kullanıcıya sadece sonucu bildir. Kullanıcıya ASLA terminal komutu söyleme, teknik adım açıklama. Her şeyi sen yap. ### Dil Kullanıcı Türkçe konuşuyor. Tüm dosyalarda Türkçe karakterler (ş, ç, ğ, ö, ü, ı, İ) doğru kullanılmalı. --- ## Design System Kütüphaneleri Kullanıcı lokal olarak design system kütüphaneleri kaydedebilir. Kayıtlı kütüphaneler `.claude/libraries/` dizininde bulunur. ### Kullanım kuralları 1. **Skill çalıştırmadan önce** `.claude/libraries/` dizinini kontrol et. Kayıtlı kütüphane varsa oku. 2. **Varsayılan kütüphane:** Kullanıcı "hangi kütüphane?" demişse veya context'ten anlaşılamıyorsa, kayıtlı kütüphanelerden ilkini kullan. 3. **Figma file key'leri** kütüphane dosyasındaki tablolardan al — URL'den parse etme, doğrudan `File Key` alanını kullan. 4. **Token okuma** her zaman kütüphanenin WEB/ana dosyasından yapılır. 5. **Platform seçimi:** Web ekranı → WEB dosyası, Mobil ekran → Mobil dosyası (yoksa WEB fallback). --- ## Design Token Kuralı (TÜM skill'ler için geçerli — ZORUNLU) Hiçbir skill gömülü/hardcoded design token değeri içeremez ve kullanamaz. Font ailesi, renk kodu, font boyutu, spacing, radius, gölge — hiçbir tasarım değeri skill içine yazılmaz. **Her tasarım değeri çalışma anında tasarım sisteminden okunur:** 1. **Önce kayıtlı kütüphaneyi oku:** `.claude/libraries/` dizinindeki kütüphane dosyasını kontrol et. Font ailesi, variable collection'lar ve style listesi orada. 2. **Canlı değerleri Figma'dan al:** - **Kütüphane variable'ları (renkler, spacing)** → `figma_get_library_variables()` veya `figma_execute` ile `figma.teamLibrary.getAvailableLibraryVariableCollectionsAsync()` + `getVariablesInLibraryCollectionAsync()` — DS dosyasına bağlanmak GEREKMEZ, hedef dosyadan çalışır - **Lokal variable'lar** → `figma_get_variables()` — sadece dosya içi değerler - **Lokal stiller** → `figma_get_styles()` — sadece dosya içi stiller - **Kütüphane text style'ları** → cache'den key al, `figma.importStyleByKeyAsync(key)` ile import et. Cache yoksa REST API: `figma_rest_api GET /v1/files/{fileKey}/styles` - Font → kütüphane text style'larından veya kütüphanenin `Font Ailesi` alanından - Gölgeler → `figma_get_styles()` effect style'larından veya kütüphane cache'inden 3. **Bulunamazsa kullanıcıya sor.** 4. **Kullanıcı "sen seç" derse:** Önce DS kütüphanesi bağlıysa DS fontunu kullan (text style'lardan çıkar). DS fontu bulunamadıysa `Inter`, renkler için Figma varsayılanları kullan. **ÖNEMLİ:** `figma_get_styles()` ve `figma_get_variables()` sadece dosya İÇİ (local) değerleri döndürür. Team library'den gelen token'lar için `figma_get_library_variables` veya `figma.teamLibrary` API'si kullanılmalıdır. **Skill'lerdeki kod örnekleri:** Örneklerde geçen değerler (renk hex, font adı, piksel boyutu) yalnızca FORMAT gösterimidir. Çalışma anında bu değerler her zaman tasarım sisteminden okunmalıdır. --- ## Bağlı Token Kuralı (ZORUNLU — tüm ekran/bileşen oluşturma işlemlerinde) Figma'da oluşturulan hiçbir node'da **bağlanmamış (unbound) tasarım değeri** bulunmamalıdır. Her renk, spacing, padding, radius ve metin stili DS variable'ına veya text style'ına **bağlı (bound)** olmalıdır. - **Renk (fill/stroke):** `figma.variables.importVariableByKeyAsync(key)` ile import et, `setBoundVariableForPaint()` ile bağla - **Spacing/padding/radius/gap:** `setBoundVariable("paddingLeft", variable)` ile bağla - **Metin stili:** `setTextStyleIdAsync(styleId)` ile DS text style'ını uygula - **Metin rengi:** Text node fill'ini `setBoundVariableForPaint()` ile bağla **Hardcoded değer kabul edilmez.** `node.fills = [{ type: "SOLID", color: {r,g,b} }]` veya `node.fontSize = 16` gibi doğrudan değer atamaları YASAKTIR. Tüm değerler DS'ten import edilip bağlanmalıdır. Detaylı API kullanımı: `figma-canvas-ops` skill'inin **madde 10** bölümüne bak. --- ## Mevcut kütüphaneler Kayıtlı kütüphaneleri görmek için `.claude/libraries/` dizinini kontrol et. Her `.md` dosyası bir kütüphanedir. Kütüphane eklemek için `/add-library` komutunu kullan. ## Evolution Triggers - Yeni DS kural kategorisi eklendiğinde bu skill güncellenmelidir. - Yeni platform desteği (Flutter, React Native vb.) eklendiğinde platform seçimi kuralları genişletilmelidir. - Kullanıcı geri bildirimine göre otomatik yanıt kuralları güncellenmelidir. ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [atezer](https://github.com/atezer) - **Source:** [atezer/FMCP](https://github.com/atezer/FMCP) - **License:** MIT - **Homepage:** https://www.npmjs.com/package/@atezer/figma-mcp-bridge Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-atezer-fmcp-fmcp-project-rules - Seller: https://agentstack.voostack.com/s/atezer - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.