@intentsolutionsio/travel-assistant 1.1.0 β†’ 1.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -7,6 +7,7 @@
7
7
  ## 🎯 What This Plugin Does
8
8
 
9
9
  Transform travel planning from hours of research into minutes of AI-powered assistance:
10
+
10
11
  - 🌑️ **Real-time weather** - 7-14 day forecasts with packing recommendations
11
12
  - πŸ’± **Currency conversion** - Live exchange rates with budget breakdowns
12
13
  - πŸ—ΊοΈ **Smart itineraries** - Personalized day-by-day plans
@@ -19,11 +20,13 @@ Transform travel planning from hours of research into minutes of AI-powered assi
19
20
  ## πŸš€ Quick Start
20
21
 
21
22
  ### Installation
23
+
22
24
  ```bash
23
25
  /plugin install travel-assistant@claude-code-plugins-plus
24
26
  ```
25
27
 
26
28
  ### Basic Usage
29
+
27
30
  ```bash
28
31
  # Complete travel plan
29
32
  /travel "Tokyo, Japan" --days 7 --budget 3000
@@ -49,6 +52,7 @@ Transform travel planning from hours of research into minutes of AI-powered assi
49
52
  ## πŸ’‘ Core Features
50
53
 
51
54
  ### 1. Complete Travel Planning (`/travel`)
55
+
52
56
  One command for comprehensive trip planning:
53
57
 
54
58
  ```bash
@@ -56,6 +60,7 @@ One command for comprehensive trip planning:
56
60
  ```
57
61
 
58
62
  **Includes**:
63
+
59
64
  - βœ… 7-14 day weather forecast
60
65
  - βœ… Complete budget breakdown
61
66
  - βœ… Day-by-day itinerary
@@ -65,11 +70,13 @@ One command for comprehensive trip planning:
65
70
  - βœ… Transportation guide
66
71
 
67
72
  **Multi-city support**:
73
+
68
74
  ```bash
69
75
  /travel "Rome β†’ Florence β†’ Venice" --days 12
70
76
  ```
71
77
 
72
78
  ### 2. Weather Intelligence (`/weather`)
79
+
73
80
  Real-time weather with travel insights:
74
81
 
75
82
  ```bash
@@ -77,6 +84,7 @@ Real-time weather with travel insights:
77
84
  ```
78
85
 
79
86
  **Provides**:
87
+
80
88
  - Current conditions + feels like
81
89
  - 7-14 day detailed forecast
82
90
  - Best days for outdoor activities
@@ -85,11 +93,13 @@ Real-time weather with travel insights:
85
93
  - UV index & air quality
86
94
 
87
95
  **Compare destinations**:
96
+
88
97
  ```bash
89
98
  /weather "Barcelona vs Lisbon vs Athens"
90
99
  ```
91
100
 
92
101
  ### 3. Currency Mastery (`/currency`)
102
+
93
103
  Smart currency conversion and budgeting:
94
104
 
95
105
  ```bash
@@ -97,6 +107,7 @@ Smart currency conversion and budgeting:
97
107
  ```
98
108
 
99
109
  **Features**:
110
+
100
111
  - Real-time exchange rates
101
112
  - 30-day historical trends
102
113
  - Budget breakdowns by category
@@ -105,12 +116,14 @@ Smart currency conversion and budgeting:
105
116
  - Purchasing power comparison
106
117
 
107
118
  **Budget planning**:
119
+
108
120
  ```bash
109
121
  /currency 3000 USD JPY --budget
110
122
  # Shows: per-day spending, category splits, optimization tips
111
123
  ```
112
124
 
113
125
  ### 4. AI Itinerary Generator (`/itinerary`)
126
+
114
127
  Personalized day-by-day travel plans:
115
128
 
116
129
  ```bash
@@ -118,6 +131,7 @@ Personalized day-by-day travel plans:
118
131
  ```
119
132
 
120
133
  **Optimization**:
134
+
121
135
  - Geographic clustering (minimize travel time)
122
136
  - Weather-based scheduling
123
137
  - Energy management (intense β†’ relaxed rotation)
@@ -126,11 +140,13 @@ Personalized day-by-day travel plans:
126
140
  - Booking requirements noted
127
141
 
128
142
  **Customization options**:
143
+
129
144
  - `--interests`: food, culture, adventure, nature, art, nightlife
130
145
  - `--pace`: relaxed, moderate, packed
131
146
  - `--budget`: budget, mid-range, luxury
132
147
 
133
148
  ### 5. Smart Packing (`/pack`)
149
+
134
150
  Never forget essentials again:
135
151
 
136
152
  ```bash
@@ -138,6 +154,7 @@ Never forget essentials again:
138
154
  ```
139
155
 
140
156
  **Generates lists based on**:
157
+
141
158
  - Weather forecast (temperature, rain, wind)
142
159
  - Planned activities
143
160
  - Trip duration
@@ -145,6 +162,7 @@ Never forget essentials again:
145
162
  - Season and destination
146
163
 
147
164
  **Categories**:
165
+
148
166
  - Clothing (weather-appropriate)
149
167
  - Electronics & adapters
150
168
  - Documents & money
@@ -152,6 +170,7 @@ Never forget essentials again:
152
170
  - Activity-specific gear
153
171
 
154
172
  ### 6. Timezone Coordination (`/timezone`)
173
+
155
174
  Time zone mastery for global travelers:
156
175
 
157
176
  ```bash
@@ -159,6 +178,7 @@ Time zone mastery for global travelers:
159
178
  ```
160
179
 
161
180
  **Features**:
181
+
162
182
  - Current time in any location
163
183
  - UTC offsets & DST status
164
184
  - Meeting scheduler
@@ -174,26 +194,34 @@ Time zone mastery for global travelers:
174
194
  ## πŸ€– AI Agents
175
195
 
176
196
  ### travel-planner
197
+
177
198
  **Master orchestrator** coordinating all travel aspects
199
+
178
200
  - Synthesizes weather, budget, itinerary
179
201
  - Optimizes scheduling
180
202
  - Ensures comprehensive planning
181
203
 
182
204
  ### weather-analyst
205
+
183
206
  **Meteorological expert** for travel timing
207
+
184
208
  - Forecast interpretation
185
209
  - Activity-weather matching
186
210
  - Seasonal pattern analysis
187
211
 
188
212
  ### local-expert
213
+
189
214
  **Cultural guide** for authentic experiences
215
+
190
216
  - Customs & etiquette
191
217
  - Hidden gems & local favorites
192
218
  - Safety tips & scam awareness
193
219
  - Language essentials
194
220
 
195
221
  ### budget-calculator
222
+
196
223
  **Financial planner** for cost optimization
224
+
197
225
  - Accurate cost estimation
198
226
  - Budget breakdown by category
199
227
  - Money-saving strategies
@@ -204,6 +232,7 @@ Time zone mastery for global travelers:
204
232
  ## πŸ”— Command Combinations
205
233
 
206
234
  ### Scenario 1: Planning a Trip
235
+
207
236
  ```bash
208
237
  # Step 1: Get complete plan
209
238
  /travel "Tokyo" --days 7 --budget 3000
@@ -219,6 +248,7 @@ Time zone mastery for global travelers:
219
248
  ```
220
249
 
221
250
  ### Scenario 2: Budget Optimization
251
+
222
252
  ```bash
223
253
  # Check budget
224
254
  /currency 2000 USD JPY --budget
@@ -231,6 +261,7 @@ Time zone mastery for global travelers:
231
261
  ```
232
262
 
233
263
  ### Scenario 3: Multi-City Europe Trip
264
+
234
265
  ```bash
235
266
  # Plan route
236
267
  /travel "Paris β†’ Amsterdam β†’ Berlin" --days 15
@@ -252,6 +283,7 @@ Time zone mastery for global travelers:
252
283
  ## βš™οΈ Configuration
253
284
 
254
285
  ### API Keys (Optional)
286
+
255
287
  For real-time data, set up free API keys:
256
288
 
257
289
  ```bash
@@ -263,6 +295,7 @@ export EXCHANGERATE_API_KEY="your_key_here"
263
295
  ```
264
296
 
265
297
  **Get free keys**:
298
+
266
299
  - Weather: https://openweathermap.org/api (1000 calls/day free)
267
300
  - Currency: https://www.exchangerate-api.com (1500 calls/month free)
268
301
  - Timezone: WorldTimeAPI (no key needed, unlimited)
@@ -274,7 +307,8 @@ export EXCHANGERATE_API_KEY="your_key_here"
274
307
  ## πŸ“Š Real-World Examples
275
308
 
276
309
  ### Example 1: Solo Backpacker
277
- ```bash
310
+
311
+ ```text
278
312
  /travel "Thailand" --days 21 --budget 1500 --interests "beaches,temples,food"
279
313
 
280
314
  Output:
@@ -286,6 +320,7 @@ Output:
286
320
  ```
287
321
 
288
322
  ### Example 2: Luxury Couple's Trip
323
+
289
324
  ```bash
290
325
  /travel "Maldives" --days 10 --budget 15000 --pace relaxed
291
326
 
@@ -299,7 +334,8 @@ Output:
299
334
  ```
300
335
 
301
336
  ### Example 3: Family Vacation
302
- ```bash
337
+
338
+ ```text
303
339
  /travel "Orlando, Florida" --days 7 --group "2 adults, 2 kids (ages 6,9)"
304
340
 
305
341
  Output:
@@ -311,7 +347,8 @@ Output:
311
347
  ```
312
348
 
313
349
  ### Example 4: Digital Nomad
314
- ```bash
350
+
351
+ ```text
315
352
  /travel "Lisbon" --days 30 --work-remote
316
353
 
317
354
  Output:
@@ -327,12 +364,14 @@ Output:
327
364
  ## 🎯 Pro Tips
328
365
 
329
366
  ### Maximize Value
367
+
330
368
  1. **Use context**: `/travel Tokyo` then `/weather` auto-uses Tokyo
331
369
  2. **Compare destinations**: Find the best weather/budget combo
332
370
  3. **Flexible dates**: Get better prices and weather
333
371
  4. **Local insights**: Hidden gems beat tourist traps
334
372
 
335
373
  ### Save Money
374
+
336
375
  - Book flights 6-8 weeks in advance
337
376
  - Stay outside tourist centers
338
377
  - Eat where locals eat (ask agents!)
@@ -340,6 +379,7 @@ Output:
340
379
  - City passes for multiple attractions
341
380
 
342
381
  ### Pack Smart
382
+
343
383
  - Roll clothes (saves 30% space)
344
384
  - Wear bulkiest items on plane
345
385
  - Leave 20% space for souvenirs
@@ -351,15 +391,18 @@ Output:
351
391
  ## πŸ”§ Troubleshooting
352
392
 
353
393
  ### Weather not showing?
394
+
354
395
  - Set `OPENWEATHER_API_KEY` environment variable
355
396
  - Or plugin will use seasonal averages
356
397
 
357
398
  ### Currency not converting?
399
+
358
400
  - Check internet connection
359
401
  - Verify currency codes (USD, EUR, GBP, etc.)
360
402
  - Plugin falls back to last known rates
361
403
 
362
404
  ### Itinerary too packed?
405
+
363
406
  - Add `--pace relaxed` flag
364
407
  - Reduce daily activities
365
408
  - Include rest days for longer trips
@@ -369,11 +412,13 @@ Output:
369
412
  ## πŸ“ˆ Performance
370
413
 
371
414
  **Time Savings**:
415
+
372
416
  - Manual planning: 4-6 hours
373
417
  - With Travel Assistant: 5-10 minutes
374
418
  - **Saves**: ~5 hours per trip
375
419
 
376
420
  **Cost Optimization**:
421
+
377
422
  - Budget recommendations: Save 20-30%
378
423
  - Currency tips: Save 5-10% on exchange
379
424
  - Hidden gems: Authentic + cheaper experiences
@@ -383,6 +428,7 @@ Output:
383
428
  ## 🀝 Integration
384
429
 
385
430
  Works great with:
431
+
386
432
  - **overnight-dev**: Plan trips while Claude codes overnight
387
433
  - **ai-commit-gen**: Commit travel plans to git
388
434
  - **devops-automation-pack**: Automate trip documentation
@@ -405,6 +451,7 @@ Works great with:
405
451
  ## 🌟 Why Travel Assistant?
406
452
 
407
453
  **Before**: Hours of research across multiple sites
454
+
408
455
  - Weather.com for forecast
409
456
  - XE.com for currency
410
457
  - TripAdvisor for attractions
@@ -412,6 +459,7 @@ Works great with:
412
459
  - Manual itinerary planning
413
460
 
414
461
  **After**: One plugin, complete planning
462
+
415
463
  - All data in one place
416
464
  - AI-optimized itineraries
417
465
  - Context-aware recommendations
@@ -8,6 +8,7 @@ model: sonnet
8
8
  You are a travel financial planner specializing in budget optimization.
9
9
 
10
10
  # Expertise
11
+
11
12
  - Accurate cost estimation by destination
12
13
  - Budget breakdown (accommodation, food, activities)
13
14
  - Cost-saving strategies
@@ -16,6 +17,7 @@ You are a travel financial planner specializing in budget optimization.
16
17
  - Budget tier recommendations
17
18
 
18
19
  # Cost Categories
20
+
19
21
  1. **Transportation**: Flights, local transit
20
22
  2. **Accommodation**: Hotels, Airbnb, hostels
21
23
  3. **Food**: Budget/mid-range/luxury dining
@@ -23,11 +25,13 @@ You are a travel financial planner specializing in budget optimization.
23
25
  5. **Miscellaneous**: Insurance, tips, emergency (10%)
24
26
 
25
27
  # Budget Tiers (per day)
28
+
26
29
  - **Budget**: $50-100
27
30
  - **Mid-range**: $100-250
28
31
  - **Luxury**: $250-500+
29
32
 
30
33
  # Optimization Tips
34
+
31
35
  - Book flights 6-8 weeks advance
32
36
  - Stay outside tourist centers
33
37
  - Eat where locals eat
@@ -8,6 +8,7 @@ model: sonnet
8
8
  You are a local cultural expert with deep knowledge of destinations worldwide.
9
9
 
10
10
  # Expertise
11
+
11
12
  - Local customs & etiquette
12
13
  - Hidden gems & off-beaten-path
13
14
  - Authentic dining (not tourist traps)
@@ -17,6 +18,7 @@ You are a local cultural expert with deep knowledge of destinations worldwide.
17
18
  - Local transportation tips
18
19
 
19
20
  # Recommendations Structure
21
+
20
22
  - **Cultural Insights**: Customs, etiquette, norms
21
23
  - **Hidden Gems**: Non-touristy experiences
22
24
  - **Food**: Local specialties, best markets
@@ -8,9 +8,11 @@ model: sonnet
8
8
  You are a master travel planner who coordinates all aspects of trip planning through specialized expertise.
9
9
 
10
10
  # Your Role
11
+
11
12
  Orchestrate comprehensive travel plans by coordinating weather analysis, budget calculations, itinerary creation, and packing optimization.
12
13
 
13
14
  # When to Activate
15
+
14
16
  - User wants complete travel plan
15
17
  - Multi-faceted trip requiring coordination
16
18
  - Complex itineraries needing optimization
@@ -19,6 +21,7 @@ Orchestrate comprehensive travel plans by coordinating weather analysis, budget
19
21
  # Coordination Strategy
20
22
 
21
23
  ## Step 1: Gather Requirements
24
+
22
25
  - Destination(s)
23
26
  - Duration
24
27
  - Budget
@@ -27,12 +30,14 @@ Orchestrate comprehensive travel plans by coordinating weather analysis, budget
27
30
  - Pace (relaxed/moderate/packed)
28
31
 
29
32
  ## Step 2: Call Specialists
33
+
30
34
  1. **Weather Analyst** β†’ Get forecast, best days
31
35
  2. **Budget Calculator** β†’ Estimate costs, optimize spending
32
36
  3. **Local Expert** β†’ Cultural tips, hidden gems
33
37
  4. **(Self)** β†’ Synthesize into complete plan
34
38
 
35
39
  ## Step 3: Create Deliverables
40
+
36
41
  - Day-by-day itinerary
37
42
  - Weather-optimized schedule
38
43
  - Budget breakdown
@@ -40,4 +45,5 @@ Orchestrate comprehensive travel plans by coordinating weather analysis, budget
40
45
  - Local tips
41
46
 
42
47
  # Output
48
+
43
49
  Comprehensive travel plan ready for booking and execution.
@@ -8,6 +8,7 @@ model: sonnet
8
8
  You are a meteorological expert specializing in travel weather analysis.
9
9
 
10
10
  # Expertise
11
+
11
12
  - 7-14 day forecast interpretation
12
13
  - Seasonal pattern recognition
13
14
  - Activity-weather matching
@@ -15,6 +16,7 @@ You are a meteorological expert specializing in travel weather analysis.
15
16
  - Best travel timing
16
17
 
17
18
  # Analysis Framework
19
+
18
20
  1. Fetch current + forecast data
19
21
  2. Identify weather patterns
20
22
  3. Flag extreme conditions
@@ -22,6 +24,7 @@ You are a meteorological expert specializing in travel weather analysis.
22
24
  5. Suggest weather-appropriate packing
23
25
 
24
26
  # Recommendations
27
+
25
28
  - **Outdoor activities**: Clear, low wind days
26
29
  - **Indoor backup**: Rain/storm days
27
30
  - **Photography**: Golden hour timing
@@ -6,9 +6,11 @@ model: sonnet
6
6
  You are a financial expert specializing in currency exchange and travel budgeting.
7
7
 
8
8
  # Mission
9
+
9
10
  Provide accurate currency conversion, exchange rate analysis, and budget recommendations for international travelers.
10
11
 
11
12
  # Usage
13
+
12
14
  ```bash
13
15
  /currency [amount] [from] [to]
14
16
  /currency 100 USD EUR
@@ -21,12 +23,14 @@ Provide accurate currency conversion, exchange rate analysis, and budget recomme
21
23
  ## 1. Parse Input
22
24
 
23
25
  Extract:
26
+
24
27
  - **Amount**: Numeric value to convert
25
28
  - **From currency**: Source currency code (ISO 4217)
26
29
  - **To currency**: Target currency code
27
30
  - **Context**: Use trip destination if available
28
31
 
29
32
  Examples:
33
+
30
34
  ```
31
35
  /currency 100 USD EUR
32
36
  β†’ Convert $100 to euros
@@ -41,11 +45,13 @@ Examples:
41
45
  ## 2. Fetch Exchange Rates
42
46
 
43
47
  Call currency API:
48
+
44
49
  ```bash
45
50
  ${CLAUDE_PLUGIN_ROOT}/scripts/convert-currency.sh "[from]" "[to]" "[amount]"
46
51
  ```
47
52
 
48
53
  API returns:
54
+
49
55
  ```json
50
56
  {
51
57
  "base": "USD",
@@ -169,11 +175,13 @@ If amount suggests budget planning:
169
175
  ## 6. Multi-Currency Conversion
170
176
 
171
177
  If user needs multiple currencies:
178
+
172
179
  ```bash
173
180
  /currency 1000 USD "EUR,GBP,JPY,AUD"
174
181
  ```
175
182
 
176
183
  Output:
184
+
177
185
  ```markdown
178
186
  πŸ’± Multi-Currency Conversion
179
187
 
@@ -190,6 +198,7 @@ Output:
190
198
  ## 7. Currency Comparison
191
199
 
192
200
  Show purchasing power:
201
+
193
202
  ```markdown
194
203
  ### Purchasing Power Comparison
195
204
 
@@ -213,6 +222,7 @@ Show purchasing power:
213
222
  ## 8. Exchange Rate Alerts
214
223
 
215
224
  Set up alerts:
225
+
216
226
  ```markdown
217
227
  ### Rate Alert Setup
218
228
 
@@ -253,24 +263,28 @@ At destination:
253
263
  ### Major Currencies
254
264
 
255
265
  **Euro (EUR)**:
266
+
256
267
  - Used in 20 countries
257
268
  - ATMs widely available
258
269
  - Credit cards accepted most places
259
270
  - Tip: Get small bills (€5, €10)
260
271
 
261
272
  **British Pound (GBP)**:
273
+
262
274
  - UK only (not Scotland notes everywhere)
263
275
  - Contactless very common
264
276
  - ATMs charge fees sometimes
265
277
  - Tip: Use Oyster/contactless for transport
266
278
 
267
279
  **Japanese Yen (JPY)**:
280
+
268
281
  - Cash-heavy culture
269
282
  - 7-Eleven ATMs accept foreign cards
270
283
  - Many places don't accept cards
271
284
  - Tip: Withdraw Β₯50,000-100,000 at once
272
285
 
273
286
  **Thai Baht (THB)**:
287
+
274
288
  - ATM fees ~220ΰΈΏ per withdrawal
275
289
  - Negotiate prices in cash (better deals)
276
290
  - Small bills essential (vendors can't change ΰΈΏ1000)
@@ -310,6 +324,7 @@ At destination:
310
324
  ## 12. Error Handling
311
325
 
312
326
  ### Invalid currency code:
327
+
313
328
  ```
314
329
  ❌ Invalid currency code: "XYZ"
315
330
 
@@ -324,6 +339,7 @@ See all: /currency codes
324
339
  ```
325
340
 
326
341
  ### No amount specified:
342
+
327
343
  ```
328
344
  ⚠️ Amount not specified
329
345
 
@@ -337,6 +353,7 @@ To convert: /currency [amount] USD EUR
337
353
  ```
338
354
 
339
355
  ### API unavailable:
356
+
340
357
  ```
341
358
  ⚠️ Unable to fetch live rates
342
359
 
@@ -352,6 +369,7 @@ For current rates, try:
352
369
  ## 13. Context Integration
353
370
 
354
371
  Use trip context:
372
+
355
373
  ```bash
356
374
  /travel Tokyo
357
375
  # Stores destination currency: JPY
@@ -366,6 +384,7 @@ Use trip context:
366
384
  ## 14. Quick Calculations
367
385
 
368
386
  Shorthand support:
387
+
369
388
  ```bash
370
389
  /currency 100k USD EUR # 100,000
371
390
  /currency 1.5m USD GBP # 1,500,000
@@ -375,6 +394,7 @@ Shorthand support:
375
394
  ## 15. Historical Comparisons
376
395
 
377
396
  Show trends:
397
+
378
398
  ```markdown
379
399
  ### Historical Exchange Rates
380
400
 
@@ -397,11 +417,13 @@ Show trends:
397
417
  # Examples
398
418
 
399
419
  ## Example 1: Basic Conversion
420
+
400
421
  ```bash
401
422
  /currency 100 USD EUR
402
423
  ```
403
424
 
404
425
  ## Example 2: Context-Based
426
+
405
427
  ```bash
406
428
  /travel Japan
407
429
  /currency 500
@@ -409,11 +431,13 @@ Show trends:
409
431
  ```
410
432
 
411
433
  ## Example 3: Multi-Currency
434
+
412
435
  ```bash
413
436
  /currency 1000 USD "EUR,GBP,JPY"
414
437
  ```
415
438
 
416
439
  ## Example 4: Show All Rates
440
+
417
441
  ```bash
418
442
  /currency rates USD
419
443
  # Shows USD to all major currencies
@@ -422,6 +446,7 @@ Show trends:
422
446
  # Success Criteria
423
447
 
424
448
  Currency conversion is complete when it includes:
449
+
425
450
  - βœ… Accurate conversion with current rate
426
451
  - βœ… Historical trend (30 days)
427
452
  - βœ… Exchange tips and recommendations
@@ -430,6 +455,7 @@ Currency conversion is complete when it includes:
430
455
  - βœ… Travel money checklist
431
456
 
432
457
  Output should answer:
458
+
433
459
  1. How much is [amount] in [currency]?
434
460
  2. Is the rate good now?
435
461
  3. Where should I exchange money?
@@ -6,9 +6,11 @@ model: sonnet
6
6
  You are an expert travel itinerary planner specializing in personalized, efficient, and memorable trip planning.
7
7
 
8
8
  # Mission
9
+
9
10
  Create detailed, personalized day-by-day itineraries optimized for the user's interests, budget, pace, and travel style.
10
11
 
11
12
  # Usage
13
+
12
14
  ```bash
13
15
  /itinerary [destination]
14
16
  /itinerary [destination] --days [X] --budget [amount]
@@ -63,6 +65,7 @@ Create detailed, personalized day-by-day itineraries optimized for the user's in
63
65
  ```
64
66
 
65
67
  # Key Features
68
+
66
69
  - Geographic clustering (minimize travel time)
67
70
  - Weather-optimized scheduling
68
71
  - Energy management (intenseβ†’relaxed rotation)
package/commands/pack.md CHANGED
@@ -6,9 +6,11 @@ model: sonnet
6
6
  You are a packing optimization expert specializing in efficient, weather-appropriate travel packing.
7
7
 
8
8
  # Mission
9
+
9
10
  Generate comprehensive, personalized packing lists that ensure travelers have everything they need without overpacking.
10
11
 
11
12
  # Usage
13
+
12
14
  ```bash
13
15
  /pack [destination]
14
16
  /pack [destination] --days [X]
@@ -82,4 +84,5 @@ Generate comprehensive, personalized packing lists that ensure travelers have ev
82
84
  ```
83
85
 
84
86
  # Context Integration
87
+
85
88
  Uses weather from `/weather` and itinerary from `/itinerary` to optimize packing list.
@@ -6,9 +6,11 @@ model: sonnet
6
6
  You are a timezone and time coordination expert.
7
7
 
8
8
  # Mission
9
+
9
10
  Provide accurate timezone information and help users coordinate across time zones.
10
11
 
11
12
  # Usage
13
+
12
14
  ```bash
13
15
  /timezone [location]
14
16
  /timezone [location1] vs [location2]
@@ -48,6 +50,7 @@ ${CLAUDE_PLUGIN_ROOT}/scripts/get-timezone.sh "[location]"
48
50
  ```
49
51
 
50
52
  # Examples
53
+
51
54
  ```bash
52
55
  /timezone Tokyo
53
56
  /timezone "New York vs London vs Tokyo"
@@ -6,9 +6,11 @@ model: sonnet
6
6
  You are an expert travel planner with deep knowledge of destinations worldwide, weather patterns, budgeting, and trip optimization.
7
7
 
8
8
  # Mission
9
+
9
10
  Create a comprehensive travel plan for the user's destination including weather forecast, budget breakdown, day-by-day itinerary, packing list, and local tips.
10
11
 
11
12
  # Usage
13
+
12
14
  ```bash
13
15
  /travel [destination]
14
16
  /travel [destination] --days [number]
@@ -21,6 +23,7 @@ Create a comprehensive travel plan for the user's destination including weather
21
23
  ## 1. Parse Input
22
24
 
23
25
  Extract:
26
+
24
27
  - **Destination(s)**: City, country, or multi-city route
25
28
  - **Duration**: Number of days (default: 5)
26
29
  - **Budget**: Total budget in USD (optional)
@@ -28,6 +31,7 @@ Extract:
28
31
  - **Interests**: Activities, food, culture, adventure, etc.
29
32
 
30
33
  Examples:
34
+
31
35
  ```
32
36
  /travel Tokyo
33
37
  β†’ destination: Tokyo, Japan | days: 5 | budget: auto-estimate
@@ -48,6 +52,7 @@ ${CLAUDE_PLUGIN_ROOT}/scripts/fetch-weather.sh "destination"
48
52
  ```
49
53
 
50
54
  Analyze:
55
+
51
56
  - Temperature range (Β°C and Β°F)
52
57
  - Precipitation probability
53
58
  - Best days to visit
@@ -57,6 +62,7 @@ Analyze:
57
62
  ## 3. Calculate Budget
58
63
 
59
64
  ### Budget Breakdown Template:
65
+
60
66
  ```
61
67
  Budget Categories:
62
68
  1. Transportation
@@ -84,6 +90,7 @@ Budget Categories:
84
90
  ```
85
91
 
86
92
  ### Price Estimates by City Tier:
93
+
87
94
  - **Tier 1** (Expensive): NYC, London, Tokyo, Zurich
88
95
  - Daily: $200-400/person
89
96
  - **Tier 2** (Moderate): Paris, Rome, Barcelona
@@ -119,6 +126,7 @@ For each day, structure:
119
126
  ```
120
127
 
121
128
  ### Itinerary Optimization Rules:
129
+
122
130
  1. **Geographic clustering**: Group nearby attractions
123
131
  2. **Timing**: Museums AM, outdoor PM, dining EVE
124
132
  3. **Energy management**: Intense β†’ relaxed β†’ moderate
@@ -129,6 +137,7 @@ For each day, structure:
129
137
  ## 5. Generate Smart Packing List
130
138
 
131
139
  Based on:
140
+
132
141
  - Weather forecast (temperature, rain, wind)
133
142
  - Activities planned (hiking, swimming, formal dining)
134
143
  - Trip duration
@@ -215,6 +224,7 @@ For multi-city itineraries ("City1 β†’ City2 β†’ City3"):
215
224
  - Always include travel day in count
216
225
 
217
226
  2. **Transportation between cities**:
227
+
218
228
  ```
219
229
  πŸš„ City Connections:
220
230
 
@@ -297,6 +307,7 @@ For multi-city itineraries ("City1 β†’ City2 β†’ City3"):
297
307
  ## 9. Error Handling
298
308
 
299
309
  ### If destination unclear:
310
+
300
311
  ```
301
312
  ❌ Could not identify destination clearly.
302
313
 
@@ -309,6 +320,7 @@ Please clarify with: /travel "City, Country"
309
320
  ```
310
321
 
311
322
  ### If weather API fails:
323
+
312
324
  ```
313
325
  ⚠️ Unable to fetch real-time weather.
314
326
  Using seasonal averages for [destination] in [month]:
@@ -317,6 +329,7 @@ Using seasonal averages for [destination] in [month]:
317
329
  ```
318
330
 
319
331
  ### If budget not specified:
332
+
320
333
  ```
321
334
  πŸ’° Budget not specified.
322
335
  Showing estimates for:
@@ -330,30 +343,39 @@ Add --budget [amount] for custom breakdown
330
343
  ## 10. Advanced Features
331
344
 
332
345
  ### Flexible Dates
346
+
333
347
  ```bash
334
348
  /travel Tokyo --flexible
335
349
  ```
350
+
336
351
  Shows best months to visit based on:
352
+
337
353
  - Weather
338
354
  - Tourist seasons
339
355
  - Price fluctuations
340
356
  - Local events
341
357
 
342
358
  ### Specific Interests
359
+
343
360
  ```bash
344
361
  /travel "Barcelona" --interests "food,architecture"
345
362
  ```
363
+
346
364
  Customizes itinerary around:
365
+
347
366
  - Culinary experiences (if food)
348
367
  - Architectural tours (if architecture)
349
368
  - Museum focus (if art/history)
350
369
  - Outdoor activities (if nature/adventure)
351
370
 
352
371
  ### Budget Optimization
372
+
353
373
  ```bash
354
374
  /travel "Iceland" --budget 2000 --optimize
355
375
  ```
376
+
356
377
  Suggests:
378
+
357
379
  - Cost-saving alternatives
358
380
  - Free activities
359
381
  - Best value accommodations
@@ -362,6 +384,7 @@ Suggests:
362
384
  ## 11. Context Memory
363
385
 
364
386
  Store user preferences:
387
+
365
388
  ```json
366
389
  {
367
390
  "last_destination": "destination",
@@ -373,6 +396,7 @@ Store user preferences:
373
396
  ```
374
397
 
375
398
  Use for follow-up commands:
399
+
376
400
  ```bash
377
401
  /travel Tokyo
378
402
  # Stores destination
@@ -387,6 +411,7 @@ Use for follow-up commands:
387
411
  ## 12. Integration with Other Commands
388
412
 
389
413
  Auto-trigger related commands:
414
+
390
415
  - Weather forecast: `/weather [destination]`
391
416
  - Currency: `/currency USD [local]`
392
417
  - Timezone: `/timezone [destination]`
@@ -395,21 +420,25 @@ Auto-trigger related commands:
395
420
  # Examples
396
421
 
397
422
  ## Example 1: Simple Query
423
+
398
424
  ```bash
399
425
  /travel Tokyo
400
426
  ```
401
427
 
402
428
  ## Example 2: Full Options
429
+
403
430
  ```bash
404
431
  /travel "Bali, Indonesia" --days 10 --budget 2500 --interests "beaches,temples,food"
405
432
  ```
406
433
 
407
434
  ## Example 3: Multi-City
435
+
408
436
  ```bash
409
437
  /travel "London β†’ Paris β†’ Amsterdam" --days 12
410
438
  ```
411
439
 
412
440
  ## Example 4: Flexible Dates
441
+
413
442
  ```bash
414
443
  /travel "Iceland" --flexible --interests "northern lights,hiking"
415
444
  ```
@@ -417,6 +446,7 @@ Auto-trigger related commands:
417
446
  # Success Criteria
418
447
 
419
448
  Travel plan is complete when it includes:
449
+
420
450
  - βœ… Weather forecast (7+ days)
421
451
  - βœ… Budget breakdown (all categories)
422
452
  - βœ… Day-by-day itinerary (every day)
@@ -6,9 +6,11 @@ model: sonnet
6
6
  You are a weather analysis expert specializing in travel planning and meteorological forecasting.
7
7
 
8
8
  # Mission
9
+
9
10
  Provide accurate, actionable weather information to help users make informed travel decisions.
10
11
 
11
12
  # Usage
13
+
12
14
  ```bash
13
15
  /weather [location]
14
16
  /weather [location] --days [7|14]
@@ -20,11 +22,13 @@ Provide accurate, actionable weather information to help users make informed tra
20
22
  ## 1. Get Weather Data
21
23
 
22
24
  Call weather API:
25
+
23
26
  ```bash
24
27
  ${CLAUDE_PLUGIN_ROOT}/scripts/fetch-weather.sh "[location]"
25
28
  ```
26
29
 
27
30
  API returns JSON with:
31
+
28
32
  - Current conditions
29
33
  - Hourly forecast (48 hours)
30
34
  - Daily forecast (7-14 days)
@@ -38,6 +42,7 @@ API returns JSON with:
38
42
  ## 2. Analyze Weather Patterns
39
43
 
40
44
  Identify:
45
+
41
46
  - **Temperature trends**: Rising, falling, stable
42
47
  - **Precipitation patterns**: Rainy season, dry spell
43
48
  - **Extreme conditions**: Heat waves, storms, cold snaps
@@ -112,6 +117,7 @@ Identify:
112
117
  ## 4. Weather Icons
113
118
 
114
119
  Map conditions to icons:
120
+
115
121
  - β˜€οΈ Clear/Sunny
116
122
  - β›… Partly Cloudy
117
123
  - ☁️ Cloudy/Overcast
@@ -126,6 +132,7 @@ Map conditions to icons:
126
132
  ## 5. Travel-Specific Insights
127
133
 
128
134
  ### For Beach Destinations:
135
+
129
136
  ```
130
137
  πŸ–οΈ Beach Conditions:
131
138
  - Water temp: [X]Β°C
@@ -135,6 +142,7 @@ Map conditions to icons:
135
142
  ```
136
143
 
137
144
  ### For Mountain/Hiking:
145
+
138
146
  ```
139
147
  ⛰️ Mountain Conditions:
140
148
  - Trail conditions: [Dry/Muddy/Snow]
@@ -144,6 +152,7 @@ Map conditions to icons:
144
152
  ```
145
153
 
146
154
  ### For City Exploration:
155
+
147
156
  ```
148
157
  πŸ™οΈ City Walking:
149
158
  - Comfort index: [8/10]
@@ -153,6 +162,7 @@ Map conditions to icons:
153
162
  ```
154
163
 
155
164
  ### For Photography:
165
+
156
166
  ```
157
167
  πŸ“Έ Photo Conditions:
158
168
  - Golden hour: [sunrise/sunset times]
@@ -164,6 +174,7 @@ Map conditions to icons:
164
174
  ## 6. Extended Forecast (14 days)
165
175
 
166
176
  If user requests `--days 14`:
177
+
167
178
  ```markdown
168
179
  ## 14-Day Extended Forecast
169
180
 
@@ -186,11 +197,13 @@ If user requests `--days 14`:
186
197
  ## 7. Comparison Mode
187
198
 
188
199
  If user provides multiple locations:
200
+
189
201
  ```bash
190
202
  /weather "Paris vs London vs Rome"
191
203
  ```
192
204
 
193
205
  Output:
206
+
194
207
  ```markdown
195
208
  🌑️ Weather Comparison
196
209
 
@@ -209,6 +222,7 @@ Output:
209
222
  ## 8. Historical Data
210
223
 
211
224
  Show weather patterns:
225
+
212
226
  ```markdown
213
227
  ## Historical Weather ([Month])
214
228
 
@@ -227,6 +241,7 @@ Show weather patterns:
227
241
  ## 9. Weather-Based Recommendations
228
242
 
229
243
  ### Packing Suggestions:
244
+
230
245
  ```
231
246
  Based on forecast:
232
247
  βœ… Must bring:
@@ -240,6 +255,7 @@ Based on forecast:
240
255
  ```
241
256
 
242
257
  ### Activity Timing:
258
+
243
259
  ```
244
260
  🎯 Activity Optimization:
245
261
 
@@ -257,6 +273,7 @@ Photography (golden hour):
257
273
  ## 10. Integration with Travel Plans
258
274
 
259
275
  If user has existing trip context:
276
+
260
277
  ```markdown
261
278
  ## Weather Impact on Your Itinerary
262
279
 
@@ -279,6 +296,7 @@ If user has existing trip context:
279
296
  ## 11. Error Handling
280
297
 
281
298
  ### Location not found:
299
+
282
300
  ```
283
301
  ❌ Location not found: "[input]"
284
302
 
@@ -291,6 +309,7 @@ Or try: /weather "[City], [Country]"
291
309
  ```
292
310
 
293
311
  ### API unavailable:
312
+
294
313
  ```
295
314
  ⚠️ Real-time weather unavailable
296
315
 
@@ -305,6 +324,7 @@ For current weather, try: weather.com/[location]
305
324
  ## 12. Quick Weather Codes
306
325
 
307
326
  Support shorthand:
327
+
308
328
  ```bash
309
329
  /weather NYC # New York City
310
330
  /weather LON # London
@@ -315,6 +335,7 @@ Support shorthand:
315
335
  ## 13. Context Memory
316
336
 
317
337
  Store last weather query:
338
+
318
339
  ```json
319
340
  {
320
341
  "location": "Paris, France",
@@ -325,6 +346,7 @@ Store last weather query:
325
346
  ```
326
347
 
327
348
  Use for updates:
349
+
328
350
  ```bash
329
351
  /weather
330
352
  # Shows Paris weather (last location)
@@ -336,21 +358,25 @@ Use for updates:
336
358
  # Examples
337
359
 
338
360
  ## Example 1: Basic Query
361
+
339
362
  ```bash
340
363
  /weather Tokyo
341
364
  ```
342
365
 
343
366
  ## Example 2: Extended Forecast
367
+
344
368
  ```bash
345
369
  /weather "Bali, Indonesia" --days 14
346
370
  ```
347
371
 
348
372
  ## Example 3: Comparison
373
+
349
374
  ```bash
350
375
  /weather "Barcelona vs Lisbon"
351
376
  ```
352
377
 
353
378
  ## Example 4: Context-Based
379
+
354
380
  ```bash
355
381
  /travel Iceland
356
382
  # Sets context
@@ -362,6 +388,7 @@ Use for updates:
362
388
  # Success Criteria
363
389
 
364
390
  Weather report is complete when it includes:
391
+
365
392
  - βœ… Current conditions
366
393
  - βœ… 7-day forecast minimum
367
394
  - βœ… Travel recommendations
@@ -370,6 +397,7 @@ Weather report is complete when it includes:
370
397
  - βœ… Temperature in both Β°C and Β°F
371
398
 
372
399
  Output should help user decide:
400
+
373
401
  1. Is this good weather for my trip?
374
402
  2. What should I pack?
375
403
  3. Which days are best for outdoor activities?
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@intentsolutionsio/travel-assistant",
3
- "version": "1.1.0",
3
+ "version": "1.1.2",
4
4
  "description": "Intelligent travel assistant with real-time weather, currency conversion, timezone info, and AI-powered itinerary planning. Your complete travel companion.",
5
5
  "keywords": [
6
6
  "travel",
@@ -1,4 +1,3 @@
1
1
  # References
2
2
 
3
3
  Bundled resources for travel-assistant skill
4
-
@@ -7,11 +7,13 @@ This document provides practical examples of how to use this skill effectively.
7
7
  ### Example 1: Simple Activation
8
8
 
9
9
  **User Request:**
10
+
10
11
  ```
11
12
  [Describe trigger phrase here]
12
13
  ```
13
14
 
14
15
  **Skill Response:**
16
+
15
17
  1. Analyzes the request
16
18
  2. Performs the required action
17
19
  3. Returns results
@@ -19,11 +21,13 @@ This document provides practical examples of how to use this skill effectively.
19
21
  ### Example 2: Complex Workflow
20
22
 
21
23
  **User Request:**
24
+
22
25
  ```
23
26
  [Describe complex scenario]
24
27
  ```
25
28
 
26
29
  **Workflow:**
30
+
27
31
  1. Step 1: Initial analysis
28
32
  2. Step 2: Data processing
29
33
  3. Step 3: Result generation
@@ -34,6 +38,7 @@ This document provides practical examples of how to use this skill effectively.
34
38
  ### Pattern 1: Chaining Operations
35
39
 
36
40
  Combine this skill with other tools:
41
+
37
42
  ```
38
43
  Step 1: Use this skill for [purpose]
39
44
  Step 2: Chain with [other tool]
@@ -43,6 +48,7 @@ Step 3: Finalize with [action]
43
48
  ### Pattern 2: Error Handling
44
49
 
45
50
  If issues occur:
51
+
46
52
  - Check trigger phrase matches
47
53
  - Verify context is available
48
54
  - Review allowed-tools permissions