@oriro/orirocli 0.1.0

package/skills/things-mac/SKILL.md

@@ -0,0 +1,90 @@
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: things-mac
+description: "Add, update, list, search, or inspect Things 3 todos, inbox, today, projects, areas, and tags on macOS."
+homepage: https://github.com/ossianhempel/things3-cli
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "✅",
+        "os": ["darwin"],
+        "requires": { "bins": ["things"] },
+        "install":
+          [
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/ossianhempel/things3-cli/cmd/things@latest",
+              "bins": ["things"],
+              "label": "Install things3-cli (go)",
+            },
+          ],
+      },
+  }
+---
+
+# Things 3 CLI
+
+Use `things` to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.
+
+Setup
+
+- Install (recommended, Apple Silicon): `GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest`
+- If DB reads fail: grant **Full Disk Access** to the calling app (Terminal for manual runs; `ORIRO.app` for gateway runs).
+- Optional: set `THINGSDB` (or pass `--db`) to point at your `ThingsData-*` folder.
+- Optional: set `THINGS_AUTH_TOKEN` to avoid passing `--auth-token` for update ops.
+
+Read-only (DB)
+
+- `things inbox --limit 50`
+- `things today`
+- `things upcoming`
+- `things search "query"`
+- `things projects` / `things areas` / `things tags`
+
+Write (URL scheme)
+
+- Prefer safe preview: `things --dry-run add "Title"`
+- Add: `things add "Title" --notes "..." --when today --deadline 2026-01-02`
+- Bring Things to front: `things --foreground add "Title"`
+
+Examples: add a todo
+
+- Basic: `things add "Buy milk"`
+- With notes: `things add "Buy milk" --notes "2% + bananas"`
+- Into a project/area: `things add "Book flights" --list "Travel"`
+- Into a project heading: `things add "Pack charger" --list "Travel" --heading "Before"`
+- With tags: `things add "Call dentist" --tags "health,phone"`
+- Checklist: `things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"`
+- From STDIN (multi-line => title + notes):
+  - `cat <<'EOF' | things add -`
+  - `Title line`
+  - `Notes line 1`
+  - `Notes line 2`
+  - `EOF`
+
+Examples: modify a todo (needs auth token)
+
+- First: get the ID (UUID column): `things search "milk" --limit 5`
+- Auth: set `THINGS_AUTH_TOKEN` or pass `--auth-token <TOKEN>`
+- Title: `things update --id <UUID> --auth-token <TOKEN> "New title"`
+- Notes replace: `things update --id <UUID> --auth-token <TOKEN> --notes "New notes"`
+- Notes append/prepend: `things update --id <UUID> --auth-token <TOKEN> --append-notes "..."` / `--prepend-notes "..."`
+- Move lists: `things update --id <UUID> --auth-token <TOKEN> --list "Travel" --heading "Before"`
+- Tags replace/add: `things update --id <UUID> --auth-token <TOKEN> --tags "a,b"` / `things update --id <UUID> --auth-token <TOKEN> --add-tags "a,b"`
+- Complete/cancel (soft-delete-ish): `things update --id <UUID> --auth-token <TOKEN> --completed` / `--canceled`
+- Safe preview: `things --dry-run update --id <UUID> --auth-token <TOKEN> --completed`
+
+Delete a todo?
+
+- Not supported by `things3-cli` right now (no "delete/move-to-trash" write command; `things trash` is read-only listing).
+- Options: use Things UI to delete/trash, or mark as `--completed` / `--canceled` via `things update`.
+
+Notes
+
+- macOS-only.
+- `--dry-run` prints the URL and does not open Things.

package/skills/tmux/SKILL.md

@@ -0,0 +1,95 @@
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: tmux
+description: "Control tmux sessions/panes for interactive CLIs: list, capture output, send keys, paste text, monitor prompts."
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "🧵",
+        "os": ["darwin", "linux"],
+        "requires": { "bins": ["tmux"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "tmux",
+              "bins": ["tmux"],
+              "label": "Install tmux (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# tmux
+
+Use for existing interactive tmux sessions. For one-shot commands, use normal shell. For new non-interactive background jobs, use background execution.
+
+## Basics
+
+```bash
+tmux ls
+tmux list-windows -t shared
+tmux list-panes -t shared:0
+tmux capture-pane -t shared:0.0 -p
+tmux capture-pane -t shared:0.0 -p -S -
+```
+
+Target format: `session:window.pane`, e.g. `shared:0.0`.
+
+## Send input
+
+Literal text, then Enter:
+
+```bash
+tmux send-keys -t shared:0.0 -l -- "Please continue"
+tmux send-keys -t shared:0.0 Enter
+```
+
+Special keys:
+
+```bash
+tmux send-keys -t shared:0.0 C-c
+tmux send-keys -t shared:0.0 C-d
+tmux send-keys -t shared:0.0 Escape
+```
+
+Use `-l --` for arbitrary text. Split text and Enter to avoid paste/newline surprises.
+
+## Sessions
+
+```bash
+tmux new-session -d -s worker
+tmux rename-session -t old new
+tmux kill-session -t worker
+```
+
+## Prompt checks
+
+```bash
+tmux capture-pane -t worker-3 -p | tail -20
+tmux capture-pane -t worker-3 -p | rg "proceed|permission|Yes|No|❯"
+```
+
+Approve/select only when the prompt is understood:
+
+```bash
+tmux send-keys -t worker-3 -l -- "y"
+tmux send-keys -t worker-3 Enter
+```
+
+## Helpers
+
+- `scripts/find-sessions.sh`: discover sessions.
+- `scripts/wait-for-text.sh`: wait until pane output contains text.
+
+## Notes
+
+- `capture-pane -p` prints to stdout for scripts.
+- `-S -` captures full scrollback.
+- tmux sessions persist across SSH disconnects.

package/skills/tmux/scripts/find-sessions.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE'
+Usage: find-sessions.sh [-L socket-name|-S socket-path|-A] [-q pattern]
+
+List tmux sessions on a socket (default tmux socket if none provided).
+
+Options:
+  -L, --socket       tmux socket name (passed to tmux -L)
+  -S, --socket-path  tmux socket path (passed to tmux -S)
+  -A, --all          scan all sockets under ORIRO_TMUX_SOCKET_DIR
+  -q, --query        case-insensitive substring to filter session names
+  -h, --help         show this help
+USAGE
+}
+
+socket_name=""
+socket_path=""
+query=""
+scan_all=false
+socket_dir="${ORIRO_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/oriro-tmux-sockets}"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -L|--socket)      socket_name="${2-}"; shift 2 ;;
+    -S|--socket-path) socket_path="${2-}"; shift 2 ;;
+    -A|--all)         scan_all=true; shift ;;
+    -q|--query)       query="${2-}"; shift 2 ;;
+    -h|--help)        usage; exit 0 ;;
+    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
+  esac
+done
+
+if [[ "$scan_all" == true && ( -n "$socket_name" || -n "$socket_path" ) ]]; then
+  echo "Cannot combine --all with -L or -S" >&2
+  exit 1
+fi
+
+if [[ -n "$socket_name" && -n "$socket_path" ]]; then
+  echo "Use either -L or -S, not both" >&2
+  exit 1
+fi
+
+if ! command -v tmux >/dev/null 2>&1; then
+  echo "tmux not found in PATH" >&2
+  exit 1
+fi
+
+list_sessions() {
+  local label="$1"; shift
+  local tmux_cmd=(tmux "$@")
+
+  if ! sessions="$("${tmux_cmd[@]}" list-sessions -F '#{session_name}\t#{session_attached}\t#{session_created_string}' 2>/dev/null)"; then
+    echo "No tmux server found on $label" >&2
+    return 1
+  fi
+
+  if [[ -n "$query" ]]; then
+    sessions="$(printf '%s\n' "$sessions" | grep -i -- "$query" || true)"
+  fi
+
+  if [[ -z "$sessions" ]]; then
+    echo "No sessions found on $label"
+    return 0
+  fi
+
+  echo "Sessions on $label:"
+  printf '%s\n' "$sessions" | while IFS=$'\t' read -r name attached created; do
+    attached_label=$([[ "$attached" == "1" ]] && echo "attached" || echo "detached")
+    printf '  - %s (%s, started %s)\n' "$name" "$attached_label" "$created"
+  done
+}
+
+if [[ "$scan_all" == true ]]; then
+  if [[ ! -d "$socket_dir" ]]; then
+    echo "Socket directory not found: $socket_dir" >&2
+    exit 1
+  fi
+
+  shopt -s nullglob
+  sockets=("$socket_dir"/*)
+  shopt -u nullglob
+
+  if [[ "${#sockets[@]}" -eq 0 ]]; then
+    echo "No sockets found under $socket_dir" >&2
+    exit 1
+  fi
+
+  exit_code=0
+  for sock in "${sockets[@]}"; do
+    if [[ ! -S "$sock" ]]; then
+      continue
+    fi
+    list_sessions "socket path '$sock'" -S "$sock" || exit_code=$?
+  done
+  exit "$exit_code"
+fi
+
+tmux_cmd=(tmux)
+socket_label="default socket"
+
+if [[ -n "$socket_name" ]]; then
+  tmux_cmd+=(-L "$socket_name")
+  socket_label="socket name '$socket_name'"
+elif [[ -n "$socket_path" ]]; then
+  tmux_cmd+=(-S "$socket_path")
+  socket_label="socket path '$socket_path'"
+fi
+
+list_sessions "$socket_label" "${tmux_cmd[@]:1}"

package/skills/tmux/scripts/wait-for-text.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE'
+Usage: wait-for-text.sh -t target -p pattern [options]
+
+Poll a tmux pane for text and exit when found.
+
+Options:
+  -t, --target    tmux target (session:window.pane), required
+  -p, --pattern   regex pattern to look for, required
+  -F, --fixed     treat pattern as a fixed string (grep -F)
+  -T, --timeout   seconds to wait (integer, default: 15)
+  -i, --interval  poll interval in seconds (default: 0.5)
+  -l, --lines     number of history lines to inspect (integer, default: 1000)
+  -h, --help      show this help
+USAGE
+}
+
+target=""
+pattern=""
+grep_flag="-E"
+timeout=15
+interval=0.5
+lines=1000
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -t|--target)   target="${2-}"; shift 2 ;;
+    -p|--pattern)  pattern="${2-}"; shift 2 ;;
+    -F|--fixed)    grep_flag="-F"; shift ;;
+    -T|--timeout)  timeout="${2-}"; shift 2 ;;
+    -i|--interval) interval="${2-}"; shift 2 ;;
+    -l|--lines)    lines="${2-}"; shift 2 ;;
+    -h|--help)     usage; exit 0 ;;
+    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
+  esac
+done
+
+if [[ -z "$target" || -z "$pattern" ]]; then
+  echo "target and pattern are required" >&2
+  usage
+  exit 1
+fi
+
+if ! [[ "$timeout" =~ ^[0-9]+$ ]]; then
+  echo "timeout must be an integer number of seconds" >&2
+  exit 1
+fi
+
+if ! [[ "$lines" =~ ^[0-9]+$ ]]; then
+  echo "lines must be an integer" >&2
+  exit 1
+fi
+
+if ! command -v tmux >/dev/null 2>&1; then
+  echo "tmux not found in PATH" >&2
+  exit 1
+fi
+
+# End time in epoch seconds (integer, good enough for polling)
+start_epoch=$(date +%s)
+deadline=$((start_epoch + timeout))
+
+while true; do
+  # -J joins wrapped lines, -S uses negative index to read last N lines
+  pane_text="$(tmux capture-pane -p -J -t "$target" -S "-${lines}" 2>/dev/null || true)"
+
+  if printf '%s\n' "$pane_text" | grep $grep_flag -- "$pattern" >/dev/null 2>&1; then
+    exit 0
+  fi
+
+  now=$(date +%s)
+  if (( now >= deadline )); then
+    echo "Timed out after ${timeout}s waiting for pattern: $pattern" >&2
+    echo "Last ${lines} lines from $target:" >&2
+    printf '%s\n' "$pane_text" >&2
+    exit 1
+  fi
+
+  sleep "$interval"
+done

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

@@ -0,0 +1,80 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: trades-agriculture
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+
+
+  Agriculture — soil health, crop selection, irrigation, pest management, and sustainable farming practices.
+
+
+  Sources: USDA, OSHA, trade association guidelines, professional kitchen standards.
+---
+
+# Agriculture
+
+## Soil health — the foundation of all agriculture
+
+**Soil composition:** 45% minerals, 25% water, 25% air, 5% organic matter. Healthy soil is alive.
+**Soil texture:** Sand (drains fast), Silt (moderate), Clay (drains slow, holds nutrients). Loam (equal parts) = ideal.
+**Soil pH:** Affects nutrient availability.
+Most crops: pH 6.0-7.0.
+Blueberries: pH 4.5-5.5.
+Acid-loving plants: Rhododendrons, azaleas pH 4.5-6.0.
+Lower pH: Add sulfur. Raise pH: Add lime (calcium carbonate).
+
+**Soil testing:** Do before planting. Test every 2-3 years.
+Measures: pH, macronutrients (N-P-K), micronutrients, organic matter content.
+Cost: $15-30 through cooperative extension services.
+
+**NPK (Nitrogen-Phosphorus-Potassium) — the macronutrients:**
+N (Nitrogen): Leaf and stem growth. Deficiency: yellow leaves starting oldest.
+P (Phosphorus): Root development, flowering, fruiting. Deficiency: purple/reddish leaves.
+K (Potassium): Overall plant health, disease resistance, fruit quality. Deficiency: brown leaf edges.
+
+**Building soil:** Compost (decomposed organic matter) improves all soil types. Add 2-4 inches annually.
+Cover crops: Legumes fix nitrogen (clover, vetch, beans). Plant in fall; till in spring. Reduces erosion.
+
+## Crop selection and rotation
+
+**Match crop to climate:** USDA Hardiness Zone map. Last frost date → planting dates.
+**Companion planting:** Some plants benefit others. Three Sisters: corn, beans, squash. Beans fix nitrogen; corn provides structure; squash shades soil.
+**Crop rotation (4-year cycle):**
+Year 1: Legumes (fix nitrogen)
+Year 2: Brassicas (use nitrogen)
+Year 3: Root vegetables
+Year 4: Alliums or leafy greens
+Prevents soil nutrient depletion, reduces disease and pest buildup.
+
+## Irrigation
+
+**Water timing:** Water deeply and infrequently → encourages deep root development.
+Morning watering: Less evaporation, foliage dries before night (reduces disease).
+**Methods:**
+Drip irrigation: Delivers water directly to root zone. 30-50% water savings vs. overhead. Reduces fungal disease.
+Furrow: Water flows along channels between rows. Simple, good for row crops.
+Overhead sprinkler: Efficient for field crops; promotes foliar disease in gardens.
+Drip + mulch: Best combination for water conservation.
+
+## Pest and disease management (IPM — Integrated Pest Management)
+
+**Prevention first:** Healthy soil, resistant varieties, crop rotation, proper spacing, sanitation.
+**Monitoring:** Scout regularly. Identify the pest correctly before treating.
+**Economic threshold:** Is the pest causing enough damage to justify treatment cost?
+**Biological controls:** Beneficial insects (ladybugs, lacewings), predatory nematodes, Bt (Bacillus thuringiensis) for caterpillars.
+**Chemical controls:** Last resort. Choose least toxic appropriate option. Follow label exactly. Label is law.
+**Resistance management:** Rotate chemical classes.
+
+## Sustainable practices
+
+**No-till/minimum tillage:** Preserves soil structure, organic matter, reduces erosion.
+**Mulching:** 2-4 inch layer. Conserves moisture, suppresses weeds, moderates soil temperature, adds organic matter.
+**Composting:** Turns kitchen/garden waste into soil amendment. Browns (carbon: dried leaves, cardboard) + Greens (nitrogen: food scraps, fresh cuttings) + moisture + turning = 3:1 C:N ratio target.
+**Water harvesting:** Rain barrels, swales, terracing.
+
+Sources: USDA Extension Service publications (free), NRCS soil health (nrcs.usda.gov),
+cooperative extension services by state (land-grant universities),
+IPM guidelines (ipm.ucanr.edu — UC ANR, free)

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

@@ -0,0 +1,84 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: trades-automotive
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+
+  Automotive — maintenance schedules, common repairs, diagnostics, fluid systems, and car buying guidance.
+
+
+
+  Sources: USDA, OSHA, trade association guidelines, professional kitchen standards.
+---
+
+# Automotive Maintenance and Repair
+
+## Maintenance schedule (general — check your owner's manual)
+
+**Every month/3,000 miles:**
+Check engine oil level (dipstick — between min and max when cold).
+Check tire pressure (placard on door jam = correct pressure; NOT tire sidewall max pressure).
+Check other fluid levels: coolant (transparent reservoir), brake fluid, power steering, windshield washer.
+
+**Every 5,000-7,500 miles or 6 months (modern cars):**
+Oil and filter change. (Some modern cars go 10,000+ miles — check your manual.)
+Tire rotation.
+
+**Every 15,000-30,000 miles:**
+Air filter (engine and cabin).
+Tire balance and alignment check.
+Inspect brakes.
+
+**Every 30,000-60,000 miles:**
+Spark plugs (iridium plugs: 60,000-100,000 miles).
+Transmission fluid.
+Coolant flush.
+Drive belts inspection.
+Battery test.
+
+**Every 60,000-100,000 miles:**
+Timing belt (if applicable — interference engine: critical, failure destroys engine).
+Brake fluid flush.
+Power steering fluid.
+Differential fluid.
+
+## Reading warning lights
+
+**Red lights = STOP driving (or take immediate action):**
+Oil pressure: Stop immediately. Low/no oil pressure → engine damage in minutes.
+Temperature: Overheating. Stop and cool down.
+Battery: Charging system failure. May have limited time.
+Brake: Check level or brake problem.
+
+**Yellow/orange lights = Service needed soon:**
+Check engine: Many causes. Get codes read. Steady = manageable. Flashing = catalyst damage risk (reduce load/speed).
+Low tire pressure (TPMS).
+ABS: Anti-lock brakes disabled.
+
+**Reading OBD-II codes:** Plug scanner (basic: $20-50) into port under dash. Reads P, U, B, C codes. Lookup code for likely causes.
+
+## Tires
+
+**Tire pressure:** Check monthly when cold (before driving). See door placard for correct PSI.
+Under-inflated: Poor fuel economy, wear outer edges, handling risk.
+Over-inflated: Wear center, harsh ride, blowout risk.
+
+**Tire reading:** 225/55R17 = 225mm width / 55% aspect ratio / R = radial / 17" wheel.
+**Tread depth:** Quarter test — insert penny head-down; if you see Lincoln's head above tread, replace.
+1/16" (1.6mm) minimum. 2/32" = new tire minimum. Start shopping at 4/32".
+
+**Alignment:** If car pulls to one side or tire wear is uneven, get alignment checked.
+**Balance:** Vibration at highway speed. Check balance.
+
+## Buying a car
+
+**Private seller vs. dealer:** Private = cheaper; dealer = some protections, certified pre-owned warranty.
+**Pre-purchase inspection:** Always pay a mechanic $100-150 to inspect before buying used vehicle.
+**Vehicle history:** Carfax or AutoCheck. Check for: accidents, odometer rollback, flood damage, title issues.
+**True cost of ownership:** Insurance, fuel, maintenance, depreciation, financing. Not just purchase price.
+**Depreciation:** New cars lose 20-30% in first year. 3-year-old cars offer best value typically.
+
+Sources: Car Talk (cartalk.com), Edmunds maintenance guides, NHTSA (nhtsa.gov), RepairPal repair cost estimates

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

@@ -0,0 +1,71 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: trades-carpentry
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+  Carpentry and woodworking — wood types, joinery, tools, furniture, framing, and structural basics.
+
+
+
+
+
+  Sources: USDA, OSHA, trade association guidelines, professional kitchen standards.
+---
+
+# Carpentry and Woodworking
+
+## Wood species and properties
+
+**Hardwoods (from deciduous trees):** Oak, maple, walnut, cherry, poplar. Dense, durable, good for furniture and flooring.
+**Softwoods (from conifers):** Pine, fir, cedar, spruce. Less dense, easier to work, good for framing, exterior.
+**Engineered wood:** Plywood, MDF (medium-density fiberboard), OSB (oriented strand board), LVL. Consistent, no warping.
+
+**Moisture content:** Wood moves as it gains/loses moisture. Kiln-dried lumber (~15-19% MC) vs. air-dried. For interior use, acclimate wood to room conditions 1-2 weeks before using.
+**Wood grain:** Long grain strong; end grain weak and absorbs more finish. Cut with grain for smooth surface.
+
+## Essential hand tools
+
+Tape measure, marking gauge, carpenter's square, combination square, hand saw, chisels (set), mallet, block plane, hand plane, clamps (many!), hammer, nail set.
+**Rules for sharp tools:** Sharp tools are safer than dull ones. Dull tools require more force → slipping → injury. Sharpen chisels and planes regularly.
+
+## Power tools
+
+**Circular saw:** Ripping (with grain) and crosscutting (across grain). Keep blade guard in place. Clamp work. Blade teeth face up.
+**Table saw:** Most accurate cuts. Also most dangerous. Never remove blade guard for production cuts. Never stand directly behind blade (kickback risk). Use push stick.
+**Router:** Shapes edges, cuts joints, makes grooves. Go against rotation direction (climb cut = dangerous for most operations).
+**Drill/driver:** Pilot holes prevent splitting near edges. Choose right bit diameter.
+**Miter saw:** Accurate crosscuts and miters. Safe when material properly clamped.
+
+## Joinery
+
+**Butt joint:** Simple, weakest. Reinforce with glue + screws or pocket screws.
+**Pocket screw joint:** Angled screws from one piece into another. Kreg jig. Fast, strong enough for most furniture.
+**Mortise and tenon:** Traditional, very strong. Tenon fits into mortise hole. Used in chairs, tables, frames.
+**Dovetail:** Interlocking wedge shape. Extremely strong in tension. Used in drawers and boxes. Handcut or router jig.
+**Dado joint:** Groove cut across grain. Accepts shelf or panel. Very common in cabinets.
+**Rabbet joint:** Groove at edge of board. Used for cabinet backs, drawers.
+**Biscuit joint:** Oval biscuit in matched slots. Alignment aid + some strength. Router biscuit joiner needed.
+
+## Framing (house construction basics)
+
+**Platform framing (most common):** Each floor built as a platform before walls raised.
+**Stud spacing:** 16" on center (for most loads), 24" on center (lighter loads, saves material).
+**Load-bearing walls:** Carry structural loads above. Cannot be removed without proper support transfer (header, temporary walls, engineer consultation).
+**Header:** Beam above door/window opening that carries load around the opening.
+**Fasteners:** 16d nails for framing. Ring-shank for superior holding power.
+
+## Wood finishing
+
+**Surface preparation is 90% of a good finish.** Sand progressively: 80 → 120 → 150 → 180 → 220 grit.
+Sand with the grain at fine grits. Remove dust between grits.
+
+**Finish types:**
+Oil finishes (tung oil, danish oil): Easy to apply, low protection, easy to repair. Good for natural look.
+Polyurethane: Durable, waterproof. Oil-based (amber tone, durable, slow dry) or water-based (clear, fast dry, less durable).
+Lacquer: Fast drying, professional results. Requires spray equipment. Not waterproof.
+Shellac: Natural, food-safe, excellent sealer. Dissolves with alcohol. Not heat or water resistant.
+Stain: Color without film. Apply before topcoat. Test on scrap first.
+
+Sources: Taunton Press woodworking guides, Fine Woodworking magazine archive, OSHA hand and power tool safety, This Old House carpentry guides