@oriro/orirocli 0.1.0

package/skills/social-sciences/social-political-science/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ORIRO.ai
+
+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/skills/social-sciences/social-political-science/SKILL.md

@@ -0,0 +1,70 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: social-political-science
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+  Political science — political systems, institutions, democracy, policy process, and international relations.
+
+
+
+  Sources: OpenStax Economics (CC-BY), MIT OCW, World Bank, OECD, UN development resources.
+---
+
+# Political Science
+
+## Political systems
+
+### Democracy
+
+**Procedural democracy:** Free and fair elections, majority rule, rule of law.
+**Liberal democracy:** Adds protection of individual rights, minority rights, independent judiciary.
+**Direct democracy:** Citizens vote directly on issues. Ancient Athens. Referenda.
+**Representative/indirect democracy:** Elect representatives who make decisions. Most modern democracies.
+
+**Presidential systems (US):** Separate executive and legislative branches. Fixed terms. Divided government possible.
+**Parliamentary systems (UK, most of Europe):** Executive drawn from legislature. Government falls if loses majority vote. More disciplined parties.
+**Semi-presidential (France):** President + Prime Minister. Both have significant executive power.
+
+### Authoritarianism
+
+**Authoritarian:** Some pluralism tolerated but restricted political competition. Limited accountability.
+**Totalitarian:** State seeks to control all aspects of life. Nazi Germany, Stalinist USSR.
+**Hybrid regimes:** Electoral authoritarianism — elections occur but not free/fair. Hungary, Turkey.
+
+## Political institutions
+
+### Separation of powers
+
+Legislative: Makes laws. Executive: Implements laws. Judicial: Interprets laws.
+**Checks and balances:** Each branch limits the other two.
+**Judicial review:** Courts can strike down legislation as unconstitutional. US since Marbury v. Madison (1803).
+
+### Electoral systems
+
+**First-past-the-post (FPTP):** Plurality wins. Simple. Tends toward two-party system (Duverger's Law). US, UK.
+**Proportional representation:** Seats allocated by vote share. Multi-party systems. Most of Europe.
+**Mixed systems:** Elements of both. Germany (mixed-member proportional).
+**Consequences:** FPTP = stable governments, less representation. PR = more representation, sometimes coalition instability.
+
+### Federalism
+
+Division of power between central and subnational governments.
+**Federal states:** Power explicitly divided. US, Germany, India, Canada, Australia.
+**Unitary states:** Central government supreme; subnational units can be created/changed. UK, France, Japan.
+**Advantages of federalism:** Accommodates diversity, policy experimentation, checks central power.
+**Disadvantages:** Coordination problems, inequality between regions.
+
+## International relations
+
+**Realism:** States are primary actors, pursue self-interest in anarchic system. Power balancing.
+**Liberalism:** Institutions, interdependence, democracy reduce conflict. Liberal peace theory.
+**Constructivism:** Interests and identities are socially constructed, not fixed.
+
+**International institutions:** UN, WTO, IMF, NATO — constrain behavior, facilitate cooperation, but states retain sovereignty.
+**Collective security:** States agree to treat aggression against one as aggression against all (NATO Article 5).
+**Nuclear deterrence:** Mutually Assured Destruction (MAD) — rational actors won't use nuclear weapons if retaliation certain.
+
+Sources: MIT OCW Political Science, OpenStax American Government (CC-BY), Dahl "On Democracy" (principles), Huntington "Third Wave" (principles), Polity IV dataset, Freedom House (free data)

package/skills/social-sciences/social-public-policy/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ORIRO.ai
+
+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/skills/social-sciences/social-public-policy/SKILL.md

@@ -0,0 +1,73 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: social-public-policy
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+
+
+  Public policy — policy design, analysis, implementation, evaluation, and stakeholder management.
+
+  Sources: OpenStax Economics (CC-BY), MIT OCW, World Bank, OECD, UN development resources.
+---
+
+# Public Policy
+
+## The policy cycle
+
+**Problem identification and agenda setting:** How does an issue get recognized as requiring government action? Crises, advocacy, media, election cycles.
+**Policy formulation:** Develop options and proposals. Who is involved? Technocrats, interest groups, elected officials, research organizations.
+**Adoption/legitimation:** Policy is officially enacted. Requires political support.
+**Implementation:** Converting policy into action. Where many policies fail. Bureaucratic discretion, resources, coordination.
+**Evaluation:** Did it work? What were unintended consequences? (Feeds back to problem identification.)
+
+## Policy design
+
+**Policy instruments (types):**
+Regulations: Commands and controls. What you must or must not do.
+Economic instruments: Taxes, subsidies, cap-and-trade. Change incentives.
+Voluntary approaches: Industry self-regulation, labeling.
+Information: Public education, disclosure requirements.
+Direct provision: Government provides services directly (public schools, VA healthcare).
+
+**Policy targeting:**
+Universal: Available to everyone (Medicare in Canada, public schools).
+Means-tested: For those below an income threshold (SNAP, Medicaid in US).
+Universal tends to be more politically durable; means-tested is more efficient but stigmatized.
+
+## Policy analysis frameworks
+
+### Cost-benefit analysis (CBA)
+
+Quantify all costs and benefits in monetary terms. Net benefit = Benefits - Costs.
+Challenges: How to value human life? Environmental services? Future generations?
+**Discount rate:** Future benefits worth less than present benefits. Choice of discount rate dramatically affects analysis.
+
+### Cost-effectiveness analysis
+
+Compare costs of achieving the same outcome across options. Useful when benefits hard to monetize.
+"Which intervention produces the most QALYs (quality-adjusted life years) per dollar?"
+
+### Regulatory impact analysis
+
+Federal agencies (US) must estimate costs and benefits before major regulations.
+Required to choose the most cost-effective alternative.
+
+## Implementation challenges
+
+**Street-level bureaucrats (Lipsky):** Front-line workers (teachers, police, social workers) make discretionary decisions that effectively create policy.
+**Principal-agent problem:** Principals (elected officials) delegate to agents (bureaucrats) who have different information and interests.
+**Coordination failures:** Multiple agencies responsible for one issue without clear authority.
+**Implementation deficit:** Gap between policy intentions and actual outcomes.
+
+## Evidence-based policy
+
+**Randomized control trials in policy:** J-PAL (Abdul Latif Jameel Poverty Action Lab) applies RCTs to development policy. Rigorous evidence on what works.
+**What Works Clearinghouses:** Government-funded databases of evaluated programs.
+**Policy transfer:** Adopt policies that worked in other contexts. Must assess transferability.
+
+**Politics vs. evidence:** Evidence informs but doesn't determine policy. Values and interests always involved. The question "what works?" requires prior answer to "for what?"
+
+Sources: Birkland "An Introduction to the Policy Process" (principles), OpenStax American Government (CC-BY), J-PAL (povertyactionlab.org — free research), OECD policy analysis (free publications), Congressional Budget Office (cbo.gov — free)

package/skills/social-sciences/social-sociology/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ORIRO.ai
+
+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/skills/social-sciences/social-sociology/SKILL.md

@@ -0,0 +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)

package/skills/songsee/SKILL.md

@@ -0,0 +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.

package/skills/sonoscli/SKILL.md

@@ -0,0 +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)

package/skills/spike/SKILL.md

@@ -0,0 +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.

package/skills/spotify-player/SKILL.md

@@ -0,0 +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.

package/skills/summarize/SKILL.md

@@ -0,0 +1,90 @@
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+name: summarize
+description: "Summarize or transcribe URLs, YouTube/videos, podcasts, articles, transcripts, PDFs, and local files."
+homepage: https://summarize.sh
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "🧾",
+        "requires": { "bins": ["summarize"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "oriro/tap/summarize",
+              "bins": ["summarize"],
+              "label": "Install summarize (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# Summarize
+
+Fast CLI to summarize URLs, local files, and YouTube links.
+
+## When to use (trigger phrases)
+
+Use this skill immediately when the user asks any of:
+
+- "use summarize.sh"
+- "what's this link/video about?"
+- "summarize this URL/article"
+- "transcribe this YouTube/video" (best-effort transcript extraction; no `yt-dlp` needed)
+
+## Quick start
+
+```bash
+summarize "https://example.com"
+summarize "/path/to/file.pdf"
+summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto
+```
+
+## YouTube: summary vs transcript
+
+Best-effort transcript (URLs only):
+
+```bash
+summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto --extract
+```
+
+If the user asked for a transcript but it's huge, return a tight summary first, then ask which section/time range to expand.
+
+## Model + keys
+
+Set the API key for your chosen provider:
+
+- OpenAI: `OPENAI_API_KEY`
+- Anthropic: `ANTHROPIC_API_KEY`
+- xAI: `XAI_API_KEY`
+- Google: `GEMINI_API_KEY` (aliases: `GOOGLE_GENERATIVE_AI_API_KEY`, `GOOGLE_API_KEY`)
+
+Default model is `auto`; config may choose the provider/model.
+
+## Useful flags
+
+- `--length short|medium|long|xl|xxl|<chars>`
+- `--max-output-tokens <count>`
+- `--extract` (print extracted content, no LLM summary)
+- `--json` (machine readable)
+- `--firecrawl auto|off|always` (fallback extraction)
+- `--youtube auto` (Apify fallback if `APIFY_API_TOKEN` set)
+
+## Config
+
+Optional config file: `~/.summarize/config.json`
+
+```json
+{ "model": "openai/gpt-5.2" }
+```
+
+Optional services:
+
+- `FIRECRAWL_API_KEY` for blocked sites
+- `APIFY_API_TOKEN` for YouTube fallback