@pedroab0/skills 1.0.1 → 1.2.0

package/README.md

@@ -7,7 +7,7 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT" /></a>
 </p>
 
-A curated collection of modular, production-ready skills developed for AI coding agents (such as Claude Code, OpenCode, Codex, Google Antigravity, and Cursor).
+A curated collection of modular, production-ready skills developed for AI coding agents (such as Claude Code, OpenCode, Codex, Google Antigravity, Cursor, and Kiro).
 
 Each skill in this repository is designed to give AI assistants specialized, autonomous capabilities while maintaining:
 - **Token Efficiency**: Pruning unnecessary data and noise to keep agent context windows lean and fast.
@@ -57,7 +57,7 @@ flowchart TD
 
 To extract specifications directly inside Figma Desktop without API tokens or rate limits, use the companion [**Figma Node JSON Extractor**](./figma-extractor/figma-plugin/README.md) plugin:
 * **Figma Community (Recommended)**: Install [**Figma Node JSON Extractor** on Figma Community](https://www.figma.com/community/plugin/1691244420692136789/figma-node-json-extractor) directly, or search for it under Figma Plugins.
-* **Manual Manifest Import (Local Backup)**: In Figma Desktop, go to **Plugins** $\rightarrow$ **Development** $\rightarrow$ **Import plugin from manifest...** and select `manifest.json` from your installed skills folder (e.g. `~/.claude/skills/figma-extractor/figma-plugin/manifest.json` or `~/.gemini/config/skills/figma-extractor/figma-plugin/manifest.json`).
+* **Manual Manifest Import (Local Backup)**: In Figma Desktop, go to **Plugins** $\rightarrow$ **Development** $\rightarrow$ **Import plugin from manifest...** and select `manifest.json` from your installed skill directory (`<skill-dir>/figma-plugin/manifest.json`).
 
 ---
 
@@ -75,7 +75,7 @@ npx github:pedroab0/skills
 
 The installer features a clean, interactive terminal UI:
 * **Navigate**: Use keyboard arrows (`↑` / `↓`) or vim keys (`k` / `j`) to move between options.
-* **Select**: Press `[Enter]` or press number keys (`1` - `5`) to select directly.
+* **Select**: Press `[Enter]` or press number keys (`1` - `6`) to select directly.
 * **Exit**: Press `[ESC]` or `q` at any time to cancel cleanly.
 
 ### Selection Options & Presets
@@ -91,6 +91,9 @@ Or specify flags for fast, non-interactive setup:
 # Install all skills for Claude Code globally
 npx @pedroab0/skills --agent claude --skill all
 
+# Install SDD skills for Kiro (IDE & CLI)
+npx @pedroab0/skills --agent kiro --skill sdd
+
 # Install SDD skills for Google Antigravity
 npx @pedroab0/skills --agent antigravity --skill figma-extractor,figma-node-builder
 
@@ -156,6 +159,19 @@ ln -s /path/to/skills/figma-node-builder ~/.gemini/config/skills/figma-node-buil
 
 ---
 
+### 5. Kiro
+
+Kiro discovers standard `SKILL.md` packages locally in `.kiro/skills/` or globally in `~/.kiro/skills/` (or `$KIRO_HOME/skills/`):
+```bash
+mkdir -p ~/.kiro/skills
+ln -s /path/to/skills/figma-to-code ~/.kiro/skills/figma-to-code
+ln -s /path/to/skills/figma-extractor ~/.kiro/skills/figma-extractor
+ln -s /path/to/skills/figma-node-builder ~/.kiro/skills/figma-node-builder
+```
+- **Activation**: Kiro loads matching skills automatically based on your prompt or explicitly via `/figma-extractor`, `/figma-node-builder`, and `/figma-to-code` in Kiro IDE chat or Kiro CLI.
+
+---
+
 ## Repository Structure
 
 ```text

package/bin/cli.js

@@ -4,7 +4,7 @@
  * Skills Installer CLI
  * https://github.com/pedroab0/skills
  *
- * Install curated AI agent skills for Claude Code, Cursor, Antigravity, and OpenCode.
+ * Install curated AI agent skills for Claude Code, Cursor, Antigravity, OpenCode, and Kiro.
  * Usage: npx @pedroab0/skills [options]
  */
 
@@ -41,7 +41,7 @@ const ui = {
 
 function printBanner() {
   ui.header(`Skills Installer ${style.dim('(by @pedroab0)')}`);
-  ui.item(style.dim('Curated AI Agent Skills for Claude Code, Antigravity, Cursor & OpenCode'));
+  ui.item(style.dim('Curated AI Agent Skills for Claude Code, Antigravity, Cursor, Kiro & OpenCode'));
   ui.item(style.dim('https://github.com/pedroab0/skills'));
   ui.bar();
 }
@@ -53,7 +53,7 @@ ${style.bold('Usage:')}
   (or: npx github:pedroab0/skills [options])
 
 ${style.bold('Options:')}
-  --agent <name>       Target agent: claude, antigravity, cursor, opencode, all
+  --agent <name>       Target agent: claude, antigravity, cursor, kiro, opencode, all
   --skill <name>       Skill to install (or comma-separated, or "all", "sdd")
   --global             Install globally (available across all projects on your machine)
   --local              Install in current project workspace only
@@ -65,6 +65,7 @@ ${style.bold('Options:')}
 ${style.bold('Examples:')}
   npx @pedroab0/skills
   npx @pedroab0/skills --agent claude --skill all
+  npx @pedroab0/skills --agent kiro --skill sdd
   npx @pedroab0/skills --agent antigravity --skill figma-extractor,figma-node-builder
   npx @pedroab0/skills --dest ~/.claude/skills --skill figma-to-code
 `);
@@ -111,6 +112,11 @@ function getAvailableSkills() {
 
 function getAgentConfigs(cwd) {
   const home = os.homedir();
+  const kiroHome = process.env.KIRO_HOME
+    ? process.env.KIRO_HOME.replace(/^~(?=$|[\\/])/, home)
+    : path.join(home, '.kiro');
+  const xdgConfig = process.env.XDG_CONFIG_HOME || path.join(home, '.config');
+
   return {
     claude: {
       name: 'Claude Code',
@@ -132,11 +138,17 @@ function getAgentConfigs(cwd) {
       isDetected: fs.existsSync(path.join(cwd, '.cursor')) || fs.existsSync(path.join(home, '.cursor')),
       isCursorRule: true,
     },
+    kiro: {
+      name: 'Kiro',
+      globalPath: path.join(kiroHome, 'skills'),
+      localPath: path.join(cwd, '.kiro', 'skills'),
+      isDetected: fs.existsSync(kiroHome) || fs.existsSync(path.join(cwd, '.kiro')),
+    },
     opencode: {
       name: 'OpenCode',
-      globalPath: path.join(home, '.config', 'opencode', 'skills'),
+      globalPath: path.join(xdgConfig, 'opencode', 'skills'),
       localPath: path.join(cwd, '.opencode', 'skills'),
-      isDetected: fs.existsSync(path.join(home, '.config', 'opencode')),
+      isDetected: fs.existsSync(path.join(xdgConfig, 'opencode')),
     },
   };
 }
@@ -370,23 +382,118 @@ async function selectPrompt({ title, items, defaultIndex = 0, onConfirm }) {
 // Token Verification
 // -----------------------------------------------------------------------------
 
-function checkFigmaToken() {
-  if (process.env.FIGMA_ACCESS_TOKEN || process.env.FIGMA_TOKEN) {
-    return { found: true, source: 'environment variable' };
+function decodeEnvBuffer(buf) {
+  if (!Buffer.isBuffer(buf)) {
+    const str = String(buf || '');
+    return str.charCodeAt(0) === 0xfeff ? str.slice(1) : str;
   }
-  const home = os.homedir();
-  const candidates = [
-    path.join(process.cwd(), '.env'),
-    path.join(process.cwd(), '.env.local'),
-    path.join(home, '.zshrc'),
-    path.join(home, '.bashrc'),
-    path.join(home, '.profile'),
+  if (buf.length >= 2 && buf[0] === 0xff && buf[1] === 0xfe) {
+    return buf.toString('utf16le', 2);
+  }
+  const str = buf.toString('utf8');
+  return str.charCodeAt(0) === 0xfeff ? str.slice(1) : str;
+}
+
+function getPowerShellProfilePaths(home) {
+  const paths = [];
+  if (process.env.PROFILE && process.env.PROFILE.toLowerCase().endsWith('.ps1')) {
+    paths.push(process.env.PROFILE);
+  }
+
+  const docRoots = [];
+  if (home) {
+    docRoots.push(
+      path.join(home, 'Documents'),
+      path.join(home, 'Documentos'),
+      path.join(home, 'OneDrive', 'Documents'),
+      path.join(home, 'OneDrive', 'Documentos'),
+    );
+  }
+
+  const oneDriveEnvs = [
+    process.env.OneDrive,
+    process.env.OneDriveConsumer,
+    process.env.OneDriveCommercial,
+  ].filter(Boolean);
+
+  for (const od of oneDriveEnvs) {
+    docRoots.push(path.join(od, 'Documents'), path.join(od, 'Documentos'));
+  }
+
+  const shellDirs = ['PowerShell', 'WindowsPowerShell'];
+  const profileFiles = [
+    'Microsoft.PowerShell_profile.ps1',
+    'Microsoft.VSCode_profile.ps1',
+    'profile.ps1',
   ];
+
+  for (const docRoot of docRoots) {
+    if (!fs.existsSync(docRoot)) continue;
+    for (const shellDir of shellDirs) {
+      const fullShellDir = path.join(docRoot, shellDir);
+      if (!fs.existsSync(fullShellDir)) continue;
+      for (const profileFile of profileFiles) {
+        paths.push(path.join(fullShellDir, profileFile));
+      }
+    }
+  }
+
+  if (home) {
+    const xdgPsDir = path.join(process.env.XDG_CONFIG_HOME || path.join(home, '.config'), 'powershell');
+    if (fs.existsSync(xdgPsDir)) {
+      for (const profileFile of profileFiles) {
+        paths.push(path.join(xdgPsDir, profileFile));
+      }
+    }
+  }
+
+  return Array.from(new Set(paths));
+}
+
+function hasFigmaTokenInText(text) {
+  if (!text) return false;
+  const lines = text.split(/\r?\n/);
+  for (const rawLine of lines) {
+    const trimmed = rawLine.replace(/^\uFEFF/, '').trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    if (
+      /^(?:export\s+|set\s+"?|\$env:|\$\{env:)?(?:FIGMA_ACCESS_TOKEN|FIGMA_TOKEN)\}?[\s="']/i.test(trimmed) ||
+      /^\[(?:System\.)?Environment\]::SetEnvironmentVariable\(\s*['"](?:FIGMA_ACCESS_TOKEN|FIGMA_TOKEN)['"]/i.test(trimmed)
+    ) {
+      return true;
+    }
+  }
+  return false;
+}
+
+function checkFigmaToken(options = {}) {
+  const ignoreProcessEnv = Boolean(options.ignoreProcessEnv);
+  if (!ignoreProcessEnv && (process.env.FIGMA_ACCESS_TOKEN || process.env.FIGMA_TOKEN)) {
+    return { found: true, source: 'environment variable' };
+  }
+  const cwd = options.cwd || process.cwd();
+  const home = options.home !== undefined ? options.home : (process.env.HOME || process.env.USERPROFILE || os.homedir());
+  const candidates = Array.from(
+    new Set(
+      [
+        path.join(cwd, '.env'),
+        path.join(cwd, '.env.local'),
+        home ? path.join(home, '.env') : null,
+        home ? path.join(home, '.zshrc') : null,
+        home ? path.join(home, '.zprofile') : null,
+        home ? path.join(home, '.zshenv') : null,
+        home ? path.join(home, '.bashrc') : null,
+        home ? path.join(home, '.bash_profile') : null,
+        home ? path.join(home, '.profile') : null,
+        ...getPowerShellProfilePaths(home),
+      ].filter(Boolean),
+    ),
+  );
   for (const c of candidates) {
     if (fs.existsSync(c)) {
       try {
-        const text = fs.readFileSync(c, 'utf8');
-        if (/FIGMA_ACCESS_TOKEN|FIGMA_TOKEN/.test(text)) {
+        const text = decodeEnvBuffer(fs.readFileSync(c));
+        if (hasFigmaTokenInText(text)) {
           return { found: true, source: path.basename(c) };
         }
       } catch (_) {}
@@ -399,12 +506,32 @@ function checkFigmaToken() {
 // Skill Installation Logic
 // -----------------------------------------------------------------------------
 
+const EXCLUDED_SKILL_DIRS = new Set(['demo', 'demos', '.specs', 'node_modules', '.git']);
+
+function shouldCopySkillEntry(rootSkillPath) {
+  return (srcPath) => {
+    const rel = path.relative(rootSkillPath, srcPath);
+    if (!rel) return true;
+    const parts = rel.split(/[\\/]/);
+    const base = parts[parts.length - 1];
+    if (base === '.DS_Store' || base === 'Thumbs.db' || /^test_.*\.js$/i.test(base)) {
+      return false;
+    }
+    for (let i = 0; i < parts.length; i++) {
+      if (EXCLUDED_SKILL_DIRS.has(parts[i])) return false;
+      if (parts[i] === 'figma-plugin' && parts[i + 1] === 'assets') return false;
+    }
+    return true;
+  };
+}
+
 function installSkill(skill, destDir, useSymlink = false, isCursor = false) {
   if (!fs.existsSync(destDir)) {
     fs.mkdirSync(destDir, { recursive: true });
   }
 
   const targetPath = path.join(destDir, skill.name);
+  const copyFilter = shouldCopySkillEntry(skill.path);
 
   if (isCursor) {
     const cursorSkillsDir = path.join(path.dirname(destDir), 'skills', skill.name);
@@ -413,16 +540,17 @@ function installSkill(skill, destDir, useSymlink = false, isCursor = false) {
     if (fs.existsSync(cursorSkillsDir)) {
       fs.rmSync(cursorSkillsDir, { recursive: true, force: true });
     }
-    fs.cpSync(skill.path, cursorSkillsDir, { recursive: true });
+    fs.cpSync(skill.path, cursorSkillsDir, { recursive: true, filter: copyFilter });
 
+    const rawSkillMd = fs.readFileSync(path.join(skill.path, 'SKILL.md'), 'utf8');
+    const skillBody = rawSkillMd.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n*/, '');
     const ruleFile = path.join(destDir, `${skill.name}.mdc`);
     const ruleContent = `---
 description: ${skill.description}
 globs: *
 ---
 
-${fs.readFileSync(path.join(skill.path, 'SKILL.md'), 'utf8')}
-`;
+${skillBody}`;
     fs.writeFileSync(ruleFile, ruleContent, 'utf8');
     return { targetPath: ruleFile, isCursorRule: true };
   }
@@ -433,14 +561,15 @@ ${fs.readFileSync(path.join(skill.path, 'SKILL.md'), 'utf8')}
 
   if (useSymlink) {
     try {
-      fs.symlinkSync(skill.path, targetPath, 'dir');
+      const symlinkType = process.platform === 'win32' ? 'junction' : 'dir';
+      fs.symlinkSync(skill.path, targetPath, symlinkType);
       return { targetPath, isSymlink: true };
     } catch (e) {
-      fs.cpSync(skill.path, targetPath, { recursive: true });
+      fs.cpSync(skill.path, targetPath, { recursive: true, filter: copyFilter });
       return { targetPath, isSymlink: false };
     }
   } else {
-    fs.cpSync(skill.path, targetPath, { recursive: true });
+    fs.cpSync(skill.path, targetPath, { recursive: true, filter: copyFilter });
     const scriptsDir = path.join(targetPath, 'scripts');
     if (fs.existsSync(scriptsDir)) {
       try {
@@ -589,30 +718,34 @@ async function main() {
   let targetDestinations = [];
 
   if (flagDest) {
+    const expandedDest = flagDest.replace(/^~(?=$|[\\/])/, os.homedir());
     targetDestinations.push({
       name: 'Custom Directory',
-      path: path.resolve(cwd, flagDest),
+      path: path.resolve(cwd, expandedDest),
       isCursor: false,
     });
   } else if (flagAgent) {
-    const isGlobal = flagScope !== 'local';
-    if (flagAgent === 'all') {
+    const normalizedAgent = flagAgent === 'kiro-ide' || flagAgent === 'kiro-cli' ? 'kiro' : flagAgent;
+    const resolveScopeIsGlobal = (agentKey) => (flagScope ? flagScope === 'global' : agentKey !== 'cursor');
+    if (normalizedAgent === 'all') {
       for (const [key, cfg] of Object.entries(agentConfigs)) {
+        const useGlobal = resolveScopeIsGlobal(key);
         targetDestinations.push({
           name: cfg.name,
-          path: isGlobal ? cfg.globalPath : cfg.localPath,
+          path: useGlobal ? cfg.globalPath : cfg.localPath,
           isCursor: !!cfg.isCursorRule,
         });
       }
-    } else if (agentConfigs[flagAgent]) {
-      const cfg = agentConfigs[flagAgent];
+    } else if (agentConfigs[normalizedAgent]) {
+      const cfg = agentConfigs[normalizedAgent];
+      const useGlobal = resolveScopeIsGlobal(normalizedAgent);
       targetDestinations.push({
         name: cfg.name,
-        path: isGlobal ? cfg.globalPath : cfg.localPath,
+        path: useGlobal ? cfg.globalPath : cfg.localPath,
         isCursor: !!cfg.isCursorRule,
       });
     } else {
-      console.error(style.yellow(`⚠ Unknown agent "${flagAgent}". Options: claude, antigravity, cursor, opencode, all`));
+      console.error(style.yellow(`⚠ Unknown agent "${flagAgent}". Options: claude, antigravity, cursor, kiro, opencode, all`));
       process.exit(1);
     }
   } else {
@@ -620,6 +753,7 @@ async function main() {
       { id: 'claude', ...agentConfigs.claude },
       { id: 'antigravity', ...agentConfigs.antigravity },
       { id: 'cursor', ...agentConfigs.cursor },
+      { id: 'kiro', ...agentConfigs.kiro },
       { id: 'opencode', ...agentConfigs.opencode },
       { id: 'all', name: 'All detected agents' },
     ];
@@ -639,8 +773,8 @@ async function main() {
       },
     });
 
-    // Scope selection (Global vs Local)
-    let isGlobal = true;
+    // Scope selection (Global vs Local — Cursor rules live in workspace .cursor/rules by default)
+    let isGlobal = selectedAgent.id !== 'cursor';
     if (selectedAgent.id !== 'cursor') {
       const scopeOptions = [
         {
@@ -668,9 +802,10 @@ async function main() {
     if (selectedAgent.id === 'all') {
       for (const [key, cfg] of Object.entries(agentConfigs)) {
         if (cfg.isDetected) {
+          const useGlobal = key === 'cursor' ? false : isGlobal;
           targetDestinations.push({
             name: cfg.name,
-            path: isGlobal ? cfg.globalPath : cfg.localPath,
+            path: useGlobal ? cfg.globalPath : cfg.localPath,
             isCursor: !!cfg.isCursorRule,
           });
         }
@@ -713,7 +848,12 @@ async function main() {
   } else {
     ui.item(`${style.yellow('⚠')} ${style.bold('FIGMA_ACCESS_TOKEN')} not detected.`);
     ui.item(`${style.dim('To scrape designs from Figma, set your token:')}`);
-    ui.item(`${style.cyan('export FIGMA_ACCESS_TOKEN="figd_your_token_here"')}`);
+    if (process.platform === 'win32') {
+      ui.item(`${style.cyan('[Environment]::SetEnvironmentVariable("FIGMA_ACCESS_TOKEN", "figd_your_token_here", "User")')}`);
+      ui.item(`${style.dim('or in PowerShell ($PROFILE): $env:FIGMA_ACCESS_TOKEN="figd_your_token_here"')}`);
+    } else {
+      ui.item(`${style.cyan('export FIGMA_ACCESS_TOKEN="figd_your_token_here"')}`);
+    }
     ui.item(`${style.dim('or add it to your project\'s .env file.')}`);
   }
   ui.bar();

package/figma-extractor/README.md

@@ -82,10 +82,16 @@ Choose one of the following terminal commands:
   ```bash
   export FIGMA_ACCESS_TOKEN="figd_your_token_here"
   ```
-- **Persist globally across all terminal sessions (`~/.zshrc`)**:
+- **Persist globally on macOS / Linux (`~/.zshrc`)**:
   ```bash
   echo 'export FIGMA_ACCESS_TOKEN="figd_your_token_here"' >> ~/.zshrc && source ~/.zshrc
   ```
+- **Persist globally on Windows (PowerShell)**:
+  ```powershell
+  [Environment]::SetEnvironmentVariable("FIGMA_ACCESS_TOKEN", "figd_your_token_here", "User")
+  # Or inside your PowerShell profile ($PROFILE):
+  # $env:FIGMA_ACCESS_TOKEN="figd_your_token_here"
+  ```
 
 *(Optional: If behind a corporate proxy with self-signed SSL certificates, run `echo 'FIGMA_IGNORE_SSL=true' >> .env`).*
 
@@ -110,8 +116,8 @@ node figma-extractor/scripts/fetch_figma.js "<FigmaURL>" --spec card -i
 # Atomic extraction with shallow instances (collapses component internals into props)
 node figma-extractor/scripts/fetch_figma.js "<FigmaURL>" --spec card --shallow-instances
 
-# Extract only design tokens dictionary (colors, spacing, radii)
-node figma-extractor/scripts/fetch_figma.js "<FigmaURL>" --tokens > ./.specs/tokens.json
+# Extract only design tokens dictionary into ./.specs/tokens.json
+node figma-extractor/scripts/fetch_figma.js "<FigmaURL>" --tokens --spec tokens
 ```
 
 ---
@@ -146,10 +152,12 @@ node figma-extractor/scripts/fetch_figma.js "<FigmaURL>" --tokens > ./.specs/tok
 For developers who prefer exporting specifications directly from Figma Desktop without configuring API access tokens or consuming REST API quotas:
 
 * **Published Figma Plugin (Recommended)**: Install [**Figma Node JSON Extractor** on Figma Community](https://www.figma.com/community/plugin/1691244420692136789/figma-node-json-extractor) directly, or search for it under Figma Plugins.
-* **Manual Local Installation (Local / Offline Backup)**: In Figma Desktop, go to **Plugins** $\rightarrow$ **Development** $\rightarrow$ **Import plugin from manifest...** and select `manifest.json` from your installed skills directory:
+* **Manual Local Installation (Local / Offline Backup)**: In Figma Desktop, go to **Plugins** $\rightarrow$ **Development** $\rightarrow$ **Import plugin from manifest...** and select `manifest.json` from your installed skills directory (`~` corresponds to `%USERPROFILE%` on Windows):
   * **Claude Code**: `~/.claude/skills/figma-extractor/figma-plugin/manifest.json`
-  * **Google Antigravity**: `~/.gemini/config/skills/figma-extractor/figma-plugin/manifest.json`
+  * **Cursor**: `.cursor/skills/figma-extractor/figma-plugin/manifest.json` (or `~/.cursor/skills/...`)
   * **OpenCode**: `~/.config/opencode/skills/figma-extractor/figma-plugin/manifest.json`
+  * **Google Antigravity**: `~/.gemini/config/skills/figma-extractor/figma-plugin/manifest.json`
+  * **Kiro**: `~/.kiro/skills/figma-extractor/figma-plugin/manifest.json`
   * **Cloned Git Repo**: `<repo-root>/figma-extractor/figma-plugin/manifest.json`
 * **Export Options**: Select any frame or component, then click:
   * **📋 Copy Node JSON**: Copies the clean AST specification to your clipboard.
@@ -165,7 +173,7 @@ The skill includes the following resources:
 
 - **Agent Instruction Guide (`SKILL.md`)**: The core skill definition read by AI agents containing workflow triggers and operational boundaries (spec ingestion only).
 - **Core Extraction Script (`scripts/fetch_figma.js`)**: The standalone, zero-dependency Node.js script that interfaces with the Figma REST API, resolves tokens, prunes the AST, and downloads preview images.
-- **Unit Test Suite (`scripts/test_fetch_figma.js`)**: A suite of 40 automated unit tests verifying URL parsing, token formatting, component prop cleaning, rate-limit gates, and node pruning without requiring network access.
+- **Unit Test Suite (`scripts/test_fetch_figma.js`)**: Automated unit tests verifying environment/profile parsing, URL parsing, token formatting, component prop cleaning, rate-limit gates, and node pruning without requiring network access.
 - **Companion Figma Plugin (`figma-plugin/`)**: Zero-API desktop exporter for extracting AST and previews directly inside Figma Desktop.
 - **Reference Documentation (`README.md`)**: This guide explaining architecture, comparison, and operational flags.
 

package/figma-extractor/SKILL.md

@@ -25,7 +25,7 @@ This skill serves as the **Specification Ingestion Layer** in a **Spec-Driven De
 > **NEVER use browser tools (Playwright, Puppeteer, Chrome DevTools, `browser_navigate`, `read_browser_page`) on Figma URLs.**
 >
 > 1. **Figma Canvas is WebGL/Wasm**: Figma renders design canvas elements inside an HTML5 `<canvas>` via WebAssembly. There are NO inspectable HTML DOM elements for frames, layers, texts, or styles. Browser automation cannot extract Figma nodes or properties.
-> 2. **Never search `/Applications` for browsers**: Do not search for installed browser binaries or run browser automation scripts.
+> 2. **Never search for local browser binaries**: Do not search OS application directories (e.g., `/Applications`, `Program Files`, `/usr/bin`) or run browser automation scripts.
 > 3. **API Errors Are Final**: If `fetch_figma.js` returns an API error (e.g., 401 Unauthorized, 403 Forbidden, or 429 Rate Limited), **report the error directly to the user**. Guide them to check their `FIGMA_ACCESS_TOKEN`, permissions, or wait out rate limits. Do NOT attempt browser scraping fallbacks.
 
 ---
@@ -35,7 +35,7 @@ This skill serves as the **Specification Ingestion Layer** in a **Spec-Driven De
 To protect your Figma file quota and prevent lockout penalties, `fetch_figma.js` enforces an automatic safety gate:
 * **Max 5 requests per minute** per file key (sliding window limit).
 * **2.5s inter-request pacing** between consecutive requests.
-* **Persistent Circuit Breaker**: If Figma returns HTTP 429, the script records the lockout time locally in `~/.figma_ratelimit.json`. All future calls to that file key are **immediately blocked with zero network traffic**, preventing Figma from extending the lockout penalty.
+* **Persistent Circuit Breaker**: If Figma returns HTTP 429, the script records the lockout time locally in `.figma_ratelimit.json` inside the user's home directory. All future calls to that file key are **immediately blocked with zero network traffic**, preventing Figma from extending the lockout penalty.
 
 ### Agent Behavioral Rules (Zero-Hammer Protocol)
 1. **Single-Shot Execution**: Run `fetch_figma.js` **once** per target frame or component.
@@ -49,7 +49,9 @@ To protect your Figma file quota and prevent lockout penalties, `fetch_figma.js`
 A Figma Access Token (Personal Access Token or OAuth Token) is required.
 
 Configure it using either:
-1. **Environment Variable**: `export FIGMA_ACCESS_TOKEN="figd_your_token_here"` or `export FIGMA_TOKEN="..."`
+1. **Environment Variable**:
+   - **macOS / Linux**: `export FIGMA_ACCESS_TOKEN="figd_your_token_here"` (or `FIGMA_TOKEN`)
+   - **Windows (PowerShell)**: `[Environment]::SetEnvironmentVariable("FIGMA_ACCESS_TOKEN", "figd_your_token_here", "User")` or `$env:FIGMA_ACCESS_TOKEN="figd_your_token_here"` in `$PROFILE`
 2. **Workspace `.env` File**:
    ```env
    FIGMA_ACCESS_TOKEN=figd_your_token_here
@@ -77,20 +79,20 @@ FIGMA_IGNORE_SSL=true
 
 ## Agent Execution Instructions
 
-To extract a Figma frame or component as a specification artifact, run `fetch_figma.js` from the skill's scripts directory:
+To extract a Figma frame or component as a specification artifact, run `fetch_figma.js` from this skill's `scripts/` directory:
 
 ```bash
 # Recommended: Atomic extraction (writes ./.specs/<name>.json - 1 Tier 1 call)
-node <skill-dir>/scripts/fetch_figma.js "<FigmaURL>" --spec <name>
+node "<skill-dir>/scripts/fetch_figma.js" "<FigmaURL>" --spec <name>
 
 # Optional: With companion preview image (writes .json and .png - 2 Tier 1 calls)
-node <skill-dir>/scripts/fetch_figma.js "<FigmaURL>" --spec <name> -i
+node "<skill-dir>/scripts/fetch_figma.js" "<FigmaURL>" --spec <name> -i
 ```
 
-**Script Path Resolution**:
-- **Global Antigravity install**: `node ~/.gemini/config/skills/figma-extractor/scripts/fetch_figma.js "<FigmaURL>" --spec <name>`
-- **Global Claude Code install**: `node ~/.claude/skills/figma-extractor/scripts/fetch_figma.js "<FigmaURL>" --spec <name>`
-- **Project local install**: `node figma-extractor/scripts/fetch_figma.js "<FigmaURL>" --spec <name>`
+**Resolving `<skill-dir>` (Agent-Agnostic)**:
+Substitute `<skill-dir>` with the directory where this skill is installed — **never guess another agent's folder** (always keep double quotes around the script path for Windows/macOS/Linux compatibility):
+- **Standard Skills (`SKILL.md`)**: `<skill-dir>` is the exact parent directory of this `SKILL.md` file.
+- **Cursor Rule (`.cursor/rules/figma-extractor.mdc`)**: `<skill-dir>` is the sibling `.cursor/skills/figma-extractor` directory (replace `rules/figma-extractor.mdc` with `skills/figma-extractor`).
 
 ---
 
@@ -102,20 +104,20 @@ Extract node metadata directly into `./.specs/`:
 
 ```bash
 # Atomic AST extraction (1 Tier 1 call - recommended)
-node figma-extractor/scripts/fetch_figma.js "https://www.figma.com/design/:fileKey/:name?node-id=4023-474" --spec card
+node "<skill-dir>/scripts/fetch_figma.js" "https://www.figma.com/design/:fileKey/:name?node-id=4023-474" --spec card
 
 # Optional: With rendered preview image (2 Tier 1 calls)
-node figma-extractor/scripts/fetch_figma.js "https://www.figma.com/design/:fileKey/:name?node-id=4023-474" --spec card -i
+node "<skill-dir>/scripts/fetch_figma.js" "https://www.figma.com/design/:fileKey/:name?node-id=4023-474" --spec card -i
 
 # Shallow instances mode (collapses internal component layers into clean props)
-node figma-extractor/scripts/fetch_figma.js "https://www.figma.com/design/:fileKey/:name?node-id=4023-474" --spec card --shallow-instances
+node "<skill-dir>/scripts/fetch_figma.js" "https://www.figma.com/design/:fileKey/:name?node-id=4023-474" --spec card --shallow-instances
 ```
 
 ### 2. Design Tokens Dictionary Mode
 
 ```bash
-# Export only the file's design token dictionary (colors, spacing, radii)
-node figma-extractor/scripts/fetch_figma.js "https://www.figma.com/design/:fileKey/:name" --tokens > ./.specs/tokens.json
+# Export only the file's design token dictionary (colors, spacing, radii) into ./.specs/tokens.json
+node "<skill-dir>/scripts/fetch_figma.js" "https://www.figma.com/design/:fileKey/:name" --tokens --spec tokens
 ```
 
 ### 3. CLI Flags Reference
@@ -192,7 +194,7 @@ When an `INSTANCE` node is present, internal property hashes are converted into
 
 - **Token Expired / Missing (`FIGMA_TOKEN_EXPIRED_OR_INVALID` / `isTokenExpiredOrInvalid`)**:
   - Alert the user that their Figma access token is missing, invalid, or expired.
-  - Instruct the user to create a token in **Figma Settings → Personal Access Tokens** and export `FIGMA_ACCESS_TOKEN=your_token` or update `.env`.
+  - Instruct the user to create a token in **Figma Settings → Personal Access Tokens** and configure `FIGMA_ACCESS_TOKEN` in their environment or workspace `.env` file.
 - **Node Not Found**:
   - Alert the user that the node ID could not be found in the specified file.
 - **Rate Limited (`FIGMA_RATE_LIMIT_EXCEEDED` / `FIGMA_CIRCUIT_BREAKER_ACTIVE`)**:

package/figma-extractor/figma-plugin/README.md

@@ -10,7 +10,7 @@
   <a href="../../LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT" /></a>
 </p>
 
-Inspect, copy, and export compact, design-system-aware Node JSON and high-resolution companion preview images directly from **Figma Desktop** for AI coding assistants (Claude Code, Antigravity, Cursor) and frontend engineering.
+Inspect, copy, and export compact, design-system-aware Node JSON and high-resolution companion preview images directly from **Figma Desktop** for AI coding assistants (Claude Code, Kiro, Cursor, OpenCode, Antigravity) and frontend engineering.
 
 ---
 
@@ -37,14 +37,19 @@ To install the plugin directly from your local skills folder or repository:
 1. Open the **Figma Desktop app**.
 2. In the top-left menu, navigate to:
    $$\text{Plugins} \longrightarrow \text{Development} \longrightarrow \text{Import plugin from manifest...}$$
-3. Select `manifest.json` from your machine based on your setup:
+3. Select `manifest.json` from your machine based on your setup (`~` corresponds to `%USERPROFILE%` on Windows):
    * **Installed via `npx @pedroab0/skills` (Global)**:
      * **Claude Code**: `~/.claude/skills/figma-extractor/figma-plugin/manifest.json`
-     * **Google Antigravity**: `~/.gemini/config/skills/figma-extractor/figma-plugin/manifest.json`
+     * **Cursor**: `~/.cursor/skills/figma-extractor/figma-plugin/manifest.json`
      * **OpenCode**: `~/.config/opencode/skills/figma-extractor/figma-plugin/manifest.json`
+     * **Google Antigravity**: `~/.gemini/config/skills/figma-extractor/figma-plugin/manifest.json`
+     * **Kiro**: `~/.kiro/skills/figma-extractor/figma-plugin/manifest.json`
    * **Installed in local workspace (`--local`)**:
      * `.claude/skills/figma-extractor/figma-plugin/manifest.json`
+     * `.cursor/skills/figma-extractor/figma-plugin/manifest.json`
+     * `.opencode/skills/figma-extractor/figma-plugin/manifest.json`
      * `.gemini/skills/figma-extractor/figma-plugin/manifest.json`
+     * `.kiro/skills/figma-extractor/figma-plugin/manifest.json`
    * **Cloned Git repository**:
      * `<repo-root>/figma-extractor/figma-plugin/manifest.json`
 4. The plugin is now permanently loaded under **Plugins** $\rightarrow$ **Development**.
@@ -54,7 +59,7 @@ To install the plugin directly from your local skills folder or repository:
 ## How to Extract Node JSON
 
 1. **Select any frame or component** on your canvas (e.g., Transaction Card, Navbar, Modal).
-2. Right-click the element $\rightarrow$ **Plugins** $\rightarrow$ **Figma Node JSON Extractor** (or press `⌥ ⌘ P` to re-run).
+2. Right-click the element $\rightarrow$ **Plugins** $\rightarrow$ **Figma Node JSON Extractor** (or press `⌥ ⌘ P` on macOS / `Ctrl + Alt + P` on Windows to re-run).
 3. In the plugin popup, choose your export format:
    * **📋 Copy Node JSON**: Copies the clean AST specification directly to your clipboard (ready to paste into chat).
    * **💾 .json**: Downloads `<name>.json` containing layout, dimensions, tokens, and props.
@@ -72,7 +77,7 @@ To install the plugin directly from your local skills folder or repository:
 
 ## How to Tell Your Agent to Build the UI
 
-Once the specification is in `./.specs/`, simply instruct your agent in Antigravity, Claude Code, or Cursor:
+Once the specification is in `./.specs/`, simply instruct your agent in Claude Code, Kiro, Cursor, OpenCode, or Antigravity:
 
 ```text
 Build the component from .specs/card.json