@oriro/orirocli 0.1.0

package/skills/trades/trades-plumbing/SKILL.md

@@ -0,0 +1,160 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: trades-plumbing
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+  Home plumbing — pipe types, common repairs, water heaters, drains, toilets,
+  faucets, and knowing when to call a plumber. Activate for questions about
+  leaking pipes, clogged drains, running toilets, water heater problems,
+  low water pressure, or any plumbing issue. Sources: International Plumbing
+  Code principles, This Old House guides, EPA WaterSense.
+  Call a licensed plumber for gas line work, main line issues, or any work
+  requiring permits.
+---
+
+# Home Plumbing
+
+## Water system basics
+
+**Supply lines:** Pressurized cold water enters from municipal supply or well.
+Hot water supply goes through water heater first.
+Typical household pressure: 40-80 PSI. Over 80 PSI: install pressure reducing valve (PRV).
+
+**Drain-Waste-Vent (DWV) system:**
+
+- Drain: carries waste to sewer/septic
+- Waste: vertical pipes carrying waste
+- Vent: allows air into drains to prevent siphoning of trap water (sewer gases)
+
+**P-trap:** The U-shaped pipe under every fixture.
+Holds water to block sewer gases from entering the home.
+If a fixture isn't used for weeks, trap can dry out → sewer smell. Fix: run water.
+
+**Main shutoff valve:** Know where it is. Can shut off all water to house.
+Usually at the point water enters the home (basement, crawl space, outside near foundation, or in a utility box near the street).
+
+---
+
+## Pipe types
+
+**Copper:** Durable, 50+ year lifespan. Suitable for hot and cold. Expensive. Requires soldering.
+**PEX (cross-linked polyethylene):** Flexible, easy to install, freeze-resistant, inexpensive.
+Now the dominant choice for new construction and remodels.
+PEX-A (most flexible), PEX-B (common), PEX-C.
+**PVC:** White plastic. Cold water supply and DWV. Not for hot water supply.
+**CPVC:** Cream-colored plastic. Can be used for hot water supply unlike PVC.
+**ABS:** Black plastic. DWV only. Common in older homes.
+**Galvanized steel:** Gray metal. Found in pre-1960s homes. Prone to corrosion and reduced flow.
+**Cast iron:** Black. Found in pre-1980s homes. Very durable but heavy. Common in drain systems.
+
+---
+
+## Common repairs
+
+### Clogged drains
+
+**Kitchen sink:** Usually grease buildup.
+
+1. Try boiling water (NOT with PVC pipes — use hot, not boiling).
+2. Baking soda + white vinegar (pour 1/2 cup baking soda, then 1/2 cup vinegar, wait 30 min, flush with hot water).
+3. Plunger (cup plunger, not flange).
+4. Hand auger/drain snake.
+5. If still clogged: could be deeper in the drain line. Call plumber.
+
+**Bathroom sink/tub:** Usually hair.
+Remove and clean stopper/drain cover. Use hair removal tool (Zip-It) first. Then snake if needed.
+
+**Toilet:** Use a toilet auger (closet auger), not a regular snake.
+
+### Running toilet
+
+Most common cause: **flapper not sealing properly**.
+
+1. Remove tank lid. Flush and watch.
+2. If water keeps running: flapper is worn. $5-10 to replace. 10-minute fix.
+3. Check float height: water level should be 1 inch below overflow tube.
+4. If water runs into bowl constantly: check flapper seal; replace if worn.
+5. Check fill valve: if hissing and water level is at overflow tube, replace fill valve.
+
+Running toilet wastes 200+ gallons/day. Fix it immediately.
+
+### Dripping faucet
+
+**Ball faucet (single handle, round cap):** Replace ball, seats, springs, and O-rings.
+**Cartridge faucet (single or double handle):** Replace cartridge.
+**Ceramic disc (wide single handle):** Replace disc cylinder.
+**Compression (two handles, turn to tighten):** Replace rubber washers.
+
+Parts are at home improvement stores. Bring the old part for matching.
+Turn off supply shutoffs under the sink before any faucet work.
+
+### Toilet running water or rocking toilet
+
+Rocking toilet: usually two causes — wax ring failure (requires reset) or broken floor flange.
+Water around base of toilet (not just condensation): wax ring has failed. Must reset toilet.
+
+---
+
+## Water heater
+
+### Tank water heater
+
+**Life expectancy:** 8-12 years (tank). 15-20 years (tankless).
+**Temperature setting:** 120°F recommended. 140°F kills Legionella but scalds risk.
+
+**Sediment flushing (annual):**
+Sediment builds up and reduces efficiency.
+
+1. Turn off cold supply to heater.
+2. Attach hose to drain valve at bottom.
+3. Open pressure relief valve slightly (or nearby hot faucet).
+4. Open drain valve. Let sediment flush out.
+5. Flush until water runs clear.
+6. Close valve, restore cold supply, restore power/gas.
+
+**Anode rod:** Sacrificial metal rod that prevents tank corrosion.
+Replace every 5-7 years. If you have softened water, replace more frequently.
+Failure to replace anode → tank corrodes → leaks → must replace.
+
+**Pressure relief valve (T&P valve):**
+Safety device that opens if pressure or temperature is too high.
+Test annually by briefly lifting the lever. If it doesn't release or water continues to flow: replace.
+
+**When to replace rather than repair:**
+Age > 10-12 years. Significant rust in water. Tank is leaking (corrosion, not fitting).
+
+### Tankless water heater
+
+Heats water on demand. No tank standby losses.
+Requires: higher gas BTU rating (for gas) or higher electrical service (for electric).
+Annual descaling recommended in hard water areas.
+
+---
+
+## Shutting off water quickly
+
+**Individual fixture shutoffs:** Under every sink, behind every toilet. Know and exercise them annually (they can seize).
+
+**Whole house shutoff:** Know exactly where it is before you have an emergency.
+
+**How to turn off water with no working shutoff:**
+Main shutoff at the street/curb box. Requires a meter key (available at hardware stores).
+In an emergency, utility company can turn off immediately.
+
+---
+
+## When to always call a plumber
+
+- Any work on gas lines (always requires licensed plumber or HVAC contractor)
+- Main drain line clogs (require sewer snake or hydrojetting)
+- Any sewer line work
+- Replacing the main water line
+- Water main breaks
+- Persistent low water pressure (may be supply line issue)
+- Any work requiring permits in your jurisdiction
+- Sewage backup into multiple fixtures (main line blockage)
+
+Sources: International Plumbing Code principles, EPA WaterSense (epa.gov/watersense),
+This Old House plumbing guides, PHCC (Plumbing-Heating-Cooling Contractors Association)

package/skills/trades/trades-welding/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/trades/trades-welding/SKILL.md

@@ -0,0 +1,82 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: trades-welding
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+
+
+
+
+  Welding — process types, safety, materials, joint design, and quality control.
+  Sources: USDA, OSHA, trade association guidelines, professional kitchen standards.
+---
+
+# Welding
+
+## Welding processes
+
+### MIG (GMAW — Gas Metal Arc Welding)
+
+Most beginner-friendly. Wire electrode feeds automatically. Shielding gas protects weld pool.
+**Good for:** Most steel and aluminum. Production welding. Thin to medium thickness.
+**Shielding gas:** 75% Argon / 25% CO₂ (C25) for steel. 100% Argon for aluminum.
+**Parameters:** Voltage, wire feed speed, travel speed, work angle. All affect bead.
+
+### TIG (GTAW — Gas Tungsten Arc Welding)
+
+Most precise. Separate filler rod fed by hand. Non-consumable tungsten electrode.
+**Good for:** Stainless steel, aluminum, thin materials, critical welds, visible work.
+**Shielding gas:** 100% Argon.
+Requires more skill; both hands occupied plus foot pedal for amperage control.
+
+### Stick (SMAW — Shielded Metal Arc Welding)
+
+Flux-coated electrode. Flux provides shielding gas when it burns. No external gas needed.
+**Good for:** Outdoors, wind, field work, thick materials, dirty/rusty metal.
+**Electrodes:** E6011 (all positions, AC/DC), E6013 (clean metal, smooth bead), E7018 (strong, low hydrogen, good for structural).
+
+### Flux-core (FCAW)
+
+Similar to MIG but wire has flux core. Can be used without shielding gas (self-shielded).
+**Good for:** Outdoor work, thick materials, production.
+
+## Safety — non-negotiable
+
+**Eye protection:** Welding arc emits UV and IR radiation. Arc eye (photokeratitis) is extremely painful.
+Auto-darkening helmet: Shade 10-13 depending on process/amperage. Always wear; never look at arc without proper protection.
+**Fire hazard:** Spatter can travel 35+ feet. Clear area of flammables. Have fire extinguisher accessible.
+**Fumes:** Welding fumes are hazardous. Ventilate adequately. Local exhaust ventilation preferred. Never weld galvanized metal (zinc fumes = metal fume fever; cadmium = toxic).
+**Electrical:** Keep cables, connectors, and electrode holder in good condition. Never stand in water while welding.
+**Hot metal:** Weld metal stays hot long after arc stops. Mark with chalk "HOT." Use pliers/gloves.
+
+## Joint types
+
+**Butt joint:** Two pieces end to end. Most common.
+**T-joint:** One piece perpendicular to another.
+**Lap joint:** Two pieces overlapping.
+**Corner joint:** Two pieces at a right angle (corner).
+**Edge joint:** Two pieces side by side, welded at edge.
+
+**Groove vs. fillet weld:**
+Groove weld: In a groove/gap between two pieces (butt welds).
+Fillet weld: Triangle cross-section, filling inside corner (T-joint, lap joint).
+
+## Weld quality
+
+**Good weld appearance:** Uniform width and height, consistent ripple pattern, no porosity, good fusion to base metal, no undercut at edges.
+**Common defects:**
+Porosity: Gas pockets in weld. Causes: moisture, contamination, wrong gas coverage.
+Undercut: Groove melted into base metal at weld edge. Too much heat or wrong angle.
+Overlap: Weld metal rolls over without fusing to base. Too slow, too cold.
+Cracking: Hot cracks during cooling; cold cracks later. Serious structural defect.
+
+## Materials
+
+**Carbon steel:** Most commonly welded. Low carbon (mild steel) welds easily.
+**Stainless steel:** Use 308 or 316 filler rod to match alloy. Purge back side for high-purity work.
+**Aluminum:** AC TIG or MIG with aluminum wire and 100% Argon. Oxide layer must be cleaned. Preheating helps for thick sections.
+
+Sources: AWS (American Welding Society — aws.org, free standards summaries), Lincoln Electric welding education (lincolnelectric.com/en/education), Miller Electric (millerwelds.com/resources), OSHA welding safety standards (29 CFR 1910.252)

package/skills/trello/SKILL.md

@@ -0,0 +1,112 @@
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: trello
+description: "Manage Trello boards, lists, and cards via the Trello REST API."
+homepage: https://developer.atlassian.com/cloud/trello/rest/
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "📋",
+        "requires": { "bins": ["curl", "jq"], "env": ["TRELLO_API_KEY", "TRELLO_TOKEN"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "jq",
+              "bins": ["jq"],
+              "label": "Install jq (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# Trello Skill
+
+Manage Trello boards, lists, and cards directly from Oriro.
+
+## Setup
+
+1. Get your API key: https://trello.com/app-key
+2. Generate a token (click "Token" link on that page)
+3. Set environment variables:
+   ```bash
+   export TRELLO_API_KEY="your-api-key"
+   export TRELLO_TOKEN="your-token"
+   ```
+
+## Usage
+
+All commands use curl to hit the Trello REST API.
+
+### List boards
+
+```bash
+curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
+```
+
+### List lists in a board
+
+```bash
+curl -s "https://api.trello.com/1/boards/{boardId}/lists?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
+```
+
+### List cards in a list
+
+```bash
+curl -s "https://api.trello.com/1/lists/{listId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id, desc}'
+```
+
+### Create a card
+
+```bash
+curl -s -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
+  -d "idList={listId}" \
+  -d "name=Card Title" \
+  -d "desc=Card description"
+```
+
+### Move a card to another list
+
+```bash
+curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
+  -d "idList={newListId}"
+```
+
+### Add a comment to a card
+
+```bash
+curl -s -X POST "https://api.trello.com/1/cards/{cardId}/actions/comments?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
+  -d "text=Your comment here"
+```
+
+### Archive a card
+
+```bash
+curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
+  -d "closed=true"
+```
+
+## Notes
+
+- Board/List/Card IDs can be found in the Trello URL or via the list commands
+- The API key and token provide full access to your Trello account - keep them secret!
+- Rate limits: 300 requests per 10 seconds per API key; 100 requests per 10 seconds per token; `/1/members` endpoints are limited to 100 requests per 900 seconds
+
+## Examples
+
+```bash
+# Get all boards
+curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN&fields=name,id" | jq
+
+# Find a specific board by name
+curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | select(.name | contains("Work"))'
+
+# Get all cards on a board
+curl -s "https://api.trello.com/1/boards/{boardId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, list: .idList}'
+```

package/skills/video-frames/SKILL.md

@@ -0,0 +1,50 @@
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: video-frames
+description: "Extract frames or short clips from videos using ffmpeg."
+homepage: https://ffmpeg.org
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "🎬",
+        "requires": { "bins": ["ffmpeg"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "ffmpeg",
+              "bins": ["ffmpeg"],
+              "label": "Install ffmpeg (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# Video Frames (ffmpeg)
+
+Extract a single frame from a video, or create quick thumbnails for inspection.
+
+## Quick start
+
+First frame:
+
+```bash
+{baseDir}/scripts/frame.sh /path/to/video.mp4 --out /tmp/frame.jpg
+```
+
+At a timestamp:
+
+```bash
+{baseDir}/scripts/frame.sh /path/to/video.mp4 --time 00:00:10 --out /tmp/frame-10s.jpg
+```
+
+## Notes
+
+- Prefer `--time` for "what is happening around here?".
+- Use a `.jpg` for quick share; use `.png` for crisp UI frames.

package/skills/video-frames/scripts/frame.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat >&2 <<'EOF'
+Usage:
+  frame.sh <video-file> [--time HH:MM:SS] [--index N] --out /path/to/frame.jpg
+
+Examples:
+  frame.sh video.mp4 --out /tmp/frame.jpg
+  frame.sh video.mp4 --time 00:00:10 --out /tmp/frame-10s.jpg
+  frame.sh video.mp4 --index 0 --out /tmp/frame0.png
+EOF
+  exit 2
+}
+
+if [[ "${1:-}" == "" || "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+fi
+
+in="${1:-}"
+shift || true
+
+time=""
+index=""
+out=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --time)
+      time="${2:-}"
+      shift 2
+      ;;
+    --index)
+      index="${2:-}"
+      shift 2
+      ;;
+    --out)
+      out="${2:-}"
+      shift 2
+      ;;
+    *)
+      echo "Unknown arg: $1" >&2
+      usage
+      ;;
+  esac
+done
+
+if [[ ! -f "$in" ]]; then
+  echo "File not found: $in" >&2
+  exit 1
+fi
+
+if [[ "$out" == "" ]]; then
+  echo "Missing --out" >&2
+  usage
+fi
+
+mkdir -p "$(dirname "$out")"
+
+if [[ "$index" != "" ]]; then
+  ffmpeg -hide_banner -loglevel error -y \
+    -i "$in" \
+    -vf "select=eq(n\\,${index})" \
+    -vframes 1 \
+    "$out"
+elif [[ "$time" != "" ]]; then
+  ffmpeg -hide_banner -loglevel error -y \
+    -ss "$time" \
+    -i "$in" \
+    -frames:v 1 \
+    "$out"
+else
+  ffmpeg -hide_banner -loglevel error -y \
+    -i "$in" \
+    -vf "select=eq(n\\,0)" \
+    -vframes 1 \
+    "$out"
+fi
+
+echo "$out"

package/skills/voice-call/SKILL.md

@@ -0,0 +1,49 @@
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: voice-call
+description: "Start voice calls via the ORIRO voice-call plugin."
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "📞",
+        "skillKey": "voice-call",
+        "requires": { "config": ["plugins.entries.voice-call.enabled"] },
+      },
+  }
+---
+
+# Voice Call
+
+Use the voice-call plugin to start or inspect calls (Twilio, Telnyx, Plivo, or mock).
+
+## CLI
+
+```bash
+oriro voicecall call --to "+15555550123" --message "Hello from ORIRO"
+oriro voicecall status --call-id <id>
+```
+
+## Tool
+
+Use `voice_call` for agent-initiated calls.
+
+Actions:
+
+- `initiate_call` (message, to?, mode?)
+- `continue_call` (callId, message)
+- `speak_to_user` (callId, message)
+- `end_call` (callId)
+- `get_status` (callId)
+
+Notes:
+
+- Requires the voice-call plugin to be enabled.
+- Plugin config lives under `plugins.entries.voice-call.config`.
+- Twilio config: `provider: "twilio"` + `twilio.accountSid/authToken` + `fromNumber`.
+- Telnyx config: `provider: "telnyx"` + `telnyx.apiKey/connectionId` + `fromNumber`.
+- Plivo config: `provider: "plivo"` + `plivo.authId/authToken` + `fromNumber`.
+- Dev fallback: `provider: "mock"` (no network).

package/skills/wacli/SKILL.md

@@ -0,0 +1,76 @@
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: wacli
+description: "Send third-party WhatsApp messages or sync/search WhatsApp history via wacli, not normal active chats."
+homepage: https://wacli.sh
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "📱",
+        "requires": { "bins": ["wacli"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "oriro/tap/wacli",
+              "bins": ["wacli"],
+              "label": "Install wacli (brew)",
+            },
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/oriro/wacli/cmd/wacli@latest",
+              "bins": ["wacli"],
+              "label": "Install wacli (go)",
+            },
+          ],
+      },
+  }
+---
+
+# wacli
+
+Use `wacli` only when the user explicitly asks you to message someone else on WhatsApp or when they ask to sync/search WhatsApp history.
+Do NOT use `wacli` for normal user chats; Oriro routes WhatsApp conversations automatically.
+If the user is chatting with you on WhatsApp, you should not reach for this tool unless they ask you to contact a third party.
+
+Safety
+
+- Require explicit recipient + message text.
+- Confirm recipient + message before sending.
+- If anything is ambiguous, ask a clarifying question.
+
+Auth + sync
+
+- `wacli auth` (QR login + initial sync)
+- `wacli sync --follow` (continuous sync)
+- `wacli doctor`
+
+Find chats + messages
+
+- `wacli chats list --limit 20 --query "name or number"`
+- `wacli messages search "query" --limit 20 --chat <jid>`
+- `wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31`
+
+History backfill
+
+- `wacli history backfill --chat <jid> --requests 2 --count 50`
+
+Send
+
+- Text: `wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"`
+- Group: `wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late."`
+- File: `wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"`
+
+Notes
+
+- Store dir: `~/.wacli` (override with `--store`).
+- Use `--json` for machine-readable output when parsing.
+- Backfill requires your phone online; results are best-effort.
+- WhatsApp CLI is not needed for routine user chats; it's for messaging other people.
+- JIDs: direct chats look like `<number>@s.whatsapp.net`; groups look like `<id>@g.us` (use `wacli chats list` to find).