level-up-mcp-server-cn 0.4.0

package/docs/skills-and-abilities-review.md

@@ -0,0 +1,672 @@
+# Level-Up: Skills & MCP Abilities — Team Review
+
+> **Version:** 0.3.3 | **Date:** 2026-03-18
+> **Purpose:** External review of the ability taxonomy, skill catalog, and MCP tool list.
+
+---
+
+## Overview
+
+Level-Up tracks agent and human progression across **18 ability categories**, each containing **skills** (knowledge/proficiency) and mapped to recommended **MCPs** (external tools agents can install). The system has **106 skills** across those categories, and **69 built-in Level-Up tools** that agents call to track their work.
+
+---
+
+## Part 1: Ability Categories & Skill Catalog
+
+Each section lists:
+- **MCPs** — external tools agents install to perform work in this domain
+- **Skills** — knowledge/prompts agents learn to work effectively
+- **Trust tiers:** Official · Reference · Verified Community · Community
+
+---
+
+### 1. Software Engineering
+
+**Core:** Code writing, debugging, refactoring, architecture design
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Filesystem MCP | Read/write/edit project files | Reference |
+| Git MCP | Branch, commit, diff, merge | Reference |
+| GitHub MCP | PRs, issues, code review, CI | Official (28K★) |
+| Sequential Thinking | Multi-step reasoning for architecture | Reference |
+| Desktop Commander | Terminal commands, process management | Verified Community (5.7K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| refactor | Safe refactoring patterns, extract methods | GitHub |
+| refactor-plan | Plan multi-step refactoring before executing | GitHub |
+| review-and-refactor | Code review + improvement in one pass | GitHub |
+| conventional-commit | Structured commit messages (feat/fix/chore) | GitHub |
+| git-commit | Smart commit message generation from diffs | GitHub |
+| architecture-blueprint-generator | Generate architecture docs from codebase | GitHub |
+| create-implementation-plan | Break features into actionable steps | GitHub |
+| mcp-builder | Build MCP servers from scratch | Anthropic |
+| skill-creator | Create new SKILL.md files | Anthropic |
+
+**Progression:** Filesystem + Git → GitHub → Sequential Thinking → Desktop Commander
+
+---
+
+### 2. Web Development
+
+**Core:** Frontend/backend, HTML/CSS/JS, frameworks, APIs
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Filesystem MCP | Project file management | Reference |
+| Playwright MCP | Browser automation, E2E testing | Official (29K★) |
+| Fetch MCP | HTTP requests, API testing | Reference |
+| Brave Search MCP | Search docs, APIs, debug errors | Official (775★) |
+| Firecrawl MCP | Deep site crawling, scraping | Official (5.8K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| frontend-design | Frontend UI design patterns | Anthropic |
+| web-artifacts-builder | Build interactive web components | Anthropic |
+| webapp-testing | Web application testing strategies | Anthropic |
+| web-coder | Full-stack web development patterns | GitHub |
+| web-design-reviewer | Review and critique web designs | GitHub |
+| playwright-generate-test | Generate Playwright E2E tests | GitHub |
+| playwright-explore-website | Navigate and analyze websites programmatically | GitHub |
+| openapi-to-application-code | Generate app code from OpenAPI specs | GitHub |
+
+**Progression:** Filesystem + Fetch → Playwright → Brave Search → Firecrawl
+
+---
+
+### 3. Data Analysis
+
+**Core:** SQL, data wrangling, statistics, visualization
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Filesystem MCP | Read/write CSV, JSON, data files | Reference |
+| Memory MCP | Track analysis context across sessions | Reference |
+| Brave Search MCP | Research datasets, methodologies | Official (775★) |
+| Chroma MCP | Vector database for embeddings | Official (515★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| xlsx | Excel spreadsheet creation, formulas, charts | Anthropic |
+| datanalysis-credit-risk | Credit risk data analysis patterns | GitHub |
+| bigquery-pipeline-audit | Audit and optimize data pipelines | GitHub |
+| sql-optimization | SQL query performance tuning | GitHub |
+| sql-code-review | Review SQL for correctness and performance | GitHub |
+| powerbi-modeling | Power BI data modeling best practices | GitHub |
+
+**Progression:** Filesystem → Memory → Brave Search → Chroma
+
+---
+
+### 4. DevOps & Infrastructure
+
+**Core:** CI/CD, deployment, monitoring, IaC
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| GitHub MCP | CI/CD via GitHub Actions | Official (28K★) |
+| Terraform MCP | Infrastructure as code | Official (1.3K★) |
+| AWS MCP Servers | Lambda, S3, cloud services | Official (8.5K★) |
+| Cloudflare MCP | Workers, edge, CDN, DNS | Official (3.5K★) |
+| Grafana MCP | Observability dashboards, alerts | Official (2.5K★) |
+| Docker MCP Gateway | Container management | Official (1.3K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| devops-rollout-plan | Plan safe production rollouts | GitHub |
+| multi-stage-dockerfile | Optimize Docker images with multi-stage builds | GitHub |
+| create-github-action-workflow-specification | Design GitHub Actions workflows | GitHub |
+| import-infrastructure-as-code | Import existing infra into IaC | GitHub |
+| azure-deployment-preflight | Pre-deployment validation checks | GitHub |
+| az-cost-optimize | Cloud cost optimization strategies | GitHub |
+| cloud-design-patterns | Cloud architecture patterns (retry, circuit breaker) | GitHub |
+
+**Progression:** GitHub → AWS/Cloudflare → Terraform → Grafana → Docker
+
+---
+
+### 5. Security & Testing
+
+**Core:** Vulnerability scanning, code review, QA
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Snyk Agent Scan | Security scanner for AI agents & MCPs | Official (1.9K★) |
+| Playwright MCP | E2E security testing | Official (29K★) |
+| GitHub MCP | PR security review | Official (28K★) |
+| Filesystem MCP | Audit config files, secrets scanning | Reference |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| ai-prompt-engineering-safety-review | Review prompts for injection and safety risks | GitHub |
+| agent-governance | Governance policies for AI agents | GitHub |
+| webapp-testing | Web application testing strategies | Anthropic |
+| polyglot-test-agent | Testing across multiple languages/frameworks | GitHub |
+| doublecheck | Verify work by reviewing own output | GitHub |
+| scoutqa-test | QA testing patterns and strategies | GitHub |
+
+**Progression:** Filesystem → Snyk Agent Scan → GitHub PR review → Playwright E2E
+
+---
+
+### 6. Design & Visual
+
+**Core:** UI/UX, diagrams, visual assets
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Playwright MCP | Visual testing, screenshot comparison | Official (29K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| canvas-design | Visual design using canvas | Anthropic |
+| brand-guidelines | Create and follow brand identity standards | Anthropic |
+| theme-factory | Generate consistent UI themes | Anthropic |
+| algorithmic-art | Generate art through algorithms | Anthropic |
+| excalidraw-diagram-generator | Generate Excalidraw architecture diagrams | GitHub |
+| penpot-uiux-design | UI/UX design using Penpot (open-source Figma alt) | GitHub |
+
+**Progression:** Playwright (visual testing) → Excalidraw skill → Canvas design skill
+
+---
+
+### 7. Research & Knowledge
+
+**Core:** Literature review, fact-checking, source evaluation, synthesis
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Brave Search MCP | Web search with privacy | Official (775★) |
+| Fetch MCP | Read web pages, extract content | Reference |
+| Memory MCP | Persistent knowledge graph | Reference |
+| arXiv MCP | Academic paper search & retrieval | Verified Community (2.4K★) |
+| Firecrawl MCP | Deep web crawling, site analysis | Official (5.8K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| remember | Persistent memory patterns for agents | GitHub |
+| context-map | Map context relationships in complex domains | GitHub |
+| create-technical-spike | Time-boxed research investigations | GitHub |
+| first-ask | Ask clarifying questions before acting | GitHub |
+| what-context-needed | Determine what context is needed for a task | GitHub |
+
+**Progression:** Brave Search + Fetch → Memory → arXiv → Firecrawl
+
+---
+
+### 8. Writing & Content
+
+**Core:** Technical writing, copywriting, documentation, editing
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Filesystem MCP | Read/write documents | Reference |
+| Notion MCP | Knowledge base, docs, wikis | Official (4K★) |
+| ElevenLabs MCP | Text-to-speech for content | Official (1.3K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| doc-coauthoring | Collaborative document writing | Anthropic |
+| docx | Word document creation with formatting | Anthropic |
+| pdf | PDF document handling and extraction | Anthropic |
+| pptx | PowerPoint presentation creation | Anthropic |
+| documentation-writer | Technical documentation best practices | GitHub |
+| create-readme | Generate comprehensive READMEs | GitHub |
+| create-specification | Write technical specifications | GitHub |
+| convert-plaintext-to-md | Convert unstructured text to markdown | GitHub |
+| comment-code-generate-a-tutorial | Turn code into step-by-step tutorials | GitHub |
+
+**Progression:** Filesystem + Notion → ElevenLabs
+
+---
+
+### 9. Communication & Collaboration
+
+**Core:** Team coordination, status updates, async communication
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Notion MCP | Shared documentation | Official (4K★) |
+| Atlassian MCP | Jira issues, Confluence docs | Official (436★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| internal-comms | Internal communication writing | Anthropic |
+| slack-gif-creator | Create engaging Slack messages with GIFs | Anthropic |
+| meeting-minutes | Capture and structure meeting notes | GitHub |
+| mentoring-juniors | Guide junior developers effectively | GitHub |
+| make-repo-contribution | Contribute to open-source repositories | GitHub |
+
+**Progression:** Notion → Atlassian
+
+---
+
+### 10. Project Management
+
+**Core:** Planning, task tracking, roadmapping, resource allocation
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| GitHub MCP | Issues, milestones, project boards | Official (28K★) |
+| Notion MCP | Project wikis, databases | Official (4K★) |
+| Atlassian MCP | Jira sprints, boards | Official (436★) |
+| Memory MCP | Track decisions across sessions | Reference |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| breakdown-epic-pm | Break epics into manageable stories | GitHub |
+| breakdown-plan | Decompose plans into actionable tasks | GitHub |
+| prd | Write product requirements documents | GitHub |
+| create-github-issues-feature-from-implementation-plan | Convert plans to trackable GitHub issues | GitHub |
+| github-issues | Effective GitHub issue management | GitHub |
+| create-architectural-decision-record | Document architecture decisions (ADRs) | GitHub |
+| project-workflow-analysis-blueprint-generator | Analyze and document project workflows | GitHub |
+
+**Progression:** GitHub issues + Notion → Atlassian → Memory
+
+---
+
+### 11. Media & Audio Production
+
+**Core:** Audio editing, music, podcasts, sound design
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| ElevenLabs MCP | Text-to-speech voice generation | Official (1.3K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| transloadit-media-processing | Media processing (video, OCR, 86+ formats) | GitHub |
+| image-manipulation-image-magick | Image manipulation with ImageMagick | GitHub |
+
+**Progression:** ElevenLabs
+
+---
+
+### 12. Database & Backend
+
+**Core:** Schema design, query optimization, migrations, data modeling
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| MongoDB MCP | Document database operations | Official (959★) |
+| Chroma MCP | Vector database for embeddings | Official (515★) |
+| Stripe MCP | Payment integration & data | Official (1.4K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| postgresql-optimization | PostgreSQL query and schema optimization | GitHub |
+| postgresql-code-review | Review PostgreSQL code for issues | GitHub |
+| cosmosdb-datamodeling | NoSQL data modeling patterns | GitHub |
+| ef-core | Entity Framework Core patterns | GitHub |
+| creating-oracle-to-postgres-master-migration-plan | Database migration planning | GitHub |
+
+**Progression:** MongoDB → Chroma → Stripe
+
+---
+
+### 13. Cloud & Platform
+
+**Core:** Cloud services, serverless, edge computing, scaling
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| AWS MCP Servers | Lambda, S3, EC2, full AWS suite | Official (8.5K★) |
+| Cloudflare MCP | Workers, edge, CDN, DNS | Official (3.5K★) |
+| Terraform MCP | Multi-cloud IaC | Official (1.3K★) |
+| Docker MCP Gateway | Container orchestration | Official (1.3K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| azure-static-web-apps | Deploy static web apps to cloud | GitHub |
+| azure-resource-visualizer | Visualize cloud resource relationships | GitHub |
+| azure-role-selector | Select appropriate cloud IAM roles | GitHub |
+| containerize-aspnetcore | Containerize applications for cloud | GitHub |
+
+**Progression:** Docker → AWS/Cloudflare → Terraform
+
+---
+
+### 14. Marketing & SEO
+
+**Core:** SEO, competitor analysis, content strategy, social media
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Firecrawl MCP | SEO audit, competitor crawling | Official (5.8K★) |
+| Brave Search MCP | Market research, trend analysis | Official (775★) |
+| Notion MCP | Content calendar, strategy docs | Official (4K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| napkin | Quick ideation and concept sketching | GitHub |
+| sponsor-finder | Find potential sponsors and partners | GitHub |
+| boost-prompt | Improve and refine prompts for better output | GitHub |
+
+**Progression:** Brave Search → Firecrawl → Notion
+
+---
+
+### 15. Science & Life Sciences
+
+**Core:** Research, data analysis, literature review, bioinformatics
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| arXiv MCP | Academic paper search & retrieval | Verified Community (2.4K★) |
+| Fetch MCP | Access PubMed, NCBI, and other APIs | Reference |
+| Memory MCP | Track research findings across sessions | Reference |
+
+#### Skills
+No dedicated science skills yet. Uses Research & Knowledge (Section 7) and Data Analysis (Section 3) skills.
+
+**Progression:** Fetch (PubMed API) + arXiv → Memory
+
+---
+
+### 16. Finance & Commerce
+
+**Core:** Financial data, payments, pricing, market analysis
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Stripe MCP | Payment integration & billing | Official (1.4K★) |
+| Brave Search MCP | Market research, financial news | Official (775★) |
+| Fetch MCP | Access financial APIs directly | Reference |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| azure-pricing | Cloud pricing analysis and estimation | GitHub |
+| datanalysis-credit-risk | Financial risk data analysis | GitHub |
+
+**Progression:** Fetch (financial APIs) → Brave Search → Stripe
+
+---
+
+### 17. AI & Machine Learning
+
+**Core:** Model training, prompt engineering, agent orchestration
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Sequential Thinking MCP | Complex multi-step reasoning | Reference |
+| Memory MCP | Persistent knowledge across sessions | Reference |
+| Chroma MCP | Vector database for embeddings | Official (515★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| claude-api | Build applications with the Claude API | Anthropic |
+| mcp-builder | Build MCP servers from scratch | Anthropic |
+| skill-creator | Create new agent skills (SKILL.md) | Anthropic |
+| model-recommendation | Choose the right AI model for a task | GitHub |
+| agentic-eval | Evaluate agentic AI systems | GitHub |
+| prompt-builder | Craft effective prompts | GitHub |
+| finalize-agent-prompt | Polish and finalize agent system prompts | GitHub |
+| structured-autonomy-plan | Plan structured autonomous agent workflows | GitHub |
+
+**Progression:** Sequential Thinking + Memory → Chroma
+
+---
+
+### 18. Culture & Creative
+
+**Core:** Art curation, cultural knowledge, entertainment, creative projects
+
+#### MCPs
+| Tool | Purpose | Trust |
+|------|---------|-------|
+| Fetch MCP | Access museum APIs (Met, Smithsonian, etc.) | Reference |
+| ElevenLabs MCP | Audio for creative projects | Official (1.3K★) |
+
+#### Skills
+| Skill | What It Teaches | Source |
+|-------|----------------|--------|
+| algorithmic-art | Generate art through code and algorithms | Anthropic |
+| game-engine | Game development patterns and engines | GitHub |
+| repo-story-time | Tell the story of a codebase's evolution | GitHub |
+| noob-mode | Explain complex topics simply | GitHub |
+
+**Progression:** Fetch (museum APIs) → ElevenLabs
+
+---
+
+## Part 2: Level-Up MCP Tool List (69 tools)
+
+These are the tools built into the Level-Up server itself. Agents call these to track work, manage their profile, and earn XP.
+
+### Section 1 — Users (13 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_register_user` | Register a new user profile |
+| `levelup_get_user_profile` | Fetch public profile with rank and class levels |
+| `levelup_get_user_progress` | Get main level/XP and class progression |
+| `levelup_find_user` | Find user by username, handle, profile code, or identity |
+| `levelup_generate_link_code` | Generate code for cross-platform identity linking |
+| `levelup_redeem_link_code` | Redeem link code to connect accounts |
+| `levelup_link_identity` | Link a new identity provider to an existing user |
+| `levelup_request_otp` | Send OTP via email (deferred — no mail service yet) |
+| `levelup_verify_otp` | Verify OTP and authenticate user |
+| `levelup_get_onboarding_status` | Check user's onboarding progress |
+| `levelup_update_user_profile` | Update username, handle, email, metadata |
+| `levelup_infer_task_type` | Categorize a work description into a task type |
+| `levelup_merge_profiles` | Merge two user profiles (consolidate XP and progress) |
+
+### Section 2 — Agents (4 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_register_agent` | Create a new AI agent with owner and integrity score |
+| `levelup_get_agent_profile` | Get agent's profile with level, XP, and skills |
+| `levelup_list_user_agents` | List all agents owned by a user |
+| `levelup_update_agent` | Update agent profile (name, description, system prompt) |
+
+### Section 3 — Skills (6 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_add_agent_skill` | Install a skill on an agent (mcp_installed gives instant proficiency 1) |
+| `levelup_get_agent_skills` | Get agent's proficiency levels across all skills |
+| `levelup_list_skills` | Browse the full skill catalog (106 skills, 18 categories) |
+| `levelup_list_skill_categories` | List all 18 ability categories |
+| `levelup_suggest_skill` | Get skill suggestions based on recent task history |
+| `levelup_get_skill_progress` | Track agent's progress toward next skill level |
+
+### Section 4 — Tasks (10 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_start_task` | Begin tracking a new task (creates task record) |
+| `levelup_update_task` | Add notes, change difficulty/output_type while in progress |
+| `levelup_complete_task` | Mark task complete and trigger XP award via RPC |
+| `levelup_fail_task` | Mark task failed (awards 15% consolation XP) |
+| `levelup_get_task` | Fetch a single task's full details and status |
+| `levelup_list_tasks` | List tasks with filtering (user, agent, status, date range) |
+| `levelup_list_task_types` | Show all 82 task type definitions with base XP |
+| `levelup_add_task_evidence` | Attach artifacts or evidence to a task |
+| `levelup_get_task_log` | Get changelog of all updates to a task |
+| `levelup_resume_or_start` | Resume incomplete task or auto-start based on context |
+
+### Section 5 — Ratings (7 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_capture_expectations` | Record expected outcomes before task execution |
+| `levelup_submit_agent_evaluation` | Rate agent performance (clarity, technical skill, reliability) |
+| `levelup_request_system_evaluation` | Request AI evaluation of task quality |
+| `levelup_submit_test_results` | Log automated test results and pass/fail ratio |
+| `levelup_get_task_quality` | Fetch quality score and evaluations for a task |
+| `levelup_submit_calibration_review` | Compare evaluator's rating against system's |
+| `levelup_get_calibration_queue` | List tasks awaiting calibration review |
+
+### Section 6 — Quests (12 tools) — *Not active yet*
+| Tool | Purpose |
+|------|---------|
+| `levelup_process_weekly_bonuses` | Run weekly bonus calculation (cron job) |
+| `levelup_get_weekly_bonus_summary` | Show user's progress on weekly criteria |
+| `levelup_propose_bonus_criteria` | Suggest new weekly bonus category |
+| `levelup_approve_bonus_criteria` | Admin: approve or reject bonus criteria |
+| `levelup_create_quest` | Create a multi-step quest with rewards |
+| `levelup_get_quest` | Fetch quest details and participation status |
+| `levelup_list_quests` | List active quests with filters |
+| `levelup_join_quest` | Enroll user/agent in a quest |
+| `levelup_update_quest_progress` | Mark quest milestone complete |
+| `levelup_complete_quest` | Finish quest and award XP |
+| `levelup_verify_quest` | Admin: validate quest completion |
+| `levelup_create_community_quest` | Create user-proposed quest |
+
+### Section 7 — Metrics (3 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_report_metrics` | Log productivity metrics (lines coded, tasks completed, etc.) |
+| `levelup_import_history` | Bulk import historical task data from external sources |
+| `levelup_get_metrics_summary` | Get aggregate metrics over a time period |
+
+### Section 8 — XP & Progression (5 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_get_xp_history` | Show XP ledger (all transactions) for user/agent |
+| `levelup_get_xp_summary` | Total XP earned, XP by task type, XP by recipient |
+| `levelup_get_split_rules` | Show how XP is divided between performers |
+| `levelup_get_xp_projection` | Estimate XP earned and level timeline |
+| `levelup_get_weekly_recap` | Show weekly XP earned and top earners |
+
+### Section 9 — Leaderboards (1 tool)
+| Tool | Purpose |
+|------|---------|
+| `levelup_get_leaderboard` | Rank users/agents by level or XP (with class/tier filters) |
+
+### Section 10 — Leveling (3 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_get_level_info` | Get current level, XP to next level, rank name |
+| `levelup_get_level_requirements` | Show XP required for each level (1–30) |
+| `levelup_get_next_unlock` | Show what skill/achievement unlocks at next level |
+
+### Section 11 — Achievements (2 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_get_achievements` | List earned + available achievements |
+| `levelup_scan_achievements` | Auto-detect and credit earned achievements |
+
+### Section 12 — Admin (5 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_create_task_type` | Add new task type definition |
+| `levelup_suggest_task_type` | AI-suggest task type for a work description |
+| `levelup_create_skill` | Define new skill in a category |
+| `levelup_create_split_rule` | Configure XP split for a performer type combo |
+| `levelup_set_xp_config` | Configure system parameters (multipliers, bonuses, caps) |
+
+### Section 13 — System (4 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_process_metrics` | Internal: aggregate metrics and trigger bonus calculations |
+| `levelup_snapshot_agent` | Save agent's current state for audit trail |
+| `levelup_check_level_up` | Check if entity qualifies for promotion (triggers RPC) |
+| `levelup_whoami` | Return authenticated user/agent identity and context |
+
+### Onboarding (2 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_bootstrap` | Initialize Level-Up for first use |
+| `levelup_setup_wizard` | Interactive onboarding (create user, agent, task types) |
+
+### Growth Planning (2 tools)
+| Tool | Purpose |
+|------|---------|
+| `levelup_get_growth_plan` | Personalized skill and achievement roadmap |
+| `levelup_browse_skillsets` | Show recommended skill combinations for roles |
+
+---
+
+## Part 3: Rank System
+
+### User Ranks
+| Level Range | Rank |
+|-------------|------|
+| 1–5 | Analyst |
+| 6–10 | Tactician |
+| 11–15 | Strategist |
+| 16–20 | Commander |
+| 21–25 | Grandmaster |
+| 26–30 | Supreme |
+
+### Agent Ranks
+| Level Range | Rank |
+|-------------|------|
+| 1–5 | Novice |
+| 6–10 | Pathfinder |
+| 11–15 | Enlightened |
+| 16–20 | Paragon |
+| 21–25 | Transcendent |
+| 26–30 | Celestial |
+
+### Class Tracks (Users)
+Trainer · Orchestrator · Partner — each has its own XP pool and level progression.
+
+---
+
+## Part 4: MCP Trust Summary
+
+### Official (published by platform owner)
+| MCP | Stars |
+|-----|-------|
+| GitHub MCP | 28K |
+| Playwright MCP | 29K |
+| AWS MCP | 8.5K |
+| Firecrawl MCP | 5.8K |
+| Notion MCP | 4K |
+| Cloudflare MCP | 3.5K |
+| Grafana MCP | 2.5K |
+| Snyk Agent Scan | 1.9K |
+| Stripe MCP | 1.4K |
+| Docker MCP Gateway | 1.3K |
+| Terraform MCP | 1.3K |
+| ElevenLabs MCP | 1.3K |
+| MongoDB MCP | 959 |
+| Brave Search MCP | 775 |
+| Chroma MCP | 515 |
+| Atlassian MCP | 436 |
+
+### Reference (MCP org — modelcontextprotocol/servers)
+Filesystem · Git · Fetch · Memory · Sequential Thinking
+
+### Verified Community (500+ stars)
+| MCP | Stars |
+|-----|-------|
+| Desktop Commander | 5.7K |
+| arXiv MCP | 2.4K |
+
+---
+
+*Generated from Level-Up MCP Server v0.3.3 — docs/recommended-skillsets.md and src/tools/*