@gonzih/skill-radar 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maksim Soltan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# Skill Radar — Personalized Skill Gap Analysis
+
+> 86% of professionals are falling behind on critical skills — LinkedIn 2026 Learning Report
+
+Skill Radar is an MCP (Model Context Protocol) server that analyzes your professional role, current skills, and 2025-2026 industry trends to identify specific skill gaps and generate a personalized 90-day learning plan. All resources are free.
+
+## What it does
+
+- **Skill gap analysis** across 9 role categories (Software Engineering, Product, Marketing, Finance, Healthcare, Data Science, Design, Leadership, Law)
+- **90-day learning plans** with weekly themes, curated free resources, practice exercises, and daily 5-15 minute micro-actions
+- **Market comparison** with alignment scores and estimated salary impact
+- **Weekly check-ins** to track progress over the 12-week plan
+- **Trend data** covering trending, emerging, and decaying skills for 2025-2026
+
+## Installation
+
+```bash
+npm install -g @gonzih/skill-radar
+```
+
+## MCP Configuration (Claude Desktop)
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "skill-radar": {
+      "command": "skill-radar"
+    }
+  }
+}
+```
+
+On macOS the config file is at:
+`~/Library/Application Support/Claude/claude_desktop_config.json`
+
+## How to use
+
+### 1. Analyze your skill gaps
+
+Ask Claude:
+
+> "Analyze my skill gaps. I'm a software engineer with 4 years experience. My current skills are: Python, Django, PostgreSQL, Git, basic AWS. My goal is to get promoted to senior."
+
+Claude will call `analyze_skills` and return a prioritized gap list with ROI scores.
+
+### 2. Build your 90-day plan
+
+> "Build a learning plan based on my top 5 skill gaps, I have 7 hours per week."
+
+Claude will call `build_plan` and return a 12-week plan broken into:
+- **Month 1 — Foundation:** One new concept per week
+- **Month 2 — Application:** Build real projects
+- **Month 3 — Visibility:** Portfolio, networking, credentialing
+
+### 3. Weekly check-ins
+
+> "Log my week 3 check-in. I completed: read TypeScript handbook chapter 1-3, built a typed Express API, watched Kubernetes intro video."
+
+### 4. Career pivots
+
+For role transitions (e.g., software engineer → data scientist):
+
+> "I'm a software engineer wanting to switch to data science. Analyze my gaps and build a 90-day transition plan."
+
+Skill Radar will detect the gap between your current role's skills and the target role's trending skills, then build a bridge plan.
+
+### 5. Combine with daily micro-learning
+
+Each week in your plan includes 7 daily actions (5-45 min each). Use them as:
+- Morning warm-up before work
+- Lunch-break learning
+- Evening wind-down practice
+
+## Tool Reference
+
+| Tool | Description |
+|------|-------------|
+| `analyze_skills` | Gap analysis with ROI scoring |
+| `build_plan` | 12-week personalized learning plan |
+| `get_trending_skills` | Trending/emerging/decaying skills by role |
+| `weekly_checkin` | Track progress + get encouragement |
+| `get_resources` | Curated free learning resources |
+| `compare_to_market` | Alignment score + salary impact estimate |
+
+## Supported Role Categories
+
+- Software Engineering
+- Product Management
+- Marketing
+- Finance/Accounting
+- Healthcare
+- Data Science/Analytics
+- Design
+- Leadership/Management
+- Law
+
+## Data
+
+Trend data is sourced from analysis of job postings, LinkedIn Learning reports, Stack Overflow surveys, and industry reports for 2025-2026. All learning resources are free (freeCodeCamp, Kaggle, Hugging Face, official docs, YouTube, MIT OCW, etc.).
+
+## License
+
+MIT — Copyright Maksim Soltan

package/SKILL.md

@@ -0,0 +1,97 @@
+# Skill Radar — MCP Capability Card
+
+## What skill-radar is
+
+`skill-radar` is an MCP server that provides personalized skill gap analysis and 90-day learning plans for professionals. It combines 2025-2026 market trend data across 9 role categories with curated free learning resources to help professionals identify what to learn next and how.
+
+Data is persisted locally in SQLite (`~/.skill-radar/data.db`) so profiles and check-ins are remembered across sessions.
+
+## MCP Tools
+
+### `analyze_skills`
+Analyzes skill gaps for a professional profile.
+
+**Input:**
+- `profileId` (string) — unique identifier for this person
+- `role` (string) — job title or role (e.g. "software engineer", "product manager")
+- `currentSkills` (string[]) — list of current skills
+- `yearsExperience` (number) — years in the role
+- `target` (string) — "stay current" | "get promoted" | "switch roles to X"
+
+**Output:** Gap score (0-100), prioritized skill gaps with ROI, strengths, at-risk skills, full gap table.
+
+---
+
+### `build_plan`
+Generates a 90-day (12-week) personalized learning plan.
+
+**Input:**
+- `profileId` (string)
+- `focusSkills` (string[]) — ordered list of skills to focus on
+- `hoursPerWeek` (number) — available hours per week
+
+**Output:** 12-week plan with monthly themes, weekly concepts, curated resources, practice exercises, stretch goals, and daily micro-actions.
+
+---
+
+### `get_trending_skills`
+Returns trending, emerging, and decaying skills for a role.
+
+**Input:**
+- `role` (string) — role or category
+
+**Output:** Three lists: trending (learn now), emerging (get ahead), decaying (sunset).
+
+---
+
+### `weekly_checkin`
+Records a weekly learning check-in and returns progress summary + encouragement.
+
+**Input:**
+- `profileId` (string)
+- `weekNumber` (number, 1-12)
+- `completedItems` (string[]) — activities completed
+- `notes` (string, optional)
+
+**Output:** Saved confirmation, progress summary, encouragement, and next-step guidance.
+
+---
+
+### `get_resources`
+Returns curated free learning resources for a specific skill.
+
+**Input:**
+- `skill` (string)
+- `level` (optional: "beginner" | "intermediate" | "advanced")
+- `maxHours` (optional: number)
+
+**Output:** List of resources with title, URL, type, estimated hours, level, and free status.
+
+---
+
+### `compare_to_market`
+Compares a professional's skills to current market demands.
+
+**Input:**
+- `profileId` (string)
+- `role` (string)
+- `currentSkills` (string[])
+- `yearsExperience` (number)
+
+**Output:** Alignment score (%), unique strengths, critical gaps, estimated salary impact.
+
+## Role Categories
+
+Software Engineering, Product Management, Marketing, Finance/Accounting, Healthcare, Data Science/Analytics, Design, Leadership/Management, Law
+
+## Example Use Cases
+
+1. **Pre-promotion prep:** "I want to get promoted to staff engineer — what skills am I missing?"
+2. **Career pivot:** "I'm a marketer moving into product management — what should I learn first?"
+3. **Annual review:** "It's Q1 — what are the most important skills to develop this year for my role?"
+4. **Salary negotiation research:** "How well do my skills align with market demand for a senior data scientist?"
+5. **Team learning:** "What are the top trending skills my engineering team should focus on?"
+
+## Storage
+
+All data is stored locally at `~/.skill-radar/data.db` (SQLite). No data is sent to external services.

package/dist/data/resources.d.ts

@@ -0,0 +1,12 @@
+export interface LearningResource {
+    skill: string;
+    title: string;
+    type: 'video' | 'article' | 'course' | 'book' | 'project';
+    url: string;
+    estimatedHours: number;
+    level: 'beginner' | 'intermediate' | 'advanced';
+    free: boolean;
+}
+export declare const LEARNING_RESOURCES: LearningResource[];
+export declare function getResourcesForSkill(skill: string, level?: string, maxHours?: number): LearningResource[];
+//# sourceMappingURL=resources.d.ts.map

package/dist/data/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/data/resources.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;IAChD,IAAI,EAAE,OAAO,CAAC;CACf;AAED,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EA6qBhD,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,gBAAgB,EAAE,CAyBpB"}