Skip to content

Commit 50f4387

Browse files
mycollablabclaude
andcommitted
Make skill cross-platform: fix macOS-only paths for Windows/Linux
- Replace hardcoded /tmp/ with ${TMPDIR:-/tmp}/ (respects macOS per-user temp dir; falls back to /tmp on Linux; adds Windows PowerShell comments) - Expand Claude Desktop config path from macOS-only ~/Library/Application Support/Claude/ to a per-platform table (macOS / Linux / Windows) - Split sub-skills table into base-path-per-platform + relative sub-path so Windows users use %USERPROFILE%\.claude\skills\webex-cli\ correctly Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 7c39213 commit 50f4387

1 file changed

Lines changed: 32 additions & 13 deletions

File tree

skill/SKILL.md

Lines changed: 32 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -94,12 +94,17 @@ All other CC resources (site, team, users, global-variables, business-hour, audi
9494

9595
1. **Always redirect stderr separately** when capturing JSON output:
9696
```bash
97-
webex cc site list --orgid="$ORG" > /tmp/result.json 2>/tmp/error.log
97+
# Mac/Linux/WSL — $TMPDIR is set on macOS; falls back to /tmp on Linux
98+
webex cc site list --orgid="$ORG" > "${TMPDIR:-/tmp}/result.json" 2>"${TMPDIR:-/tmp}/error.log"
99+
# Windows PowerShell
100+
# webex cc site list --orgid="$ORG" > "$env:TEMP\result.json" 2> "$env:TEMP\error.log"
98101
```
99102

100103
2. **Use `--orgid=VALUE` syntax** (with `=`) for CC commands to avoid shell quoting issues. Do NOT use `--orgid "$VAR"` with a space — use `--orgid="$VAR"`.
101104

102105
3. **Write output to temp files first**, then read/analyze. Do NOT pipe webex output directly into python or jq in a single shell command — complex pipes can cause issues with the binary output.
106+
- Mac/Linux/WSL: use `"${TMPDIR:-/tmp}/filename.json"`
107+
- Windows PowerShell: use `"$env:TEMP\filename.json"`
103108

104109
4. **Check `--help` before guessing** subcommand names:
105110
```bash
@@ -127,29 +132,43 @@ claude mcp add webex -- webex mcp serve
127132
# Start server (loopback only, port 47890)
128133
webex mcp serve --http
129134
```
130-
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
135+
Add to your Claude Desktop config file, then restart Claude Desktop:
136+
137+
| Platform | Config path |
138+
|---|---|
139+
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
140+
| Linux | `~/.config/Claude/claude_desktop_config.json` |
141+
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
142+
131143
```json
132144
{
133145
"mcpServers": {
134146
"webex": { "url": "http://localhost:47890/mcp" }
135147
}
136148
}
137149
```
138-
Restart Claude Desktop. Use `--http-addr 127.0.0.1:<port>` to change the port.
150+
Use `--http-addr 127.0.0.1:<port>` to change the port.
139151
Only loopback addresses (127.x.x.x / ::1) are accepted — the server cannot bind to public interfaces.
140152

141153
## Sub-Skills
142154

143-
For detailed flags, body schemas, and usage examples, Read the sub-skill file before working in that area:
155+
For detailed flags, body schemas, and usage examples, Read the sub-skill file before working in that area.
156+
157+
Sub-skills are installed alongside this file. Resolve the base path for your platform:
158+
159+
| Platform | Skills base path |
160+
|---|---|
161+
| macOS / Linux | `~/.claude/skills/webex-cli/` |
162+
| Windows | `%USERPROFILE%\.claude\skills\webex-cli\` |
144163

145-
| Area | Installed path |
164+
| Area | Sub-path |
146165
|---|---|
147-
| Admin | `~/.claude/skills/webex-cli/admin/SKILL.md` |
148-
| Calling | `~/.claude/skills/webex-cli/calling/SKILL.md` |
149-
| Contact Center | `~/.claude/skills/webex-cli/cc/SKILL.md` |
150-
| Devices | `~/.claude/skills/webex-cli/device/SKILL.md` |
151-
| Meetings | `~/.claude/skills/webex-cli/meetings/SKILL.md` |
152-
| Messaging | `~/.claude/skills/webex-cli/messaging/SKILL.md` |
166+
| Admin | `admin/SKILL.md` |
167+
| Calling | `calling/SKILL.md` |
168+
| Contact Center | `cc/SKILL.md` |
169+
| Devices | `device/SKILL.md` |
170+
| Meetings | `meetings/SKILL.md` |
171+
| Messaging | `messaging/SKILL.md` |
153172

154173
## Quick Reference
155174

@@ -232,8 +251,8 @@ webex admin people list --output=table
232251
# Raw JSON (no formatting)
233252
webex admin people list --output=raw
234253

235-
# Save to file for processing
236-
webex admin people list > /tmp/people.json
254+
# Save to file for processing (Mac/Linux/WSL)
255+
webex admin people list > "${TMPDIR:-/tmp}/people.json"
237256
```
238257

239258
## Converged Recordings: Admin vs Non-Admin Endpoints

0 commit comments

Comments
 (0)