user-profile-reader
Read user profile from workspace and calculate content relevance.Use to personalize output based on user interests.
When & Why to Use This Skill
The User Profile Reader skill empowers Claude agents to provide deeply personalized interactions by interpreting local user data. It extracts interests, expertise levels, and stylistic preferences from a workspace profile to calculate precise content relevance scores, ensuring every response is tailored to the user's specific needs and professional context.
Use Cases
- Dynamic Content Personalization: Automatically adjust the complexity and focus of AI-generated reports based on the user's predefined interest levels and expertise.
- Tailored Communication Style: Ensure all agent outputs consistently match the user's preferred tone (e.g., instructional or professional) and narrative voice.
- Intelligent Information Filtering: Use relevance scoring to prioritize specific topics or data points during large-scale document analysis or research tasks.
- Contextual Task Prioritization: Help agents decide which information is most critical to present first by comparing content tags against the user's profile topics.
| name | user-profile-reader |
|---|---|
| description | | |
| tools | Read |
User Profile Reader Skill
Read and interpret user preferences for content personalization.
What This Skill Does
- Reads
user-profile.jsonfrom workspace root - Provides user context to other processing
- Calculates relevance scores for content
User Profile Location
~/.looplia/user-profile.json
User Profile Schema
{
"userId": "string",
"topics": [
{ "topic": "string", "interestLevel": 1-5 }
],
"style": {
"tone": "beginner" | "intermediate" | "expert" | "mixed",
"targetWordCount": 100-10000,
"voice": "first-person" | "third-person" | "instructional"
}
}
Relevance Scoring Algorithm
Calculate score.relevanceToUser (0-1):
1. For each user topic:
- weight = interestLevel / 5
- matched = content tags/themes contain topic (case-insensitive)
2. Calculate score:
- matchedWeight = sum of weights for matched topics
- totalWeight = sum of all topic weights
- score = matchedWeight / totalWeight
3. If no user topics defined:
- score = 0.5 (neutral)
Example Calculation
User profile:
{
"topics": [
{ "topic": "AI", "interestLevel": 5 },
{ "topic": "productivity", "interestLevel": 3 },
{ "topic": "cooking", "interestLevel": 2 }
]
}
Content tags: ["AI", "safety", "alignment"]
Calculation:
- AI: matched, weight = 5/5 = 1.0 (contributes to matchedWeight)
- productivity: not matched, weight = 3/5 = 0.6 (contributes to totalWeight only)
- cooking: not matched, weight = 2/5 = 0.4 (contributes to totalWeight only)
- matchedWeight = 1.0
- totalWeight = 1.0 + 0.6 + 0.4 = 2.0
- score = 1.0 / 2.0 = 0.5
Usage in Other Skills
When content-documenter needs relevance score:
- Read user-profile.json
- Compare content tags/themes to user topics
- Apply algorithm above
- Return score in
score.relevanceToUserfield
Handling Edge Cases
- No user profile file: Use score = 0.5
- Empty topics array: Use score = 0.5
- Invalid JSON: Use score = 0.5, log warning
- All topics matched: score = 1.0
- No topics matched: score = 0.0