User Interaction & Social Features

Overview

SkillHub provides a rich set of social features that allow team members to interact, share, and recommend skill packages.

Core Features:

• Star: Bookmark your favorite skill packages for easy access later
• Rating: Rate skill packages (1-5 stars) to help others assess quality
• Download Statistics: Track download counts to highlight popular skill packages
• Notification System: Receive timely notifications for review results, comment replies, and more

Social Metrics:

Metric	Description
Star Count	Number of users who have bookmarked the skill package
Average Rating	Mean score across all user ratings
Download Count	Total number of downloads
Activity	Last updated time, release frequency

Use Cases

Case 1: Bookmarking Frequently Used Skill Packages

A developer finds a useful skill package and clicks the star button to bookmark it.

Case 2: Rating and Recommending

After using a skill package, a developer gives it a rating and review to help other team members.

Case 3: Viewing Notifications

A developer receives a notification that their submission has been approved, or someone has commented on their skill package.

Case 4: Browsing Popular Skill Packages

View skill packages with the most stars and highest ratings to discover best practices.

Step-by-Step Guide

Starring a Skill Package:

1. Navigate to the skill package detail page
2. Click the "Star" button
3. The skill package will appear in your "My Stars" list
4. Click again to unstar

Rating a Skill Package:

1. Navigate to the skill package detail page
2. Click the star icons to select a rating (1-5 stars)
3. The rating takes effect immediately and impacts the skill package's average rating
4. You can update your rating at any time

Viewing Notifications:

1. Click the notification icon in the top navigation bar
2. View the list of unread notifications
3. Click a notification to navigate to the relevant page
4. Mark as read or mark all as read

Viewing My Stars:

1. Navigate to /dashboard/stars
2. View all starred skill packages
3. Sort by star date or last updated date
4. Quickly access frequently used skill packages

API Reference

Star a Skill Package:

PUT /api/v1/skills/{skillId}/star

Unstar a Skill Package:

DELETE /api/v1/skills/{skillId}/star

Check Star Status:

GET /api/v1/skills/{skillId}/star

Response Example:

{
  "starred": true,
  "starredAt": "2026-03-15T10:30:00Z"
}

Rate a Skill Package:

PUT /api/v1/skills/{skillId}/rating
Content-Type: application/json

{
  "score": 5
}

Parameter Reference:

Parameter	Type	Description
skillId	string	Skill package ID (path parameter)
score	number	Rating (1-5, required)

Get My Stars:

GET /api/v1/me/stars?page=0&size=20

Get My Rating:

GET /api/v1/skills/{skillId}/rating

Response Example:

{
  "score": 5,
  "ratedAt": "2026-03-15T10:30:00Z"
}

Notes

Rating Rules: Each user can rate each skill package only once. Ratings can be updated but not deleted.

• Star Count: A skill package's star count is displayed in search results and on the detail page
• Average Rating: A skill package's average rating affects search ranking
• Notification Settings: Users can disable certain notification types in their settings
• Download Statistics: Each download increments the download counter, which is used for popularity ranking