@pedroab0/skills 1.0.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pedro Barbosa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,13 @@
 # Skills
 
-A curated collection of modular, production-ready skills developed for AI coding agents (such as Claude Code, OpenCode, Codex, Google Antigravity, and Cursor).
+<p align="center">
+  <a href="https://www.npmjs.com/package/@pedroab0/skills"><img src="https://img.shields.io/npm/dm/@pedroab0/skills.svg" alt="npm downloads" /></a>
+  <a href="https://www.npmjs.com/package/@pedroab0/skills"><img src="https://img.shields.io/npm/v/@pedroab0/skills.svg" alt="npm version" /></a>
+  <a href="https://www.figma.com/community/plugin/1691244420692136789/figma-node-json-extractor"><img src="https://img.shields.io/badge/Figma_Community-Plugin-000000?style=flat&logo=figma&logoColor=white" alt="Figma Community Plugin" /></a>
+  <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, 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.
@@ -14,7 +21,7 @@ Each skill in this repository is designed to give AI assistants specialized, aut
 | Skill | Role / Workflow | Description | Links |
 | :--- | :--- | :--- | :--- |
 | **[`figma-to-code`](./figma-to-code)** | **One-Shot / Fast Prototyping** | Direct, single-turn conversion of Figma designs into clean, production-ready UI components. Best for rapid prototyping and standalone components. | [Guide](./figma-to-code/README.md) · [`SKILL.md`](./figma-to-code/SKILL.md) |
-| **[`figma-extractor`](./figma-extractor)** | **SDD Step 1 (Ingest)** | Pure specification scraper (CLI / REST API) and companion Figma Desktop plugin that pull compact layout trees, design tokens, and preview images into `./.specs/`. Never touches application code. | [Guide](./figma-extractor/README.md) · [Plugin](./figma-extractor/figma-plugin/README.md) · [`SKILL.md`](./figma-extractor/SKILL.md) |
+| **[`figma-extractor`](./figma-extractor)** | **SDD Step 1 (Ingest)** | Pure specification scraper (CLI / REST API) and companion Figma Desktop plugin that pull compact layout trees, design tokens, and preview images into `./.specs/`. Never touches application code. | [Guide](./figma-extractor/README.md) · [Plugin](./figma-extractor/figma-plugin/README.md) · [Community](https://www.figma.com/community/plugin/1691244420692136789/figma-node-json-extractor) · [`SKILL.md`](./figma-extractor/SKILL.md) |
 | **[`figma-node-builder`](./figma-node-builder)** | **SDD Step 2 (Implement)** | Grounded UI builder that reads extracted Figma Node specifications (`.specs/*.json`) and preview images (`*.png`) to build components without CSS hallucinations. | [Guide](./figma-node-builder/README.md) · [`SKILL.md`](./figma-node-builder/SKILL.md) |
 
 ---
@@ -40,10 +47,17 @@ flowchart TD
 * **Use `figma-to-code`** when you want fast execution: you provide a Figma URL, and the agent extracts and writes the component in one turn.
 * **Use `figma-extractor` + `figma-node-builder`** in formal Spec-Driven Development (SDD): the design specification is extracted to disk first (via CLI or the companion Figma Desktop plugin), reviewed/approved, and then systematically implemented into your design system without premature code edits.
 
-> [!TIP]
-> **Zero-API Figma Desktop Plugin**: To extract specifications directly inside Figma Desktop without API tokens or rate limits, use the companion **Figma Node JSON Extractor** plugin:
-> * **Figma Community (Recommended)**: Search for **Figma Node JSON Extractor** in 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`).
+---
+
+### Zero-API Companion: Figma Desktop Plugin
+
+<p align="center">
+  <img src="./figma-extractor/figma-plugin/assets/cover.png" alt="Figma Node JSON Extractor" width="100%" />
+</p>
+
+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 skill directory (`<skill-dir>/figma-plugin/manifest.json`).
 
 ---
 
@@ -61,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
@@ -77,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
 
@@ -142,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
@@ -172,3 +202,10 @@ When adding new skills to this curation:
 3. Provide a `README.md` with detailed skill-specific documentation and manual execution flags.
 4. Keep scripts self-contained with minimal external dependencies.
 5. Update this root `README.md` catalog to list the new skill.
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+

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 (_) {}
@@ -415,14 +522,15 @@ function installSkill(skill, destDir, useSymlink = false, isCursor = false) {
     }
     fs.cpSync(skill.path, cursorSkillsDir, { recursive: true });
 
+    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,7 +541,8 @@ ${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 });
@@ -589,30 +698,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 +733,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 +753,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 +782,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 +828,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

@@ -1,5 +1,11 @@
 # Figma Extractor
 
+<p align="center">
+  <a href="https://www.figma.com/community/plugin/1691244420692136789/figma-node-json-extractor"><img src="https://img.shields.io/badge/Figma_Community-Plugin-000000?style=flat&logo=figma&logoColor=white" alt="Figma Community Plugin" /></a>
+  <a href="https://www.npmjs.com/package/@pedroab0/skills"><img src="https://img.shields.io/npm/v/@pedroab0/skills.svg?label=@pedroab0/skills" alt="npm package" /></a>
+  <a href="../LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT" /></a>
+</p>
+
 A lightweight, zero-dependency Node.js CLI tool and agent skill that extracts design node metadata, component hierarchies, design tokens, and rendered preview images from Figma via the Figma REST API into `./.specs/`.
 
 This skill serves as the **Specification Ingestion Layer** in a **Spec-Driven Development (SDD)** workflow.
@@ -76,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`).*
 
@@ -104,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
 ```
 
 ---
@@ -133,13 +145,19 @@ node figma-extractor/scripts/fetch_figma.js "<FigmaURL>" --tokens > ./.specs/tok
 
 ## Zero-API Companion: Figma Node JSON Extractor (Figma Plugin)
 
+<p align="center">
+  <img src="./figma-plugin/assets/icon.png" alt="Figma Node JSON Extractor" width="200" />
+</p>
+
 For developers who prefer exporting specifications directly from Figma Desktop without configuring API access tokens or consuming REST API quotas:
 
-* **Published Figma Plugin (Recommended)**: Search for **Figma Node JSON Extractor** in Figma Community / Plugins and click **Open in...** or **Save**.
-* **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:
+* **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 (`~` 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.
@@ -155,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,8 +194,8 @@ 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`)**:
-  - Figma REST API has per-minute and monthly rate limits on Starter plans. If quota is exhausted or circuit breaker trips, inform the user they can export the specification directly via the companion **Figma Node JSON Extractor** desktop plugin into `./.specs/<name>.json`.
+  - Figma REST API has per-minute and monthly rate limits on Starter plans. If quota is exhausted or circuit breaker trips, inform the user they can export the specification directly via the companion **Figma Node JSON Extractor** desktop plugin (available on [Figma Community](https://www.figma.com/community/plugin/1691244420692136789/figma-node-json-extractor)) into `./.specs/<name>.json`.