[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BV4EC4K4GGAK95MYFXP677":3,"skill-same:01M7BV4EC4K4GGAK95MYFXP677":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7BV4EC4K4GGAK95MYFXP677","cross-platform-paths",null,"Critical patterns for cross-platform path handling in this VS Code extension. Windows vs POSIX path bugs are the #1 source of issues. Use this skill when reviewing or writing path-related code.","nguyenhungtran18\u002Fskill-and-tool-tracker","nguyenhungtran18","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F297063550?v=4","01M7BV0BFPRRFP84F2ME0FYZ9D","01M7BV0BG83FA5P22NJV0GR0A5",1,"MIT","https:\u002F\u002Fgithub.com\u002Fnguyenhungtran18\u002Fskill-and-tool-tracker\u002Fblob\u002Fmain\u002Fskills\u002Fcross-platform-paths\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: cross-platform-paths\ndescription: 'Critical patterns for cross-platform path handling in this VS Code extension. Windows vs POSIX path bugs are the #1 source of issues. Use this skill when reviewing or writing path-related code.'\nargument-hint: Review path handling in [file or component]\nuser-invocable: false\n---\n\n# Cross-Platform Path Handling\n\n**CRITICAL**: This extension runs on Windows, macOS, and Linux. Path bugs are the #1 source of issues.\n\n## Core Rules\n\n### Rule 1: Never Concatenate Paths with `\u002F`\n\n```typescript\n\u002F\u002F ❌ WRONG: POSIX-style path concatenation\nconst envPath = homeDir + '\u002F.venv\u002Fbin\u002Fpython';\n\n\u002F\u002F ✅ RIGHT: Use path.join()\nconst envPath = path.join(homeDir, '.venv', 'bin', 'python');\n```\n\n### Rule 2: Use path.resolve() for Comparisons, Not path.normalize()\n\n```typescript\n\u002F\u002F ❌ WRONG: path.normalize keeps relative paths relative on Windows\nconst normalized = path.normalize(fsPath);\n\u002F\u002F path.normalize('\\test') → '\\test' (still relative!)\n\n\u002F\u002F ✅ RIGHT: path.resolve adds drive letter on Windows\nconst normalized = path.resolve(fsPath);\n\u002F\u002F path.resolve('\\test') → 'C:\\test' (absolute!)\n\n\u002F\u002F When comparing paths, use resolve() on BOTH sides:\nconst pathA = path.resolve(fsPath);\nconst pathB = path.resolve(e.environmentPath.fsPath);\nreturn pathA === pathB;\n```\n\n### Rule 3: Use Uri.file().fsPath for VS Code Paths\n\n```typescript\n\u002F\u002F ❌ WRONG: Raw string comparison\nif (filePath === otherPath) {\n}\n\n\u002F\u002F ✅ RIGHT: Compare fsPath to fsPath\nimport { Uri } from 'vscode';\nconst fsPathA = Uri.file(pathA).fsPath;\nconst fsPathB = Uri.file(pathB).fsPath;\nif (fsPathA === fsPathB) {\n}\n```\n\n## Platform-Specific Gotchas\n\n### Windows\n\n| Issue              | Details                                      |\n| ------------------ | -------------------------------------------- |\n| Drive letters      | Paths start with `C:\\`, `D:\\`, etc.          |\n| Backslashes        | Separator is `\\`, not `\u002F`                    |\n| Case insensitivity | `C:\\Test` equals `c:\\test`                   |\n| Long paths         | Paths >260 chars may fail                    |\n| Mapped drives      | `Z:\\` may not be accessible                  |\n| pyenv-win          | Uses `pyenv.bat`, not `pyenv` or `pyenv.exe` |\n| Poetry cache       | `%LOCALAPPDATA%\\pypoetry\\Cache\\virtualenvs`  |\n| UNC paths          | `\\\\server\\share\\` format                     |\n\n### macOS\n\n| Issue             | Details                                     |\n| ----------------- | ------------------------------------------- |\n| Case sensitivity  | Depends on filesystem (usually insensitive) |\n| Homebrew symlinks | Complex symlink chains in `\u002Fopt\u002Fhomebrew\u002F`  |\n| Poetry cache      | `~\u002FLibrary\u002FCaches\u002Fpypoetry\u002Fvirtualenvs`     |\n| XCode Python      | Different from Command Line Tools Python    |\n\n### Linux\n\n| Issue            | Details                                 |\n| ---------------- | --------------------------------------- |\n| Case sensitivity | Paths ARE case-sensitive                |\n| \u002Fbin symlinks    | `\u002Fbin` may be symlink to `\u002Fusr\u002Fbin`     |\n| XDG directories  | `~\u002F.local\u002Fshare\u002Fvirtualenvs` for pipenv |\n| Poetry cache     | `~\u002F.cache\u002Fpypoetry\u002Fvirtualenvs`         |\n| Hidden files     | Dot-prefixed files are hidden           |\n\n## Common Patterns\n\n### Getting Platform-Specific Paths\n\n```typescript\nimport * as os from 'os';\nimport * as path from 'path';\n\n\u002F\u002F Home directory\nconst home = os.homedir(); \u002F\u002F Works cross-platform\n\n\u002F\u002F Construct paths correctly\nconst venvPath = path.join(home, '.venv', 'bin', 'python');\n\u002F\u002F Windows: C:\\Users\\name\\.venv\\bin\\python\n\u002F\u002F macOS:   \u002FUsers\u002Fname\u002F.venv\u002Fbin\u002Fpython\n\u002F\u002F Linux:   \u002Fhome\u002Fname\u002F.venv\u002Fbin\u002Fpython\n```\n\n### Environment-Specific Executable Names\n\n```typescript\nconst isWindows = process.platform === 'win32';\n\n\u002F\u002F Python executable\nconst pythonExe = isWindows ? 'python.exe' : 'python';\n\n\u002F\u002F Activate script\nconst activateScript = isWindows\n    ? path.join(venvPath, 'Scripts', 'activate.bat')\n    : path.join(venvPath, 'bin', 'activate');\n\n\u002F\u002F pyenv command\nconst pyenvCmd = isWindows ? 'pyenv.bat' : 'pyenv';\n```\n\n### Normalizing Paths for Comparison\n\n```typescript\nimport { normalizePath } from '.\u002Fcommon\u002Futils\u002FpathUtils';\n\n\u002F\u002F Use normalizePath() for map keys and comparisons\nconst key = normalizePath(filePath);\ncache.set(key, value);\n\n\u002F\u002F But preserve original for user display\ntraceLog(`Discovered: ${filePath}`); \u002F\u002F Keep original\n```\n\n### Handling Uri | string Union Types\n\n```typescript\n\u002F\u002F ❌ WRONG: Assuming Uri\nfunction process(locator: Uri | string) {\n    const fsPath = locator.fsPath; \u002F\u002F Crashes if string!\n}\n\n\u002F\u002F ✅ RIGHT: Handle both types\nfunction process(locator: Uri | string) {\n    const fsPath = locator instanceof Uri ? locator.fsPath : locator;\n\n    \u002F\u002F Now normalize for comparisons\n    const normalized = path.resolve(fsPath);\n}\n```\n\n## File Existence Checks\n\n```typescript\nimport * as fs from 'fs';\nimport * as path from 'path';\n\n\u002F\u002F Check file exists (cross-platform)\nconst configPath = path.join(projectRoot, 'pyproject.toml');\nif (fs.existsSync(configPath)) {\n    \u002F\u002F File exists\n}\n\n\u002F\u002F Use async version when possible\nimport { promises as fsPromises } from 'fs';\ntry {\n    await fsPromises.access(configPath);\n    \u002F\u002F File exists\n} catch {\n    \u002F\u002F File does not exist\n}\n```\n\n## Shell Path Escaping\n\n```typescript\n\u002F\u002F ❌ WRONG: Unescaped paths in shell commands\nterminal.sendText(`python ${filePath}`);\n\u002F\u002F D:\\path\\file.py becomes \"D:pathfile.py\" in some shells!\n\n\u002F\u002F ✅ RIGHT: Quote paths\nterminal.sendText(`python \"${filePath}\"`);\n\n\u002F\u002F For Git Bash on Windows, escape backslashes\nconst shellPath = isGitBash ? filePath.replace(\u002F\\\\\u002Fg, '\u002F') : filePath;\n```\n\n## Testing Cross-Platform Code\n\nWhen testing path-related code:\n\n1. Test on Windows (cmd, PowerShell, Git Bash)\n2. Test on macOS (zsh, bash)\n3. Test on Linux (bash, fish)\n\nPay special attention to:\n\n- Paths with spaces: `C:\\Program Files\\Python`\n- Paths with Unicode: `~\u002Fпроекты\u002F`\n- Very long paths (>260 chars on Windows)\n- Paths with special characters: `$`, `&`, `(`, `)`\n","# Cross-Platform Path Handling\n\n**CRITICAL**: This extension runs on Windows, macOS, and Linux. Path bugs are the #1 source of issues.\n\n## Core Rules\n\n### Rule 1: Never Concatenate Paths with `\u002F`\n\n```typescript\n\u002F\u002F ❌ WRONG: POSIX-style path concatenation\nconst envPath = homeDir + '\u002F.venv\u002Fbin\u002Fpython';\n\n\u002F\u002F ✅ RIGHT: Use path.join()\nconst envPath = path.join(homeDir, '.venv', 'bin', 'python');\n```\n\n### Rule 2: Use path.resolve() for Comparisons, Not path.normalize()\n\n```typescript\n\u002F\u002F ❌ WRONG: path.normalize keeps relative paths relative on Windows\nconst normalized = path.normalize(fsPath);\n\u002F\u002F path.normalize('\\test') → '\\test' (still relative!)\n\n\u002F\u002F ✅ RIGHT: path.resolve adds drive letter on Windows\nconst normalized = path.resolve(fsPath);\n\u002F\u002F path.resolve('\\test') → 'C:\\test' (absolute!)\n\n\u002F\u002F When comparing paths, use resolve() on BOTH sides:\nconst pathA = path.resolve(fsPath);\nconst pathB = path.resolve(e.environmentPath.fsPath);\nreturn pathA === pathB;\n```\n\n### Rule 3: Use Uri.file().fsPath for VS Code Paths\n\n```typescript\n\u002F\u002F ❌ WRONG: Raw string comparison\nif (filePath === otherPath) {\n}\n\n\u002F\u002F ✅ RIGHT: Compare fsPath to fsPath\nimport { Uri } from 'vscode';\nconst fsPathA = Uri.file(pathA).fsPath;\nconst fsPathB = Uri.file(pathB).fsPath;\nif (fsPathA === fsPathB) {\n}\n```\n\n## Platform-Specific Gotchas\n\n### Windows\n\n| Issue              | Details                                      |\n| ------------------ | -------------------------------------------- |\n| Drive letters      | Paths start with `C:\\`, `D:\\`, etc.          |\n| Backslashes        | Separator is `\\`, not `\u002F`                    |\n| Case insensitivity | `C:\\Test` equals `c:\\test`                   |\n| Long paths         | Paths >260 chars may fail                    |\n| Mapped drives      | `Z:\\` may not be accessible                  |\n| pyenv-win          | Uses `pyenv.bat`, not `pyenv` or `pyenv.exe` |\n| Poetry cache       | `%LOCALAPPDATA%\\pypoetry\\Cache\\virtualenvs`  |\n| UNC paths          | `\\\\server\\share\\` format                     |\n\n### macOS\n\n| Issue             | Details                                     |\n| ----------------- | ------------------------------------------- |\n| Case sensitivity  | Depends on filesystem (usually insensitive) |\n| Homebrew symlinks | Complex symlink chains in `\u002Fopt\u002Fhomebrew\u002F`  |\n| Poetry cache      | `~\u002FLibrary\u002FCaches\u002Fpypoetry\u002Fvirtualenvs`     |\n| XCode Python      | Different from Command Line Tools Python    |\n\n### Linux\n\n| Issue            | Details                                 |\n| ---------------- | --------------------------------------- |\n| Case sensitivity | Paths ARE case-sensitive                |\n| \u002Fbin symlinks    | `\u002Fbin` may be symlink to `\u002Fusr\u002Fbin`     |\n| XDG directories  | `~\u002F.local\u002Fshare\u002Fvirtualenvs` for pipenv |\n| Poetry cache     | `~\u002F.cache\u002Fpypoetry\u002Fvirtualenvs`         |\n| Hidden files     | Dot-prefixed files are hidden           |\n\n## Common Patterns\n\n### Getting Platform-Specific Paths\n\n```typescript\nimport * as os from 'os';\nimport * as path from 'path';\n\n\u002F\u002F Home directory\nconst home = os.homedir(); \u002F\u002F Works cross-platform\n\n\u002F\u002F Construct paths correctly\nconst venvPath = path.join(home, '.venv', 'bin', 'python');\n\u002F\u002F Windows: C:\\Users\\name\\.venv\\bin\\python\n\u002F\u002F macOS:   \u002FUsers\u002Fname\u002F.venv\u002Fbin\u002Fpython\n\u002F\u002F Linux:   \u002Fhome\u002Fname\u002F.venv\u002Fbin\u002Fpython\n```\n\n### Environment-Specific Executable Names\n\n```typescript\nconst isWindows = process.platform === 'win32';\n\n\u002F\u002F Python executable\nconst pythonExe = isWindows ? 'python.exe' : 'python';\n\n\u002F\u002F Activate script\nconst activateScript = isWindows\n    ? path.join(venvPath, 'Scripts', 'activate.bat')\n    : path.join(venvPath, 'bin', 'activate');\n\n\u002F\u002F pyenv command\nconst pyenvCmd = isWindows ? 'pyenv.bat' : 'pyenv';\n```\n\n### Normalizing Paths for Comparison\n\n```typescript\nimport { normalizePath } from '.\u002Fcommon\u002Futils\u002FpathUtils';\n\n\u002F\u002F Use normalizePath() for map keys and comparisons\nconst key = normalizePath(filePath);\ncache.set(key, value);\n\n\u002F\u002F But preserve original for user display\ntraceLog(`Discovered: ${filePath}`); \u002F\u002F Keep original\n```\n\n### Handling Uri | string Union Types\n\n```typescript\n\u002F\u002F ❌ WRONG: Assuming Uri\nfunction process(locator: Uri | string) {\n    const fsPath = locator.fsPath; \u002F\u002F Crashes if string!\n}\n\n\u002F\u002F ✅ RIGHT: Handle both types\nfunction process(locator: Uri | string) {\n    const fsPath = locator instanceof Uri ? locator.fsPath : locator;\n\n    \u002F\u002F Now normalize for comparisons\n    const normalized = path.resolve(fsPath);\n}\n```\n\n## File Existence Checks\n\n```typescript\nimport * as fs from 'fs';\nimport * as path from 'path';\n\n\u002F\u002F Check file exists (cross-platform)\nconst configPath = path.join(projectRoot, 'pyproject.toml');\nif (fs.existsSync(configPath)) {\n    \u002F\u002F File exists\n}\n\n\u002F\u002F Use async version when possible\nimport { promises as fsPromises } from 'fs';\ntry {\n    await fsPromises.access(configPath);\n    \u002F\u002F File exists\n} catch {\n    \u002F\u002F File does not exist\n}\n```\n\n## Shell Path Escaping\n\n```typescript\n\u002F\u002F ❌ WRONG: Unescaped paths in shell commands\nterminal.sendText(`python ${filePath}`);\n\u002F\u002F D:\\path\\file.py becomes \"D:pathfile.py\" in some shells!\n\n\u002F\u002F ✅ RIGHT: Quote paths\nterminal.sendText(`python \"${filePath}\"`);\n\n\u002F\u002F For Git Bash on Windows, escape backslashes\nconst shellPath = isGitBash ? filePath.replace(\u002F\\\\\u002Fg, '\u002F') : filePath;\n```\n\n## Testing Cross-Platform Code\n\nWhen testing path-related code:\n\n1. Test on Windows (cmd, PowerShell, Git Bash)\n2. Test on macOS (zsh, bash)\n3. Test on Linux (bash, fish)\n\nPay special attention to:\n\n- Paths with spaces: `C:\\Program Files\\Python`\n- Paths with Unicode: `~\u002Fпроекты\u002F`\n- Very long paths (>260 chars on Windows)\n- Paths with special characters: `$`, `&`, `(`, `)`\n",{"name":5,"description":7,"argument-hint":23,"user-invocable":19},"Review path handling in [file or component]","main","900ea3c9eb045fd5b0317dc1103777ecf3ea4aeb","skills\u002Fcross-platform-paths",0,"https:\u002F\u002Fgithub.com\u002Fnguyenhungtran18\u002Fskill-and-tool-tracker","https:\u002F\u002Fnguyenhungtran18.github.io\u002Fskill-and-tool-tracker\u002F","https:\u002F\u002Fgithub.com\u002Fnguyenhungtran18","2026-08-31 18:36:09",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add nguyenhungtran18\u002Fskill-and-tool-tracker --skill cross-platform-paths",{"tool":38,"command":39},"bunx","bunx skills add nguyenhungtran18\u002Fskill-and-tool-tracker --skill cross-platform-paths",{"tool":41,"command":42},"pnpm","pnpm dlx skills add nguyenhungtran18\u002Fskill-and-tool-tracker --skill cross-platform-paths","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnguyenhungtran18\u002Fskill-and-tool-tracker\u002Fblob\u002Fmain\u002Fskills\u002Fcross-platform-paths\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M7BVP4P83TK60JZ4P8RP9VP7","xcode-project-setup","Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).","https:\u002F\u002Fgithub.com\u002Fnguyenhungtran18\u002Fskill-and-tool-tracker\u002Fblob\u002Fmain\u002Fskills\u002Fxcode_project_setup\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M7BVP01K4CSJJ8G90FT8S2D5","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment","https:\u002F\u002Fgithub.com\u002Fnguyenhungtran18\u002Fskill-and-tool-tracker\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7BVNY22GXD871GYTSH599F1","writing-plans","Use when you have a spec or requirements for a multi-step task, before touching code","https:\u002F\u002Fgithub.com\u002Fnguyenhungtran18\u002Fskill-and-tool-tracker\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7BVNQWF24RNKA8A4KM2HJ3T","workflow-skill-creator","Distills a completed user workflow or interaction into a reusable agent skill. Use when the user asks to turn their workflow, interaction, or multi-step process into a skill, or when they say \"make this a skill\", \"create a skill from what we just did\", \"package this workflow\" or similar. Do not use for creating skills from scratch without an existing workflow (use a generic skill-creator for that).","https:\u002F\u002Fgithub.com\u002Fnguyenhungtran18\u002Fskill-and-tool-tracker\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow_skill_creator\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M7BVNNY67XPCQAQHY3FBKDGC","verify-and-stop","Prove existing work meets acceptance conditions without expanding scope. Use for validation-only tasks, completion checks, focused gate runs, and last-mile proof.","https:\u002F\u002Fgithub.com\u002Fnguyenhungtran18\u002Fskill-and-tool-tracker\u002Fblob\u002Fmain\u002Fskills\u002Fverify-and-stop\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M7BVNKB4Z7SZT85B73ZZ90Y6","verification-before-completion","Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always","https:\u002F\u002Fgithub.com\u002Fnguyenhungtran18\u002Fskill-and-tool-tracker\u002Fblob\u002Fmain\u002Fskills\u002Fverification-before-completion\u002FSKILL.md",[],[]]