Gift Suggestions Skill
Suggest personalized gift ideas based on recipient profiles, interests, and budget.
Usage
import { GiftSuggestionsSkill } from '@openclaw/gift-suggestions';
const skill = new GiftSuggestionsSkill();
// Add a recipient profile
const recipientId = await skill.addRecipient({
name: 'Sarah',
relationship: 'sister',
age: 28,
interests: ['reading', 'yoga', 'tea', 'wellness'],
notes: 'Prefers experiences over physical gifts'
});
// Get personalized suggestions
const suggestions = await skill.suggestGifts({
recipientId,
budgetMax: 100,
occasion: 'birthday',
excludePrevious: true,
count: 5
});
// View suggestions with match scores
suggestions.forEach(result => {
console.log(`${result.suggestion.name} - Match: ${result.matchScore}`);
console.log(`Reasons: ${result.matchReasons.join(', ')}`);
});
CLI Usage
# Add a recipient
gift-suggestions add-recipient "Sarah" "sister" \
--interests "reading,yoga,tea" \
--age 28 \
--notes "Prefers experiences"
# List all recipients
gift-suggestions list-recipients
# Get gift suggestions
gift-suggestions suggest 1 --budget 100 --occasion birthday --count 5
# Browse trending gifts
gift-suggestions trending --limit 10
# View gifts by category
gift-suggestions categories
# View gifts under budget
gift-suggestions budget 50
# Track gift history
gift-suggestions add-history 1 "Yoga Mat" "birthday" "2024-03-15" --price 45
Features
Recipient Profiles
- Store recipient information (name, relationship, age, gender)
- Track interests for better matching
- Add personal notes
- Gift history tracking with reactions
Smart Suggestions
- Interest-based matching algorithm
- Budget filtering (min/max)
- Occasion-appropriate suggestions
- Age and gender considerations
- Exclude previously gifted items
- Match scoring with detailed reasons
Gift Database
- 64 curated gift ideas across 8 categories
- Price ranges for all budgets
- Trending indicators
- Interest tags
- Occasion appropriateness
Categories
- Tech: Gadgets, electronics, smart devices
- Experiences: Activities, classes, adventures
- Home: Decor, appliances, comfort items
- Fashion: Accessories, apparel, jewelry
- Books & Learning: Books, courses, educational
- Wellness: Fitness, health, self-care
- Food & Drink: Gourmet items, subscriptions
Gift History
- Track all gifts given
- Record recipient reactions
- Monitor spending
- Avoid duplicate gifts
1---2name: gift-suggestions3description: Gift Suggestions Skill4---5# Gift Suggestions Skill67Suggest personalized gift ideas based on recipient profiles, interests, and budget.89## Usage1011```typescript12import { GiftSuggestionsSkill } from '@openclaw/gift-suggestions';1314const skill = new GiftSuggestionsSkill();1516// Add a recipient profile17const recipientId = await skill.addRecipient({18 name: 'Sarah',19 relationship: 'sister',20 age: 28,21 interests: ['reading', 'yoga', 'tea', 'wellness'],22 notes: 'Prefers experiences over physical gifts'23});2425// Get personalized suggestions26const suggestions = await skill.suggestGifts({27 recipientId,28 budgetMax: 100,29 occasion: 'birthday',30 excludePrevious: true,31 count: 532});3334// View suggestions with match scores35suggestions.forEach(result => {36 console.log(`${result.suggestion.name} - Match: ${result.matchScore}`);37 console.log(`Reasons: ${result.matchReasons.join(', ')}`);38});39```4041## CLI Usage4243```bash44# Add a recipient45gift-suggestions add-recipient "Sarah" "sister" \46 --interests "reading,yoga,tea" \47 --age 28 \48 --notes "Prefers experiences"4950# List all recipients51gift-suggestions list-recipients5253# Get gift suggestions54gift-suggestions suggest 1 --budget 100 --occasion birthday --count 55556# Browse trending gifts57gift-suggestions trending --limit 105859# View gifts by category60gift-suggestions categories6162# View gifts under budget63gift-suggestions budget 506465# Track gift history66gift-suggestions add-history 1 "Yoga Mat" "birthday" "2024-03-15" --price 4567```6869## Features7071### Recipient Profiles72- Store recipient information (name, relationship, age, gender)73- Track interests for better matching74- Add personal notes75- Gift history tracking with reactions7677### Smart Suggestions78- Interest-based matching algorithm79- Budget filtering (min/max)80- Occasion-appropriate suggestions81- Age and gender considerations82- Exclude previously gifted items83- Match scoring with detailed reasons8485### Gift Database86- 64 curated gift ideas across 8 categories87- Price ranges for all budgets88- Trending indicators89- Interest tags90- Occasion appropriateness9192### Categories93- **Tech**: Gadgets, electronics, smart devices94- **Experiences**: Activities, classes, adventures95- **Home**: Decor, appliances, comfort items96- **Fashion**: Accessories, apparel, jewelry97- **Books & Learning**: Books, courses, educational98- **Wellness**: Fitness, health, self-care99- **Food & Drink**: Gourmet items, subscriptions100101### Gift History102- Track all gifts given103- Record recipient reactions104- Monitor spending105- Avoid duplicate gifts
ticruz38