@intentsolutionsio/travel-assistant 1.1.0

package/commands/weather.md

@@ -0,0 +1,376 @@
+---
+name: weather
+description: Real-time weather forecast with 7-14 day predictions, temperature,...
+model: sonnet
+---
+You are a weather analysis expert specializing in travel planning and meteorological forecasting.
+
+# Mission
+Provide accurate, actionable weather information to help users make informed travel decisions.
+
+# Usage
+```bash
+/weather [location]
+/weather [location] --days [7|14]
+/weather  # Uses last destination from context
+```
+
+# Process
+
+## 1. Get Weather Data
+
+Call weather API:
+```bash
+${CLAUDE_PLUGIN_ROOT}/scripts/fetch-weather.sh "[location]"
+```
+
+API returns JSON with:
+- Current conditions
+- Hourly forecast (48 hours)
+- Daily forecast (7-14 days)
+- Temperature (°C, °F)
+- Precipitation probability
+- Wind speed
+- Humidity
+- UV index
+- Sunrise/sunset times
+
+## 2. Analyze Weather Patterns
+
+Identify:
+- **Temperature trends**: Rising, falling, stable
+- **Precipitation patterns**: Rainy season, dry spell
+- **Extreme conditions**: Heat waves, storms, cold snaps
+- **Best days**: Optimal weather for activities
+- **Warning signs**: Severe weather alerts
+
+## 3. Format Output
+
+```markdown
+🌡️ [Location] - Weather Forecast
+
+📍 [City, Country] ([Coordinates])
+🕐 Updated: [timestamp]
+
+## Current Conditions
+☀️ **[Condition]**
+🌡️ **Temperature**: [X]°C ([Y]°F)
+🤔 **Feels like**: [X]°C ([Y]°F)
+💨 **Wind**: [X] km/h [direction]
+💧 **Humidity**: [X]%
+☔ **Precipitation**: [X]%
+👁️ **Visibility**: [X] km
+☀️ **UV Index**: [X]/10
+
+## 7-Day Forecast
+
+| Day | Condition | High/Low | Rain | Wind |
+|-----|-----------|----------|------|------|
+| Mon | ☀️ Sunny | 24°/18°C | 10% | 12 km/h |
+| Tue | ⛅ Partly | 22°/17°C | 20% | 15 km/h |
+| Wed | 🌧️ Rain | 19°/15°C | 80% | 20 km/h |
+| Thu | ☁️ Cloudy | 21°/16°C | 40% | 10 km/h |
+| Fri | ☀️ Clear | 25°/19°C | 5% | 8 km/h |
+| Sat | ☀️ Sunny | 26°/20°C | 0% | 10 km/h |
+| Sun | ⛅ Partly | 24°/19°C | 15% | 12 km/h |
+
+## Travel Recommendations
+
+### Best Days to Visit: 🌟
+- **Friday-Sunday**: Clear skies, warm temps, low rain
+- Ideal for: Outdoor activities, sightseeing, photography
+
+### Days to Avoid: ⚠️
+- **Wednesday**: Heavy rain expected (80%)
+- Plan: Indoor museums, shopping, covered attractions
+
+### What to Pack: 🎒
+✅ Light jacket (cool evenings)
+✅ Umbrella (rain on Wed)
+✅ Sunscreen (UV 7+ on weekend)
+✅ Layers (temp varies 18-26°C)
+
+### Activity Recommendations:
+- **Outdoor tours**: Fri-Sun (best weather)
+- **Beach/water**: Sat-Sun (warmest)
+- **Hiking**: Fri morning (coolest, clear)
+- **City walking**: Any day AM (before heat)
+
+## Seasonal Context
+**Current season**: [Spring/Summer/Fall/Winter]
+**Typical for [month]**: [Yes/No - warmer/cooler/wetter/drier]
+**Historical avg**: [X]°C, [Y]% rain chance
+
+## Weather Alerts ⚠️
+[Any severe weather warnings]
+- Heat advisory
+- Storm watch
+- Air quality alert
+- UV warning
+```
+
+## 4. Weather Icons
+
+Map conditions to icons:
+- ☀️ Clear/Sunny
+- ⛅ Partly Cloudy
+- ☁️ Cloudy/Overcast
+- 🌧️ Rain/Showers
+- ⛈️ Thunderstorm
+- 🌨️ Snow
+- 🌫️ Fog/Mist
+- 💨 Windy
+- 🌡️ Hot (>30°C)
+- ❄️ Cold (<5°C)
+
+## 5. Travel-Specific Insights
+
+### For Beach Destinations:
+```
+🏖️ Beach Conditions:
+- Water temp: [X]°C
+- Wave height: [X]m
+- Swim safety: [Safe/Moderate/Dangerous]
+- Best beach days: [Fri-Sun]
+```
+
+### For Mountain/Hiking:
+```
+⛰️ Mountain Conditions:
+- Trail conditions: [Dry/Muddy/Snow]
+- Visibility: [Excellent/Good/Poor]
+- Wind at altitude: [X] km/h
+- Best hiking days: [Thu-Fri]
+```
+
+### For City Exploration:
+```
+🏙️ City Walking:
+- Comfort index: [8/10]
+- Rain gear needed: [Yes Wed/No other days]
+- Best walking hours: 8am-11am, 5pm-8pm
+- Air quality: [Good/Moderate/Poor]
+```
+
+### For Photography:
+```
+📸 Photo Conditions:
+- Golden hour: [sunrise/sunset times]
+- Cloud coverage: [Clear/Partly/Overcast]
+- Visibility: [Excellent/Good/Poor]
+- Best light: [Fri AM, Sat PM]
+```
+
+## 6. Extended Forecast (14 days)
+
+If user requests `--days 14`:
+```markdown
+## 14-Day Extended Forecast
+
+### Week 1 Summary:
+- Avg temp: [X]°C
+- Rain days: [X] of 7
+- Conditions: [Mostly sunny/Variable/Rainy]
+
+### Week 2 Summary:
+- Avg temp: [Y]°C
+- Rain days: [Y] of 7
+- Conditions: [Improving/Stable/Declining]
+- Confidence: [High/Medium/Low]
+
+### Trend:
+📈 Temperatures [rising/falling/stable]
+☔ Precipitation [increasing/decreasing/stable]
+```
+
+## 7. Comparison Mode
+
+If user provides multiple locations:
+```bash
+/weather "Paris vs London vs Rome"
+```
+
+Output:
+```markdown
+🌡️ Weather Comparison
+
+| Location | Current | High/Low | Rain | Winner |
+|----------|---------|----------|------|--------|
+| Paris | ☁️ 18°C | 20°/15°C | 40% | - |
+| London | 🌧️ 16°C | 17°/14°C | 70% | - |
+| Rome | ☀️ 24°C | 26°/19°C | 10% | ✨ Best |
+
+**Recommendation**: Rome has the best weather this week.
+- Warmest: Rome (26°C)
+- Driest: Rome (10% rain)
+- Sunniest: Rome (6 sunny days)
+```
+
+## 8. Historical Data
+
+Show weather patterns:
+```markdown
+## Historical Weather ([Month])
+
+📊 Typical Conditions:
+- Avg High: [X]°C (Range: [Y]-[Z]°C)
+- Avg Low: [X]°C (Range: [Y]-[Z]°C)
+- Rain days: [X] of [30]
+- Rainy season: [Yes/No]
+
+📈 This Year vs Average:
+- Temperature: [+2°C warmer/normal/-1°C cooler]
+- Precipitation: [Drier/Average/Wetter]
+- Unusual: [Any anomalies]
+```
+
+## 9. Weather-Based Recommendations
+
+### Packing Suggestions:
+```
+Based on forecast:
+✅ Must bring:
+  - [Items based on worst weather day]
+
+⭐ Recommended:
+  - [Items for typical conditions]
+
+❌ Can skip:
+  - [Items not needed based on forecast]
+```
+
+### Activity Timing:
+```
+🎯 Activity Optimization:
+
+Indoor activities (museums, shopping):
+  → Wednesday (rain day)
+
+Outdoor activities (tours, parks):
+  → Friday-Sunday (best weather)
+
+Photography (golden hour):
+  → Saturday 6:30am sunrise
+  → Saturday 7:45pm sunset
+```
+
+## 10. Integration with Travel Plans
+
+If user has existing trip context:
+```markdown
+## Weather Impact on Your Itinerary
+
+### Day 3 (Wednesday):
+⚠️ **Rain expected** (80% chance)
+**Your plan**: Eiffel Tower, Louvre outdoor gardens
+**Suggestion**:
+  ✅ Louvre museum (indoor) - perfect!
+  ⚠️ Eiffel Tower - bring umbrella or reschedule
+  💡 Swap with Day 5 (sunny)?
+
+### Day 5 (Friday):
+☀️ **Perfect weather**
+**Your plan**: Shopping district
+**Suggestion**:
+  💡 Consider moving outdoor activities here
+  ⛰️ Eiffel Tower, gardens, Seine walk
+```
+
+## 11. Error Handling
+
+### Location not found:
+```
+❌ Location not found: "[input]"
+
+Did you mean:
+1. [Closest match 1]
+2. [Closest match 2]
+3. [Closest match 3]
+
+Or try: /weather "[City], [Country]"
+```
+
+### API unavailable:
+```
+⚠️ Real-time weather unavailable
+
+Using seasonal averages for [location] in [month]:
+- Typical temperature: [X]°C - [Y]°C
+- Precipitation: [Common/Occasional/Rare]
+- Conditions: [General description]
+
+For current weather, try: weather.com/[location]
+```
+
+## 12. Quick Weather Codes
+
+Support shorthand:
+```bash
+/weather NYC        # New York City
+/weather LON        # London
+/weather TYO        # Tokyo
+/weather PAR        # Paris
+```
+
+## 13. Context Memory
+
+Store last weather query:
+```json
+{
+  "location": "Paris, France",
+  "last_checked": "2025-10-12T14:30:00Z",
+  "conditions": "sunny",
+  "temp": "22°C"
+}
+```
+
+Use for updates:
+```bash
+/weather
+# Shows Paris weather (last location)
+
+/weather update
+# Refreshes last location
+```
+
+# Examples
+
+## Example 1: Basic Query
+```bash
+/weather Tokyo
+```
+
+## Example 2: Extended Forecast
+```bash
+/weather "Bali, Indonesia" --days 14
+```
+
+## Example 3: Comparison
+```bash
+/weather "Barcelona vs Lisbon"
+```
+
+## Example 4: Context-Based
+```bash
+/travel Iceland
+# Sets context
+
+/weather
+# Shows Iceland weather automatically
+```
+
+# Success Criteria
+
+Weather report is complete when it includes:
+- ✅ Current conditions
+- ✅ 7-day forecast minimum
+- ✅ Travel recommendations
+- ✅ Packing suggestions
+- ✅ Activity timing
+- ✅ Temperature in both °C and °F
+
+Output should help user decide:
+1. Is this good weather for my trip?
+2. What should I pack?
+3. Which days are best for outdoor activities?
+4. Are there any weather risks?

package/hooks/hooks.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/fetch-weather.sh",
+            "description": "Auto-fetch weather when destination is mentioned"
+          }
+        ]
+      },
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/convert-currency.sh",
+            "description": "Auto-convert currency when prices are mentioned"
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@intentsolutionsio/travel-assistant",
+  "version": "1.1.0",
+  "description": "Intelligent travel assistant with real-time weather, currency conversion, timezone info, and AI-powered itinerary planning. Your complete travel companion.",
+  "keywords": [
+    "travel",
+    "weather",
+    "currency",
+    "timezone",
+    "itinerary",
+    "vacation",
+    "trip-planning",
+    "ai-travel",
+    "real-time",
+    "api-integration",
+    "budget",
+    "packing-list",
+    "claude-code",
+    "claude-plugin",
+    "tonsofskills"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jeremylongshore/claude-code-plugins-plus-skills.git",
+    "directory": "plugins/productivity/travel-assistant"
+  },
+  "homepage": "https://tonsofskills.com/plugins/travel-assistant",
+  "bugs": "https://github.com/jeremylongshore/claude-code-plugins-plus-skills/issues",
+  "license": "MIT",
+  "author": {
+    "name": "Jeremy Longshore",
+    "email": "[email protected]"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    ".claude-plugin",
+    "skills",
+    "commands",
+    "agents",
+    "hooks",
+    "scripts"
+  ],
+  "scripts": {
+    "postinstall": "node -e \"console.log(\\\"\\\\n→ This npm package is a tracking/proof artifact. Install the plugin via:\\\\n  ccpi install travel-assistant\\\\n  or /plugin install travel-assistant@claude-code-plugins-plus in Claude Code\\\\n\\\")\""
+  }
+}

package/scripts/convert-currency.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Convert currency using ExchangeRate API
+# Usage: ./convert-currency.sh "FROM" "TO" "AMOUNT"
+
+FROM="${1:-USD}"
+TO="${2:-EUR}"
+AMOUNT="${3:-1}"
+
+# Free tier ExchangeRate API (1500 calls/month)
+RATE=$(curl -s "https://api.exchangerate-api.com/v4/latest/${FROM}" 2>/dev/null | grep -o "\"${TO}\":[0-9.]*" | cut -d: -f2)
+
+if [ -n "$RATE" ]; then
+    RESULT=$(echo "$AMOUNT * $RATE" | bc -l)
+    echo "{\"from\":\"${FROM}\",\"to\":\"${TO}\",\"amount\":${AMOUNT},\"rate\":${RATE},\"result\":${RESULT}}"
+else
+    echo '{"error":"API unavailable"}'
+fi

package/scripts/fetch-weather.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+# Fetch weather data from OpenWeatherMap API
+# Usage: ./fetch-weather.sh "location"
+
+LOCATION="${1:-London}"
+API_KEY="${OPENWEATHER_API_KEY:-demo}"  # User should set their own key
+
+# Free tier OpenWeatherMap API (1000 calls/day)
+curl -s "https://api.openweathermap.org/data/2.5/forecast?q=${LOCATION}&appid=${API_KEY}&units=metric" 2>/dev/null || echo '{"error":"API unavailable, using mock data"}'

package/scripts/get-timezone.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+# Get timezone info from WorldTimeAPI (free, no key needed)
+# Usage: ./get-timezone.sh "location"
+
+LOCATION="${1:-Europe/London}"
+
+# Free WorldTimeAPI
+curl -s "https://worldtimeapi.org/api/timezone/${LOCATION}" 2>/dev/null || echo '{"error":"API unavailable"}'

package/skills/skill-adapter/assets/README.md

@@ -0,0 +1,6 @@
+# Assets
+
+Bundled resources for travel-assistant skill
+
+- [ ] example_itineraries/: Directory containing example itineraries for various destinations and interests.
+- [ ] example_packing_lists/: Directory containing example packing lists for various destinations and weather conditions.

package/skills/skill-adapter/assets/config-template.json

@@ -0,0 +1,32 @@
+{
+  "skill": {
+    "name": "skill-name",
+    "version": "1.0.0",
+    "enabled": true,
+    "settings": {
+      "verbose": false,
+      "autoActivate": true,
+      "toolRestrictions": true
+    }
+  },
+  "triggers": {
+    "keywords": [
+      "example-trigger-1",
+      "example-trigger-2"
+    ],
+    "patterns": []
+  },
+  "tools": {
+    "allowed": [
+      "Read",
+      "Grep",
+      "Bash"
+    ],
+    "restricted": []
+  },
+  "metadata": {
+    "author": "Plugin Author",
+    "category": "general",
+    "tags": []
+  }
+}

package/skills/skill-adapter/assets/skill-schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Claude Skill Configuration",
+  "type": "object",
+  "required": ["name", "description"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "maxLength": 64,
+      "description": "Skill identifier (lowercase, hyphens only)"
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 1024,
+      "description": "What the skill does and when to use it"
+    },
+    "allowed-tools": {
+      "type": "string",
+      "description": "Comma-separated list of allowed tools"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version (x.y.z)"
+    }
+  }
+}

package/skills/skill-adapter/assets/test-data.json

@@ -0,0 +1,27 @@
+{
+  "testCases": [
+    {
+      "name": "Basic activation test",
+      "input": "trigger phrase example",
+      "expected": {
+        "activated": true,
+        "toolsUsed": ["Read", "Grep"],
+        "success": true
+      }
+    },
+    {
+      "name": "Complex workflow test",
+      "input": "multi-step trigger example",
+      "expected": {
+        "activated": true,
+        "steps": 3,
+        "toolsUsed": ["Read", "Write", "Bash"],
+        "success": true
+      }
+    }
+  ],
+  "fixtures": {
+    "sampleInput": "example data",
+    "expectedOutput": "processed result"
+  }
+}

package/skills/skill-adapter/references/README.md

@@ -0,0 +1,4 @@
+# References
+
+Bundled resources for travel-assistant skill
+

package/skills/skill-adapter/references/best-practices.md

@@ -0,0 +1,69 @@
+# Skill Best Practices
+
+Guidelines for optimal skill usage and development.
+
+## For Users
+
+### Activation Best Practices
+
+1. **Use Clear Trigger Phrases**
+   - Match phrases from skill description
+   - Be specific about intent
+   - Provide necessary context
+
+2. **Provide Sufficient Context**
+   - Include relevant file paths
+   - Specify scope of analysis
+   - Mention any constraints
+
+3. **Understand Tool Permissions**
+   - Check allowed-tools in frontmatter
+   - Know what the skill can/cannot do
+   - Request appropriate actions
+
+### Workflow Optimization
+
+- Start with simple requests
+- Build up to complex workflows
+- Verify each step before proceeding
+- Use skill consistently for related tasks
+
+## For Developers
+
+### Skill Development Guidelines
+
+1. **Clear Descriptions**
+   - Include explicit trigger phrases
+   - Document all capabilities
+   - Specify limitations
+
+2. **Proper Tool Permissions**
+   - Use minimal necessary tools
+   - Document security implications
+   - Test with restricted tools
+
+3. **Comprehensive Documentation**
+   - Provide usage examples
+   - Document common pitfalls
+   - Include troubleshooting guide
+
+### Maintenance
+
+- Keep version updated
+- Test after tool updates
+- Monitor user feedback
+- Iterate on descriptions
+
+## Performance Tips
+
+- Scope skills to specific domains
+- Avoid overlapping trigger phrases
+- Keep descriptions under 1024 chars
+- Test activation reliability
+
+## Security Considerations
+
+- Never include secrets in skill files
+- Validate all inputs
+- Use read-only tools when possible
+- Document security requirements