@oriro/orirocli 0.1.11 → 0.3.1

package/skills/social-sciences/social-sociology/SKILL.md

@@ -1,78 +1,78 @@
----
-watermark: ORIRO
-disable-model-invocation: true
-name: social-sociology
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-description: >
-
-
-  Sociology — social structures, inequality, institutions, culture, and sociological research.
-
-
-  Sources: OpenStax Economics (CC-BY), MIT OCW, World Bank, OECD, UN development resources.
----
-
-# Sociology
-
-## Core sociological concepts
-
-**Social structure:** Patterned social arrangements that influence human behavior. Institutions, norms, statuses, roles.
-**Social stratification:** Hierarchical arrangement of individuals and groups based on socioeconomic status, power, prestige.
-**Social mobility:** Movement between positions in stratification hierarchy.
-Vertical: Up or down the hierarchy.
-Horizontal: Lateral movement without status change.
-Intergenerational: Children vs. parents.
-
-## Major theoretical perspectives
-
-### Functionalism (Durkheim, Parsons)
-
-Society as an organism. Each part serves a function for the whole.
-Social institutions (family, religion, education, economy) maintain social order.
-Crime serves a function: clarifies norms, promotes solidarity.
-**Critique:** Conservative bias; ignores conflict and change.
-
-### Conflict theory (Marx, Weber)
-
-Society marked by conflict over scarce resources. Groups compete for power.
-Institutions serve the interests of dominant groups.
-**Weber:** Multiple dimensions of stratification: class (economic), status (prestige), party (political).
-**Critique:** Overemphasizes conflict; neglects consensus and stability.
-
-### Symbolic interactionism (Mead, Goffman)
-
-Focus on micro-level interactions. People create meaning through symbols and shared definitions.
-Goffman's dramaturgical model: Social life as theatrical performance. Front stage (public) vs. back stage (private).
-**Critique:** Ignores macro structures; how symbols become shared.
-
-## Socialization
-
-Process by which individuals learn the norms, values, and behaviors of their society.
-**Agents:** Family (primary), peers, schools, media, religion.
-**Primary:** Childhood. Core values, basic social skills, language.
-**Secondary:** Adulthood. New roles (college student, worker, parent).
-**Resocialization:** Replacing old behaviors with new ones. Total institutions: prisons, military, monasteries.
-
-## Social institutions
-
-**Family:** Organizes reproduction, child-rearing, economic cooperation. Forms vary widely across cultures.
-**Education:** Socialization, credentialing, social mobility pathway, reproduces inequality.
-**Religion:** Provides meaning, social solidarity (Durkheim), social control, can motivate both liberation and oppression.
-**Economy:** Production and distribution of goods. Capitalism, socialism, mixed.
-**Government/State:** Monopoly on legitimate use of force within territory (Weber). Law, order, public goods.
-**Medicine/Healthcare:** Defines and treats illness. Medicalization: applying medical frameworks to non-medical problems.
-
-## Social inequality
-
-**Race and ethnicity:** Socially constructed categories with real consequences.
-Racial disparities in wealth, health, education, criminal justice are documented and persistent.
-Structural racism: Policies and institutions that produce racial inequality without racist intent.
-
-**Gender:** Socially constructed. Gender gap in wages, leadership, unpaid labor.
-Intersectionality (Crenshaw): Multiple identities intersect and compound disadvantage.
-
-**Class:** Not just income — also wealth, cultural capital, social capital, lifestyle.
-Bourdieu: Cultural capital (knowledge, behavior, education) reproduces class across generations.
-
-Sources: OpenStax Introduction to Sociology (CC-BY), Giddens "Introduction to Sociology" (principles), Bourdieu "Distinction" (principles), C. Wright Mills "The Sociological Imagination" (principles), Bureau of the Census (free data)
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: social-sociology
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+
+  Sociology — social structures, inequality, institutions, culture, and sociological research.
+
+
+  Sources: OpenStax Economics (CC-BY), MIT OCW, World Bank, OECD, UN development resources.
+---
+
+# Sociology
+
+## Core sociological concepts
+
+**Social structure:** Patterned social arrangements that influence human behavior. Institutions, norms, statuses, roles.
+**Social stratification:** Hierarchical arrangement of individuals and groups based on socioeconomic status, power, prestige.
+**Social mobility:** Movement between positions in stratification hierarchy.
+Vertical: Up or down the hierarchy.
+Horizontal: Lateral movement without status change.
+Intergenerational: Children vs. parents.
+
+## Major theoretical perspectives
+
+### Functionalism (Durkheim, Parsons)
+
+Society as an organism. Each part serves a function for the whole.
+Social institutions (family, religion, education, economy) maintain social order.
+Crime serves a function: clarifies norms, promotes solidarity.
+**Critique:** Conservative bias; ignores conflict and change.
+
+### Conflict theory (Marx, Weber)
+
+Society marked by conflict over scarce resources. Groups compete for power.
+Institutions serve the interests of dominant groups.
+**Weber:** Multiple dimensions of stratification: class (economic), status (prestige), party (political).
+**Critique:** Overemphasizes conflict; neglects consensus and stability.
+
+### Symbolic interactionism (Mead, Goffman)
+
+Focus on micro-level interactions. People create meaning through symbols and shared definitions.
+Goffman's dramaturgical model: Social life as theatrical performance. Front stage (public) vs. back stage (private).
+**Critique:** Ignores macro structures; how symbols become shared.
+
+## Socialization
+
+Process by which individuals learn the norms, values, and behaviors of their society.
+**Agents:** Family (primary), peers, schools, media, religion.
+**Primary:** Childhood. Core values, basic social skills, language.
+**Secondary:** Adulthood. New roles (college student, worker, parent).
+**Resocialization:** Replacing old behaviors with new ones. Total institutions: prisons, military, monasteries.
+
+## Social institutions
+
+**Family:** Organizes reproduction, child-rearing, economic cooperation. Forms vary widely across cultures.
+**Education:** Socialization, credentialing, social mobility pathway, reproduces inequality.
+**Religion:** Provides meaning, social solidarity (Durkheim), social control, can motivate both liberation and oppression.
+**Economy:** Production and distribution of goods. Capitalism, socialism, mixed.
+**Government/State:** Monopoly on legitimate use of force within territory (Weber). Law, order, public goods.
+**Medicine/Healthcare:** Defines and treats illness. Medicalization: applying medical frameworks to non-medical problems.
+
+## Social inequality
+
+**Race and ethnicity:** Socially constructed categories with real consequences.
+Racial disparities in wealth, health, education, criminal justice are documented and persistent.
+Structural racism: Policies and institutions that produce racial inequality without racist intent.
+
+**Gender:** Socially constructed. Gender gap in wages, leadership, unpaid labor.
+Intersectionality (Crenshaw): Multiple identities intersect and compound disadvantage.
+
+**Class:** Not just income — also wealth, cultural capital, social capital, lifestyle.
+Bourdieu: Cultural capital (knowledge, behavior, education) reproduces class across generations.
+
+Sources: OpenStax Introduction to Sociology (CC-BY), Giddens "Introduction to Sociology" (principles), Bourdieu "Distinction" (principles), C. Wright Mills "The Sociological Imagination" (principles), Bureau of the Census (free data)

package/skills/songsee/SKILL.md

@@ -1,53 +1,53 @@
----
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-watermark: ORIRO
-disable-model-invocation: true
-name: songsee
-description: "Generate spectrograms and feature-panel visualizations from audio with the songsee CLI."
-homepage: https://github.com/oriro/songsee
-metadata:
-  {
-    "oriro":
-      {
-        "emoji": "🌊",
-        "requires": { "bins": ["songsee"] },
-        "install":
-          [
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "oriro/tap/songsee",
-              "bins": ["songsee"],
-              "label": "Install songsee (brew)",
-            },
-          ],
-      },
-  }
----
-
-# songsee
-
-Generate spectrograms + feature panels from audio.
-
-Quick start
-
-- Spectrogram: `songsee track.mp3`
-- Multi-panel: `songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux`
-- Time slice: `songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg`
-- Stdin: `cat track.mp3 | songsee - --format png -o out.png`
-
-Common flags
-
-- `--viz` list (repeatable or comma-separated)
-- `--style` palette (classic, magma, inferno, viridis, gray)
-- `--width` / `--height` output size
-- `--window` / `--hop` FFT settings
-- `--min-freq` / `--max-freq` frequency range
-- `--start` / `--duration` time slice
-- `--format` jpg|png
-
-Notes
-
-- WAV/MP3 decode native; other formats use ffmpeg if available.
-- Multiple `--viz` renders a grid.
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: songsee
+description: "Generate spectrograms and feature-panel visualizations from audio with the songsee CLI."
+homepage: https://github.com/oriro/songsee
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "🌊",
+        "requires": { "bins": ["songsee"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "oriro/tap/songsee",
+              "bins": ["songsee"],
+              "label": "Install songsee (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# songsee
+
+Generate spectrograms + feature panels from audio.
+
+Quick start
+
+- Spectrogram: `songsee track.mp3`
+- Multi-panel: `songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux`
+- Time slice: `songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg`
+- Stdin: `cat track.mp3 | songsee - --format png -o out.png`
+
+Common flags
+
+- `--viz` list (repeatable or comma-separated)
+- `--style` palette (classic, magma, inferno, viridis, gray)
+- `--width` / `--height` output size
+- `--window` / `--hop` FFT settings
+- `--min-freq` / `--max-freq` frequency range
+- `--start` / `--duration` time slice
+- `--format` jpg|png
+
+Notes
+
+- WAV/MP3 decode native; other formats use ffmpeg if available.
+- Multiple `--viz` renders a grid.

package/skills/sonoscli/SKILL.md

@@ -1,69 +1,69 @@
----
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-watermark: ORIRO
-disable-model-invocation: true
-name: sonoscli
-description: "Control Sonos speakers (discover/status/play/volume/group)."
-homepage: https://sonoscli.sh
-metadata:
-  {
-    "oriro":
-      {
-        "emoji": "🔊",
-        "requires": { "bins": ["sonos"] },
-        "install":
-          [
-            {
-              "id": "go",
-              "kind": "go",
-              "module": "github.com/oriro/sonoscli/cmd/sonos@latest",
-              "bins": ["sonos"],
-              "label": "Install sonoscli (go)",
-            },
-          ],
-      },
-  }
----
-
-# Sonos CLI
-
-Use `sonos` to control Sonos speakers on the local network.
-
-## Quick start
-
-- `sonos discover`
-- `sonos status --name "Kitchen"`
-- `sonos play|pause|stop --name "Kitchen"`
-- `sonos volume set 15 --name "Kitchen"`
-
-## Common tasks
-
-- Grouping: `sonos group status|join|unjoin|party|solo`
-- Favorites: `sonos favorites list|open`
-- Queue: `sonos queue list|play|clear`
-- Spotify search (via SMAPI): `sonos smapi search --service "Spotify" --category tracks "query"`
-
-## Notes
-
-- If SSDP fails, specify `--ip <speaker-ip>`.
-- Spotify Web API search is optional and requires `SPOTIFY_CLIENT_ID/SECRET`.
-- If there is an error, check the troubleshooting section and offer advice if there is a decent match.
-
-## Troubleshooting
-
-### `sonos discover` - `no route to host`
-
-- On error `Error: write udp4 0.0.0.0:64326->239.255.255.250:1900: sendto: no route to host (Command exited with code 1)`
-  - Note that the port number after `0.0.0.0:` is ephemeral and will change and the netmask may not match exactly either
-  - The `sendto: no route to host` should stay consistent
-- Advise the user that in `direct` (no Docker sandbox) mode on Mac OS that Settings -> Privacy & Security -> Local Network will need to be enabled for the top-level host parent process of the Gateway
-  - `node` if running via `launchd`
-  - `Terminal` if running the gateway directly in the terminal
-  - `Visual Studio Code` if running via terminal in VS Code
-- An alternative option is to use `sandbox` (docker container) with network access allowed for that sandbox
-
-### `sonos discover` - `bind: operation not permitted`
-
-- On error `Error: listen udp4 0.0.0.0:0: bind: operation not permitted`
-- Advise the user that they may be running via a Codex or other sandbox that does not permit network access (this can be replicated by running `sonos discover` within a Codex CLI session with sandbox enabled and not approving the escalation request)
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: sonoscli
+description: "Control Sonos speakers (discover/status/play/volume/group)."
+homepage: https://sonoscli.sh
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "🔊",
+        "requires": { "bins": ["sonos"] },
+        "install":
+          [
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/oriro/sonoscli/cmd/sonos@latest",
+              "bins": ["sonos"],
+              "label": "Install sonoscli (go)",
+            },
+          ],
+      },
+  }
+---
+
+# Sonos CLI
+
+Use `sonos` to control Sonos speakers on the local network.
+
+## Quick start
+
+- `sonos discover`
+- `sonos status --name "Kitchen"`
+- `sonos play|pause|stop --name "Kitchen"`
+- `sonos volume set 15 --name "Kitchen"`
+
+## Common tasks
+
+- Grouping: `sonos group status|join|unjoin|party|solo`
+- Favorites: `sonos favorites list|open`
+- Queue: `sonos queue list|play|clear`
+- Spotify search (via SMAPI): `sonos smapi search --service "Spotify" --category tracks "query"`
+
+## Notes
+
+- If SSDP fails, specify `--ip <speaker-ip>`.
+- Spotify Web API search is optional and requires `SPOTIFY_CLIENT_ID/SECRET`.
+- If there is an error, check the troubleshooting section and offer advice if there is a decent match.
+
+## Troubleshooting
+
+### `sonos discover` - `no route to host`
+
+- On error `Error: write udp4 0.0.0.0:64326->239.255.255.250:1900: sendto: no route to host (Command exited with code 1)`
+  - Note that the port number after `0.0.0.0:` is ephemeral and will change and the netmask may not match exactly either
+  - The `sendto: no route to host` should stay consistent
+- Advise the user that in `direct` (no Docker sandbox) mode on Mac OS that Settings -> Privacy & Security -> Local Network will need to be enabled for the top-level host parent process of the Gateway
+  - `node` if running via `launchd`
+  - `Terminal` if running the gateway directly in the terminal
+  - `Visual Studio Code` if running via terminal in VS Code
+- An alternative option is to use `sandbox` (docker container) with network access allowed for that sandbox
+
+### `sonos discover` - `bind: operation not permitted`
+
+- On error `Error: listen udp4 0.0.0.0:0: bind: operation not permitted`
+- Advise the user that they may be running via a Codex or other sandbox that does not permit network access (this can be replicated by running `sonos discover` within a Codex CLI session with sandbox enabled and not approving the escalation request)

package/skills/spike/SKILL.md

@@ -1,55 +1,55 @@
----
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-watermark: ORIRO
-disable-model-invocation: true
-name: spike
-description: Run throwaway prototypes to validate feasibility, compare approaches, and report a verdict.
-metadata: { "oriro": { "emoji": "🧪" } }
----
-
-# Spike
-
-Use when the user wants to test an idea before committing to a real build: "spike this", "quick prototype", "is this possible", "compare A/B", "before we build".
-
-Do not use when reading docs/code can answer the question, or when the user clearly asked for production implementation.
-
-Loop
-
-1. Question: state the concrete feasibility question.
-2. Research: read enough docs/source to choose credible approach.
-3. Build: create the smallest runnable artifact that validates or invalidates the idea.
-4. Stress: try one edge case or failure mode.
-5. Verdict: `VALIDATED`, `PARTIAL`, or `INVALIDATED`.
-
-Output shape
-
-- Default workspace: `.tmp/oriro-spikes/<slug>` unless user asks for a tracked repo-local path.
-- Repo-local option: `spikes/<NNN-slug>/` with `README.md` and minimal code.
-- Prefer runnable CLI, tiny HTML, one endpoint, or focused test.
-- Avoid package sprawl, Docker, env files, app frameworks, and production cleanup.
-
-Multi-spike ideas
-
-- Split into 2-5 independent questions.
-- Run the riskiest question first.
-- For A/B comparisons, keep inputs equal and measure the same dimensions.
-- Ask before building all variants if the work is more than a small prototype.
-
-Verdict format
-
-```markdown
-## Verdict: VALIDATED | PARTIAL | INVALIDATED
-
-Question: ...
-Evidence: exact command/output/measurement.
-What worked: ...
-What failed or surprised us: ...
-Recommendation: ship / adjust / avoid, with the next production step.
-```
-
-Rules
-
-- An invalidated spike is useful when it rules out a path with evidence.
-- Do not merge spike code into production without rewriting it normally.
-- If external dependencies are evaluated, check health: recent release/commit, docs, license, install friction.
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: spike
+description: Run throwaway prototypes to validate feasibility, compare approaches, and report a verdict.
+metadata: { "oriro": { "emoji": "🧪" } }
+---
+
+# Spike
+
+Use when the user wants to test an idea before committing to a real build: "spike this", "quick prototype", "is this possible", "compare A/B", "before we build".
+
+Do not use when reading docs/code can answer the question, or when the user clearly asked for production implementation.
+
+Loop
+
+1. Question: state the concrete feasibility question.
+2. Research: read enough docs/source to choose credible approach.
+3. Build: create the smallest runnable artifact that validates or invalidates the idea.
+4. Stress: try one edge case or failure mode.
+5. Verdict: `VALIDATED`, `PARTIAL`, or `INVALIDATED`.
+
+Output shape
+
+- Default workspace: `.tmp/oriro-spikes/<slug>` unless user asks for a tracked repo-local path.
+- Repo-local option: `spikes/<NNN-slug>/` with `README.md` and minimal code.
+- Prefer runnable CLI, tiny HTML, one endpoint, or focused test.
+- Avoid package sprawl, Docker, env files, app frameworks, and production cleanup.
+
+Multi-spike ideas
+
+- Split into 2-5 independent questions.
+- Run the riskiest question first.
+- For A/B comparisons, keep inputs equal and measure the same dimensions.
+- Ask before building all variants if the work is more than a small prototype.
+
+Verdict format
+
+```markdown
+## Verdict: VALIDATED | PARTIAL | INVALIDATED
+
+Question: ...
+Evidence: exact command/output/measurement.
+What worked: ...
+What failed or surprised us: ...
+Recommendation: ship / adjust / avoid, with the next production step.
+```
+
+Rules
+
+- An invalidated spike is useful when it rules out a path with evidence.
+- Do not merge spike code into production without rewriting it normally.
+- If external dependencies are evaluated, check health: recent release/commit, docs, license, install friction.

package/skills/spotify-player/SKILL.md

@@ -1,68 +1,68 @@
----
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-watermark: ORIRO
-disable-model-invocation: true
-name: spotify-player
-description: "Terminal Spotify playback/search via spogo (preferred) or spotify_player."
-homepage: https://www.spotify.com
-metadata:
-  {
-    "oriro":
-      {
-        "emoji": "🎵",
-        "requires": { "anyBins": ["spogo", "spotify_player"] },
-        "install":
-          [
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "spogo",
-              "tap": "oriro/tap",
-              "bins": ["spogo"],
-              "label": "Install spogo (brew)",
-            },
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "spotify_player",
-              "bins": ["spotify_player"],
-              "label": "Install spotify_player (brew)",
-            },
-          ],
-      },
-  }
----
-
-# spogo / spotify_player
-
-Use `spogo` **(preferred)** for Spotify playback/search. Fall back to `spotify_player` if needed.
-
-Requirements
-
-- Spotify Premium account.
-- Either `spogo` or `spotify_player` installed.
-
-spogo setup
-
-- Import cookies: `spogo auth import --browser chrome`
-
-Common CLI commands
-
-- Search: `spogo search track "query"`
-- Playback: `spogo play|pause|next|prev`
-- Devices: `spogo device list`, `spogo device set "<name|id>"`
-- Status: `spogo status`
-
-spotify_player commands (fallback)
-
-- Search: `spotify_player search "query"`
-- Playback: `spotify_player playback play|pause|next|previous`
-- Connect device: `spotify_player connect`
-- Like track: `spotify_player like`
-
-Notes
-
-- Config folder: `~/.config/spotify-player` (e.g., `app.toml`).
-- For Spotify Connect integration, set a user `client_id` in config.
-- TUI shortcuts are available via `?` in the app.
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: spotify-player
+description: "Terminal Spotify playback/search via spogo (preferred) or spotify_player."
+homepage: https://www.spotify.com
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "🎵",
+        "requires": { "anyBins": ["spogo", "spotify_player"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "spogo",
+              "tap": "oriro/tap",
+              "bins": ["spogo"],
+              "label": "Install spogo (brew)",
+            },
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "spotify_player",
+              "bins": ["spotify_player"],
+              "label": "Install spotify_player (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# spogo / spotify_player
+
+Use `spogo` **(preferred)** for Spotify playback/search. Fall back to `spotify_player` if needed.
+
+Requirements
+
+- Spotify Premium account.
+- Either `spogo` or `spotify_player` installed.
+
+spogo setup
+
+- Import cookies: `spogo auth import --browser chrome`
+
+Common CLI commands
+
+- Search: `spogo search track "query"`
+- Playback: `spogo play|pause|next|prev`
+- Devices: `spogo device list`, `spogo device set "<name|id>"`
+- Status: `spogo status`
+
+spotify_player commands (fallback)
+
+- Search: `spotify_player search "query"`
+- Playback: `spotify_player playback play|pause|next|previous`
+- Connect device: `spotify_player connect`
+- Like track: `spotify_player like`
+
+Notes
+
+- Config folder: `~/.config/spotify-player` (e.g., `app.toml`).
+- For Spotify Connect integration, set a user `client_id` in config.
+- TUI shortcuts are available via `?` in the app.