pawmode 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +337 -0
  3. package/dist/index.js +2925 -0
  4. package/dist/permissions-BHOAvP8i.js +55 -0
  5. package/dist/permissions-CoaVX2ZM.js +3 -0
  6. package/dist/skills-CJ_pyPlv.js +53 -0
  7. package/dist/skills-DwMXaN3R.js +3 -0
  8. package/package.json +60 -0
  9. package/skills/c-ai/SKILL.md +68 -0
  10. package/skills/c-apps/SKILL.md +42 -0
  11. package/skills/c-bluetooth/SKILL.md +42 -0
  12. package/skills/c-briefing/SKILL.md +80 -0
  13. package/skills/c-browser/SKILL.md +66 -0
  14. package/skills/c-calendar/SKILL.md +47 -0
  15. package/skills/c-core/SKILL.md +83 -0
  16. package/skills/c-cron/SKILL.md +58 -0
  17. package/skills/c-display/SKILL.md +45 -0
  18. package/skills/c-email/SKILL.md +54 -0
  19. package/skills/c-files/SKILL.md +52 -0
  20. package/skills/c-github/SKILL.md +61 -0
  21. package/skills/c-jira/SKILL.md +66 -0
  22. package/skills/c-lights/SKILL.md +55 -0
  23. package/skills/c-linear/SKILL.md +64 -0
  24. package/skills/c-location/SKILL.md +47 -0
  25. package/skills/c-memory/SKILL.md +86 -0
  26. package/skills/c-messaging/SKILL.md +51 -0
  27. package/skills/c-music/SKILL.md +59 -0
  28. package/skills/c-network/SKILL.md +71 -0
  29. package/skills/c-notes/SKILL.md +45 -0
  30. package/skills/c-notify/SKILL.md +39 -0
  31. package/skills/c-notion/SKILL.md +53 -0
  32. package/skills/c-obsidian/SKILL.md +63 -0
  33. package/skills/c-research/SKILL.md +45 -0
  34. package/skills/c-screen/SKILL.md +55 -0
  35. package/skills/c-secrets/SKILL.md +62 -0
  36. package/skills/c-slack/SKILL.md +46 -0
  37. package/skills/c-social/SKILL.md +57 -0
  38. package/skills/c-speakers/SKILL.md +59 -0
  39. package/skills/c-system/SKILL.md +72 -0
  40. package/skills/c-tasks/SKILL.md +60 -0
  41. package/skills/c-telegram/SKILL.md +66 -0
  42. package/skills/c-tracking/SKILL.md +46 -0
  43. package/skills/c-video/SKILL.md +56 -0
  44. package/skills/c-voice/SKILL.md +58 -0
@@ -0,0 +1,45 @@
1
+ ---
2
+ name: c-display
3
+ description: Control display brightness and safely move files to trash instead of permanently deleting with rm.
4
+ tags: [display, brightness, trash, safety]
5
+ ---
6
+
7
+ # Display & Safety
8
+
9
+ ## brightness
10
+
11
+ ```bash
12
+ # Get current brightness (0.0 to 1.0)
13
+ brightness -l
14
+
15
+ # Set brightness to 80%
16
+ brightness 0.8
17
+
18
+ # Set brightness to minimum
19
+ brightness 0.0
20
+
21
+ # Set brightness to maximum
22
+ brightness 1.0
23
+ ```
24
+
25
+ ## trash (macos-trash)
26
+
27
+ Safe alternative to `rm` — moves files to macOS Trash:
28
+
29
+ ```bash
30
+ # Move file to trash
31
+ trash file.txt
32
+
33
+ # Move multiple files
34
+ trash file1.txt file2.txt dir/
35
+
36
+ # Move with confirmation prompt
37
+ trash --interactive file.txt
38
+ ```
39
+
40
+ ## Guidelines
41
+
42
+ - Use `trash` instead of `rm` when the user might want to recover files
43
+ - Use `rm` only for temporary/generated files where recovery isn't needed
44
+ - Brightness value is 0.0 (off) to 1.0 (max)
45
+ - `brightness -l` lists all displays when multiple monitors connected
@@ -0,0 +1,54 @@
1
+ ---
2
+ name: c-email
3
+ description: Read, send, search, and label email via gog (Gmail CLI) or himalaya (IMAP). Supports inbox management, drafting replies, thread viewing, and label/folder operations across Gmail and standard IMAP accounts.
4
+ tags: [email, gmail, imap, gog, himalaya, inbox]
5
+ ---
6
+
7
+ This skill manages email via `gog` (Gmail) or `himalaya` (IMAP). Check availability with `which gog himalaya`.
8
+
9
+ ## Gmail — `gog mail` (gogcli)
10
+
11
+ ```bash
12
+ gog mail list # List inbox messages
13
+ gog mail list --label "INBOX" --max 20
14
+ gog mail read <message-id> # Read a message
15
+ gog mail send --to "user@example.com" --subject "Subject" --body "Body"
16
+ gog mail reply <message-id> --body "Reply text"
17
+ gog mail search "from:alice subject:report"
18
+ gog mail search "is:unread after:2026/02/01"
19
+ gog mail label add <message-id> "Label"
20
+ gog mail label remove <message-id> "INBOX"
21
+ gog mail archive <message-id>
22
+ gog mail trash <message-id>
23
+ gog mail labels # List all labels
24
+ gog mail thread <thread-id> # View full thread
25
+ ```
26
+
27
+ ## IMAP — `himalaya`
28
+
29
+ ```bash
30
+ himalaya list # List inbox
31
+ himalaya list -m 50 # List last 50 messages
32
+ himalaya read <id> # Read message
33
+ himalaya write # Compose new message (interactive)
34
+ himalaya send --to "user@example.com" --subject "Subj" < body.txt
35
+ himalaya reply <id>
36
+ himalaya forward <id>
37
+ himalaya search "subject:report"
38
+ himalaya move <id> "Archive" # Move to folder
39
+ himalaya delete <id>
40
+ himalaya folders # List folders
41
+ himalaya --account work list # Use a specific account
42
+ ```
43
+
44
+ ## Usage Guidelines
45
+
46
+ - Prefer `gog` for Gmail accounts; prefer `himalaya` for non-Gmail IMAP.
47
+ - Use `gog mail search` with Gmail search syntax (from:, to:, subject:, is:unread, has:attachment).
48
+ - For sending with body content, pass the body directly or pipe a file.
49
+ - Both tools require prior authentication setup.
50
+
51
+ ## Notes
52
+
53
+ - `gog` requires Google OAuth configured via `gog auth`.
54
+ - `himalaya` requires IMAP credentials in `~/.config/himalaya/config.toml`.
@@ -0,0 +1,52 @@
1
+ ---
2
+ name: c-files
3
+ description: Sync files to Google Drive, S3, Dropbox, OneDrive, and 70+ cloud providers using rclone.
4
+ tags: [files, cloud, sync, backup, storage]
5
+ ---
6
+
7
+ # Cloud Files (rclone)
8
+
9
+ ```bash
10
+ # List configured remotes
11
+ rclone listremotes
12
+
13
+ # List files in a remote
14
+ rclone ls remote:path
15
+ rclone lsd remote:path # directories only
16
+
17
+ # Copy files to/from cloud
18
+ rclone copy local/path remote:path
19
+ rclone copy remote:path local/path
20
+
21
+ # Sync (make remote match local — deletes extra files on remote)
22
+ rclone sync local/path remote:path
23
+
24
+ # Move files
25
+ rclone move local/path remote:path
26
+
27
+ # Interactive file explorer
28
+ rclone ncdu remote:path
29
+
30
+ # Mount cloud storage as local folder
31
+ rclone mount remote:path /mnt/cloud --daemon
32
+
33
+ # Check for differences
34
+ rclone check local/path remote:path
35
+
36
+ # Show storage usage
37
+ rclone about remote:
38
+ ```
39
+
40
+ ## Setup
41
+
42
+ Run `rclone config` to add remotes. Supports:
43
+ - Google Drive, S3, Dropbox, OneDrive, Backblaze B2
44
+ - Azure Blob, SFTP, FTP, WebDAV
45
+ - 70+ providers total
46
+
47
+ ## Guidelines
48
+
49
+ - `rclone sync` deletes files on destination — use `rclone copy` if unsure
50
+ - Always confirm before sync operations that delete remote files
51
+ - Use `--dry-run` flag to preview what would change
52
+ - Use `rclone check` to verify files match without transferring
@@ -0,0 +1,61 @@
1
+ ---
2
+ name: c-github
3
+ description: Interact with GitHub using the `gh` CLI and `jq`. Manage PRs, issues, repositories, and Actions workflows. Make raw API calls with `gh api` for anything not covered by built-in commands.
4
+ tags: [github, git, prs, issues, actions, ci, repos, api]
5
+ ---
6
+
7
+ ## What This Skill Does
8
+
9
+ Uses `gh` (GitHub CLI) and `jq` to manage GitHub resources including pull requests, issues, repositories, and Actions. Supports raw API calls for advanced queries.
10
+
11
+ ## CLI Tools: `gh` + `jq`
12
+
13
+ ### Pull Requests
14
+
15
+ ```bash
16
+ gh pr list # List open PRs
17
+ gh pr view 123 # View PR details
18
+ gh pr create --title "Fix bug" --body "..." --base main
19
+ gh pr merge 123 --squash
20
+ gh pr checkout 123
21
+ gh pr review 123 --approve
22
+ ```
23
+
24
+ ### Issues
25
+
26
+ ```bash
27
+ gh issue list --state open
28
+ gh issue view 42
29
+ gh issue create --title "Bug" --body "..." --label bug
30
+ gh issue close 42
31
+ gh issue comment 42 --body "Fixed in #123"
32
+ ```
33
+
34
+ ### Actions / CI
35
+
36
+ ```bash
37
+ gh run list # List recent workflow runs
38
+ gh run view 123456789 # View run details
39
+ gh run watch # Watch current run live
40
+ gh workflow run deploy.yml
41
+ ```
42
+
43
+ ### API Calls with `jq`
44
+
45
+ ```bash
46
+ gh api repos/{owner}/{repo}/pulls | jq '.[].title'
47
+ gh api /user/repos | jq '.[].full_name'
48
+ gh api graphql -f query='{ viewer { login } }'
49
+ ```
50
+
51
+ ## Usage Guidelines
52
+
53
+ 1. Default to the current repo context when no `--repo` flag is specified.
54
+ 2. Use `jq` to filter and format `gh api` JSON output for readability.
55
+ 3. For bulk operations, pipe `gh issue list --json number,title` into `jq`.
56
+ 4. Always confirm before closing issues or merging PRs.
57
+
58
+ ## Notes
59
+
60
+ - Requires `gh auth login` to be completed before use.
61
+ - Install: `brew install gh` and `brew install jq`
@@ -0,0 +1,66 @@
1
+ ---
2
+ name: c-jira
3
+ description: Manage Jira issues using `jira` (jira-cli). List and filter issues, create new tickets, transition issue status, manage sprints, and add comments — all from the terminal without opening a browser.
4
+ tags: [jira, issues, project-management, sprints, tickets, atlassian]
5
+ ---
6
+
7
+ ## What This Skill Does
8
+
9
+ Uses `jira` (jira-cli) to interact with Jira projects — listing issues, creating tickets, moving issues through workflow transitions, and managing sprints.
10
+
11
+ ## CLI Tool: `jira`
12
+
13
+ ### List & View Issues
14
+
15
+ ```bash
16
+ jira issue list # List issues assigned to you
17
+ jira issue list --project MYPROJ # Filter by project
18
+ jira issue list --status "In Progress" # Filter by status
19
+ jira issue list --type Bug # Filter by issue type
20
+ jira issue view MYPROJ-123 # View issue details
21
+ ```
22
+
23
+ ### Create Issues
24
+
25
+ ```bash
26
+ jira issue create \
27
+ --project MYPROJ \
28
+ --type Bug \
29
+ --summary "Login page throws 500 error" \
30
+ --body "Steps to reproduce: ..." \
31
+ --priority High \
32
+ --label backend
33
+ ```
34
+
35
+ ### Transitions
36
+
37
+ ```bash
38
+ jira issue move MYPROJ-123 "In Progress"
39
+ jira issue move MYPROJ-123 "Done"
40
+ jira issue move MYPROJ-123 "In Review"
41
+ ```
42
+
43
+ ### Comments
44
+
45
+ ```bash
46
+ jira issue comment add MYPROJ-123 --body "Fixed in PR #456"
47
+ ```
48
+
49
+ ### Sprints
50
+
51
+ ```bash
52
+ jira sprint list --project MYPROJ # List sprints
53
+ jira sprint add MYPROJ-123 --sprint 42 # Add issue to sprint
54
+ ```
55
+
56
+ ## Usage Guidelines
57
+
58
+ 1. Always use the full issue key (e.g., `MYPROJ-123`) in commands.
59
+ 2. Run `jira issue list` before creating tickets to check for existing duplicates.
60
+ 3. Use `jira issue move` to transition issues — confirm the valid transition names with `jira issue view` first.
61
+ 4. When the user says "close" or "resolve" an issue, use the appropriate transition name for their workflow.
62
+
63
+ ## Notes
64
+
65
+ - Requires `jira init` to configure server URL and credentials before use.
66
+ - Install: `brew install ankitpokhrel/jira-cli/jira-cli`
@@ -0,0 +1,55 @@
1
+ ---
2
+ name: c-lights
3
+ description: Control Philips Hue smart lights using the `openhue` CLI. Turn lights on/off, adjust brightness and color, activate scenes, and manage rooms and groups.
4
+ tags: [hue, lights, smart-home, openhue, philips, automation]
5
+ ---
6
+
7
+ ## What This Skill Does
8
+
9
+ Enables Claude to control Philips Hue smart lighting — individual bulbs, rooms, and scenes — using the `openhue` CLI.
10
+
11
+ ## Available CLI Tool: `openhue`
12
+
13
+ ### Common Commands
14
+
15
+ ```bash
16
+ # List all lights
17
+ openhue get lights
18
+
19
+ # List all rooms/groups
20
+ openhue get rooms
21
+
22
+ # Turn a light on or off
23
+ openhue set light "Desk Lamp" --on
24
+ openhue set light "Desk Lamp" --off
25
+
26
+ # Set brightness (0-100)
27
+ openhue set light "Bedroom" --brightness 75
28
+
29
+ # Set color by name or hex
30
+ openhue set light "Living Room" --color red
31
+ openhue set light "Living Room" --color "#FF6600"
32
+
33
+ # Set color temperature (warm to cool, in mirek)
34
+ openhue set light "Kitchen" --color-temp 370
35
+
36
+ # Control an entire room
37
+ openhue set room "Living Room" --on --brightness 80
38
+
39
+ # List available scenes
40
+ openhue get scenes
41
+
42
+ # Activate a scene
43
+ openhue set scene "Relax" --room "Living Room"
44
+ ```
45
+
46
+ ## Usage Guidelines
47
+
48
+ - Use room-level commands when the user refers to a space, not a specific bulb
49
+ - Brightness is 0–100; color-temp ranges roughly 153 (cool) to 500 (warm)
50
+ - List lights/rooms first if unsure of exact names
51
+
52
+ ## Notes
53
+
54
+ - Requires `openhue` configured with your Hue Bridge IP and API key
55
+ - Bridge must be on the same local network
@@ -0,0 +1,64 @@
1
+ ---
2
+ name: c-linear
3
+ description: Manage Linear issues and projects using the `linear` CLI. List and filter issues, create new issues, update status, start work on a branch, and create linked pull requests directly from the terminal.
4
+ tags: [linear, issues, project-management, tasks, sprint, prs]
5
+ ---
6
+
7
+ ## What This Skill Does
8
+
9
+ Uses the `linear` CLI to manage Linear issues — list, create, update, and transition issues, as well as start work and create linked PRs.
10
+
11
+ ## CLI Tool: `linear`
12
+
13
+ ### List & View Issues
14
+
15
+ ```bash
16
+ linear issue list # List your assigned issues
17
+ linear issue list --team ENG # Filter by team
18
+ linear issue list --state "In Progress" # Filter by state
19
+ linear issue view ENG-123 # View issue details
20
+ ```
21
+
22
+ ### Create Issues
23
+
24
+ ```bash
25
+ linear issue create \
26
+ --title "Fix login redirect bug" \
27
+ --description "Users are redirected to /home instead of /dashboard" \
28
+ --team ENG \
29
+ --priority 2 \
30
+ --label bug
31
+ ```
32
+
33
+ ### Update & Transition Issues
34
+
35
+ ```bash
36
+ linear issue update ENG-123 --state "In Progress"
37
+ linear issue update ENG-123 --assignee me
38
+ linear issue update ENG-123 --priority 1
39
+ ```
40
+
41
+ ### Start Work
42
+
43
+ ```bash
44
+ # Creates a git branch linked to the issue
45
+ linear issue start ENG-123
46
+ ```
47
+
48
+ ### Create a PR
49
+
50
+ ```bash
51
+ # Creates a PR linked to the Linear issue
52
+ linear pr create ENG-123
53
+ ```
54
+
55
+ ## Usage Guidelines
56
+
57
+ 1. Use `linear issue list` before creating issues to avoid duplicates.
58
+ 2. When starting work, `linear issue start` handles branch creation and status update in one command.
59
+ 3. Use issue identifiers (e.g., `ENG-123`) consistently — they are case-insensitive.
60
+
61
+ ## Notes
62
+
63
+ - Requires `linear auth` to be completed before use.
64
+ - Priority levels: 1 = Urgent, 2 = High, 3 = Medium, 4 = Low
@@ -0,0 +1,47 @@
1
+ ---
2
+ name: c-location
3
+ description: Search Apple Maps, find nearby places, and get directions using the `goplaces` CLI. Supports keyword searches, category filters (restaurants, coffee, gas), and turn-by-turn directions by driving, walking, or transit.
4
+ tags: [maps, location, apple-maps, directions, places, search]
5
+ ---
6
+
7
+ ## What This Skill Does
8
+
9
+ Queries Apple Maps via the `goplaces` CLI to search for places, find businesses nearby, and get directions between locations.
10
+
11
+ ## CLI Tool: `goplaces`
12
+
13
+ ### Common Commands
14
+
15
+ ```bash
16
+ # Search for a place by name or keyword
17
+ goplaces search "coffee shops near downtown Austin"
18
+
19
+ # Find nearby places by category
20
+ goplaces nearby "pizza"
21
+ goplaces nearby "gas station"
22
+
23
+ # Get directions between two locations
24
+ goplaces directions "Austin TX" "San Antonio TX"
25
+ goplaces directions --mode walking "Zilker Park" "South Congress Ave"
26
+
27
+ # Get details about a specific place
28
+ goplaces details "Barton Springs Pool, Austin"
29
+ ```
30
+
31
+ ### Transport Modes
32
+
33
+ - `--mode driving` (default)
34
+ - `--mode walking`
35
+ - `--mode transit`
36
+
37
+ ## Usage Guidelines
38
+
39
+ 1. Use natural language for location queries — `goplaces` handles geocoding automatically.
40
+ 2. For "nearby" searches, the current device location is used unless a starting point is specified.
41
+ 3. When providing directions, confirm origin and destination with the user if ambiguous.
42
+ 4. Present results as a numbered list when multiple places are returned.
43
+
44
+ ## Notes
45
+
46
+ - Requires macOS with location services enabled for proximity searches.
47
+ - Results are sourced from Apple Maps — coverage quality varies by region.
@@ -0,0 +1,86 @@
1
+ ---
2
+ name: c-memory
3
+ description: Persistent memory across Claude Code sessions — remember facts, preferences, and context
4
+ tags: [memory, context, persistence]
5
+ ---
6
+
7
+ # Memory — Persistent Context
8
+
9
+ Store and recall facts, preferences, and context across Claude Code sessions.
10
+
11
+ ## How It Works
12
+
13
+ Memory lives in `~/.claude/memory/` as plain markdown files. Read them at session start, write to them when you learn something important.
14
+
15
+ ## Directory Structure
16
+
17
+ ```
18
+ ~/.claude/memory/
19
+ ├── MEMORY.md # Key facts — always read this first
20
+ ├── people.md # People the user mentions (names, roles, preferences)
21
+ ├── preferences.md # User preferences (tools, workflows, habits)
22
+ ├── projects.md # Active projects and their context
23
+ └── journal.md # Session log — append-only, dated entries
24
+ ```
25
+
26
+ ## Session Start
27
+
28
+ At the beginning of every session, read `~/.claude/memory/MEMORY.md` to load context. This file should be concise — under 100 lines.
29
+
30
+ ## When to Save
31
+
32
+ Save to memory when the user:
33
+ - Shares their name, role, or preferences
34
+ - Mentions people they work with
35
+ - Describes a project or recurring task
36
+ - Says "remember this" or "don't forget"
37
+ - Corrects you about something
38
+
39
+ ## Writing Rules
40
+
41
+ - **MEMORY.md**: Key facts only. Keep under 100 lines. Update, don't append.
42
+ - **people.md**: Name, role, relationship, preferences. One section per person.
43
+ - **preferences.md**: Tools, workflows, communication preferences.
44
+ - **projects.md**: Project name, status, key files, context.
45
+ - **journal.md**: Append a dated entry at the end of each session summarizing what was done.
46
+
47
+ ## Commands
48
+
49
+ ```bash
50
+ # Read memory
51
+ cat ~/.claude/memory/MEMORY.md
52
+
53
+ # List memory files
54
+ ls ~/.claude/memory/
55
+
56
+ # Append to journal
57
+ echo "## $(date +%Y-%m-%d)" >> ~/.claude/memory/journal.md
58
+ ```
59
+
60
+ ## Example MEMORY.md
61
+
62
+ ```markdown
63
+ # Memory
64
+
65
+ ## User
66
+ - Name: Alex
67
+ - Role: Frontend developer
68
+ - Prefers TypeScript, uses Neovim
69
+ - Timezone: PST
70
+
71
+ ## Active Projects
72
+ - ctrl.build — DeFi workflow automation (Next.js + Solidity)
73
+ - openpaw — CLI tool for Claude Code setup
74
+
75
+ ## Preferences
76
+ - Concise responses, no emoji unless asked
77
+ - Always use bun instead of npm
78
+ - Dark mode everything
79
+ ```
80
+
81
+ ## Guidelines
82
+
83
+ - Never store passwords, API keys, or secrets in memory files
84
+ - Always ask before overwriting existing memory entries
85
+ - If memory files don't exist, create them on first write
86
+ - Keep MEMORY.md focused — move details to topic-specific files
@@ -0,0 +1,51 @@
1
+ ---
2
+ name: c-messaging
3
+ description: Send and read messages via imsg (iMessage) and wacli (WhatsApp). Supports sending to individuals or groups, reading recent conversations, and checking unread messages across both platforms.
4
+ tags: [messaging, imessage, whatsapp, imsg, wacli, sms]
5
+ ---
6
+
7
+ This skill manages messaging via `imsg` (iMessage/SMS) and `wacli` (WhatsApp). Check availability with `which imsg wacli`.
8
+
9
+ ## iMessage & SMS — `imsg`
10
+
11
+ ```bash
12
+ imsg send "Phone or Email" "Message text" # Send a message
13
+ imsg send "+14155551234" "Hello!"
14
+ imsg send "user@icloud.com" "Hey there"
15
+ imsg list # List recent conversations
16
+ imsg list --limit 10 # Last 10 conversations
17
+ imsg read "+14155551234" # Read conversation with contact
18
+ imsg read "+14155551234" --limit 20 # Read last 20 messages
19
+ imsg unread # Show unread messages
20
+ imsg group send "Group Name" "Message" # Send to a group chat
21
+ imsg group list # List group chats
22
+ imsg contacts # List contacts
23
+ ```
24
+
25
+ ## WhatsApp — `wacli`
26
+
27
+ ```bash
28
+ wacli send "+14155551234" "Message text" # Send a message
29
+ wacli send "Contact Name" "Hello!" # Send by name (if in contacts)
30
+ wacli list # List recent chats
31
+ wacli read "+14155551234" # Read conversation
32
+ wacli read "+14155551234" --limit 20
33
+ wacli unread # Show unread messages
34
+ wacli group list # List WhatsApp groups
35
+ wacli group send "Group Name" "Message"
36
+ wacli status "Your status text" # Set WhatsApp status
37
+ ```
38
+
39
+ ## Usage Guidelines
40
+
41
+ - Use `imsg` for iMessage/SMS to Apple devices or phone numbers.
42
+ - Use `wacli` for WhatsApp contacts.
43
+ - Phone numbers should include country code (e.g., +1 for US).
44
+ - Check `imsg unread` or `wacli unread` before sending follow-ups.
45
+ - If a contact name is ambiguous, prefer using the phone number directly.
46
+
47
+ ## Notes
48
+
49
+ - `imsg` requires macOS and an active iMessage account.
50
+ - `wacli` requires WhatsApp to be linked — run `wacli auth` to scan QR code on first use.
51
+ - Both tools operate locally; no cloud API credentials required after initial auth.
@@ -0,0 +1,59 @@
1
+ ---
2
+ name: c-music
3
+ description: Control Spotify playback using the `spogo` CLI. Play, pause, skip, search tracks/albums/playlists, manage the queue, and browse your library.
4
+ tags: [spotify, music, playback, spogo, audio]
5
+ ---
6
+
7
+ ## What This Skill Does
8
+
9
+ Enables Claude to control Spotify playback and search music via the `spogo` CLI tool.
10
+
11
+ ## Available CLI Tool: `spogo`
12
+
13
+ ### Common Commands
14
+
15
+ ```bash
16
+ # Play/pause toggle
17
+ spogo play
18
+ spogo pause
19
+
20
+ # Skip to next or previous track
21
+ spogo next
22
+ spogo prev
23
+
24
+ # Search and play a track
25
+ spogo search track "Bohemian Rhapsody" --play
26
+
27
+ # Search an album and play it
28
+ spogo search album "Dark Side of the Moon" --play
29
+
30
+ # Search playlists
31
+ spogo search playlist "chill vibes"
32
+
33
+ # Play a specific playlist by name or URI
34
+ spogo playlist play "My Playlist"
35
+
36
+ # Add current track to queue
37
+ spogo queue add "spotify:track:TRACK_ID"
38
+
39
+ # Show current playback status
40
+ spogo status
41
+
42
+ # Set volume (0-100)
43
+ spogo volume 60
44
+
45
+ # List your saved playlists
46
+ spogo playlist list
47
+ ```
48
+
49
+ ## Usage Guidelines
50
+
51
+ - Use `spogo status` first to check what is currently playing
52
+ - When searching, confirm the result with the user before playing if ambiguous
53
+ - Volume is a 0–100 integer scale
54
+
55
+ ## Notes
56
+
57
+ - Requires `spogo` configured with Spotify OAuth credentials
58
+ - Playback requires an active Spotify Premium account
59
+ - Spotify must be open on at least one device for commands to work