SkillBubble — Skills Management MCP Server

SkillBubble Integrations

Connect SkillBubble to your AI assistant or development workflow so your skill profile stays current as you build.

There are two ways to do this — pick the one that fits your situation.

---

Option 1 — AI assistant (recommended)

Connect your personal AI assistant (Kiro, Claude, Copilot) to your SkillBubble profile via the MCP server. Your assistant can then read your profile, suggest skill updates based on what you're building, and keep your profile current as you work — all driven by you, in conversation.

This is the primary integration. It's personal, intentional, and you stay in control.

→ Set up your AI assistant

---

Option 2 — GitHub Sync

Connect your GitHub account in Settings and SkillBubble will automatically analyse your personal contribution history — commits, languages, repo activity — and generate skill suggestions in your inbox.

This is the recommended approach for automatic profile updates. It's cleaner than a CI/CD pipeline because SkillBubble pulls your data directly, scoped to you, with no keys in shared repos.

→ Learn about GitHub Sync

---

⚠️ Pipeline integrations — read this first

The GitHub Actions workflows in this repo let you trigger skill suggestions on push or PR. They are designed for personal, single-developer repositories only.

Do not add a SkillBubble API key to a shared team repository. If you do:

• Every push by every team member will trigger suggestions against your profile
• Your colleagues' work will appear as your skill activity
• You'll get flooded with irrelevant suggestions

If you want automatic updates from your work in a shared repo, use GitHub Sync (Option 2) instead — it reads only your personal contributions, not the whole team's.

If you have a legitimate single-user repo use case, the pipeline workflows are documented below.

---

AI assistant setup

Prerequisites

• A SkillBubble account — sign up free
• A Pro subscription for write and AI tools
• An API key — generate one in Settings → Integrations

1. Get an API key

Sign in → Settings → Integrations → Create API key.

2. Add to your client

Pick the config for your AI assistant from mcp-config/:

File	Client
kiro.json	Kiro IDE (~/.kiro/settings/mcp.json)
claude.json	Claude Desktop / Claude Code
copilot.json	GitHub Copilot (VS Code — .vscode/mcp.json)

Replace sk-sb-your-api-key-here with your key from Settings.

3. Try it

Ask your AI assistant:

"Show me my SkillBubble profile — what are my top-rated skills?"

---

What to ask your AI assistant

Once connected, your AI assistant has full access to your skill profile. Here are some prompts to get started:

Profile review

Show me my SkillBubble profile. What are my strongest skills?

Summarise my top skills for a CV profile summary. Keep it to 3 sentences.

What skills am I missing compared to a senior TypeScript engineer?

Keeping your profile current

I just finished building a React dashboard with Recharts and React Query.
Use suggestSkills with that context and update my profile.

Read my package.json and suggest skills for the libraries I'm actively using.
Then call createSkillRating for each relevant one.

Run: git diff main --stat
Then: git diff main -- '*.ts' '*.tsx' | head -300
What did I build in this branch? Suggest and apply skill updates.

Gap analysis

Call getSkillProfile, then run git log --oneline -20.
Compare what I've been building against my profile and suggest updates for anything I'm missing.

Career planning

How ready am I for a Senior Cloud Architect role? Use roleGapAnalysis.

Generate a 30/60/90-day learning plan to close my gaps against my AWS package.

What are the top 3 skills I should focus on to become a Staff Engineer?
Use prioritySkillRecommendations with that career goal.

---

Available tools

Tool	Tier	Description
getSkillProfile	Free	Read skills with optional filtering by category, rating, or date
getCertifications	Free	List certifications, filter by issuer or active/expired status
getFrameworks	Free	View competency frameworks and progress
getSkillHistory	Free	See rating changes over time
searchSkills	Free	Search by name or category
getSubscribedPackages	Free	List all subscribed skill packages with categories and skills
gapAnalysis	Free	Compare your skills against a package to find gaps and strengths
strengthsWeaknesses	Free	Show your top 3 strongest and weakest skill categories
frameworkGapAnalysis	Free	Compare your evidence against a competency framework
createSkillRating	Pro	Add or update a skill rating
updateSkillRating	Pro	Update an existing rating by skill key
createCertification	Pro	Add a certification record
createSkillPackage	Pro	Create a custom skill package
manageSuggestions	Pro	List, accept, or reject pending skill suggestions
suggestSkills	Pro	AI-powered skill suggestions from a context string — non-destructive
suggestSkillPackage	Pro	Suggest a skill package from a goal — non-destructive
roleGapAnalysis	Pro	Analyse your readiness for a target role using AI
generateLearningPlan	Pro	Generate a 30/60/90-day learning plan based on your skill gaps
prioritySkillRecommendations	Pro	Get the top 3 skills to improve next for your career goal

AI-powered tools (suggestSkills, suggestSkillPackage, roleGapAnalysis, generateLearningPlan, prioritySkillRecommendations) return recommendations only — they never modify your profile automatically.

---

GitHub Sync

GitHub Sync connects your GitHub account to SkillBubble via OAuth. Once connected, SkillBubble periodically analyses your personal contribution history — languages, commit activity, repo topics — and generates skill suggestions in your inbox.

Why this is better than a pipeline:

• Scoped to your contributions only, not the whole team's
• No API key in a shared repo
• Runs automatically, no workflow files to maintain
• Suggestions land in your inbox for review, same as MCP suggestions

You'll find it in Settings → Integrations.

On a team? GitHub Sync is for personal profile updates based on your own contributions. If you want team-wide skill analysis — gap reports, sprint planning suggestions, assignment recommendations — that's coming in Team AI Automation (business subscriptions). Learn more.

---

GitHub Actions (single-user repos only)

⚠️ Personal use only. See the pipeline warning above before using these.

Looking for team-wide automation? Pipeline workflows are the wrong tool for that. Check out Team AI Automation — it's built for exactly that use case, without the credential risks.

Ready-to-use workflows in github-actions/:

Workflow	Trigger
on-merge.yml	Push to main
on-pr.yml	Pull request open/update
dependency-scan.yml	Manual or dependency file change

Setup: Add these secrets to your repo (Settings → Secrets → Actions):

Secret	Value
SKILLBUBBLE_API_KEY	Your personal API key from SkillBubble Settings
SKILLBUBBLE_MCP_ENDPOINT	https://mcp.skillbubble.com/mcp

Or use the Action directly:

- uses: Skill-Bubble/skillbubble-integrations@v1
  with:
    api_key: ${{ secrets.SKILLBUBBLE_API_KEY }}
    mcp_endpoint: ${{ secrets.SKILLBUBBLE_MCP_ENDPOINT }}

---

Team AI Automation (coming soon — business subscriptions)

Team AI Automation brings skill intelligence directly into SkillBubble for your whole team — no MCP configuration required by individual members.

A company admin activates a shared Automation Account for the organisation. Team members opt in to share their skill data, and SkillBubble runs AI-driven analysis on a schedule and in response to key events:

• Sprint planning — "Your team has a gap in Terraform. 3 members recently upskilled — good time to tackle that infrastructure backlog."
• Feature planning — Describe a new feature and get assignment recommendations based on who has the strongest relevant skills.
• Weekly gap reports — Aggregated skill gap and upskill opportunity reports for team owners, with no individual ratings exposed.
• New member onboarding — Analysis runs automatically when someone joins the team.

Suggestions land in each member's existing Suggestions Inbox, labelled "Team AI", using the same accept/reject flow they already know.

This is the right answer for teams — not pipeline workflows with shared API keys. Available as part of the business subscription tier.

---

Data and security

• All traffic is encrypted via HTTPS / TLS 1.2+
• API keys are scoped — read-only keys cannot call write tools
• Write tools respect your MCP Trust Level in Settings: in ask mode (default), write calls create pending suggestions for review rather than applying changes directly
• Revoke any key at any time in Settings → Integrations

Prompt injection risk: LLMs can be manipulated by malicious content in files or commits. Keep the default ask trust level so all write calls require your review before being applied.

See SECURITY.md for full details.

---

Support

• Email: [email protected]
• Settings: www.skillbubble.com/settings/integrations

---

Contributing

This repository is maintained by the SkillBubble team. External contributions are not accepted at this time.

---

Disclaimer

MCP clients can read and write to your SkillBubble profile with your API key's permissions. Keep the default ask trust level, review suggestions before accepting, and revoke keys you no longer use.