convez.ai
MCP ServerProdutividadeIntermediário
Bbeierle12

Skills Manager - Gerenciador Visual de MCP Skills

Bbeierle12/Skill-MCP-Claude

Interface visual para gerenciar skills do Claude MCP com Flask API

Ver no GitHub
BomPluginScore · de 0 a 100

Interface web visual para gerenciar Claude MCP Skills com integração Flask API e CLI. Permite criar, editar e organizar skills (instruções especializadas em markdown) que Claude pode carregar sob demanda, com arquitetura stdio/MCP para sincronização com Claude Desktop.

Instalação

$npx convez-ai Bbeierle12/Skill-MCP-Claude

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
9
Forks
4
Acompanhando
1
Saúde
42%
Último commit
há 2 dias
Versão
—
Issues abertas
1
Contribuidores
4

Casos de uso

  • Criar e organizar skills especializados para expandir capacidades do Claude
  • Gerenciar instruções personalizadas e conhecimento contextual em markdown
  • Integrar skills entre Claude Desktop e interfaces web via MCP

Veredito

Ferramenta prática para quem trabalha com Claude MCP e precisa gerenciar múltiplos skills. A arquitetura é clara e o setup funcional, mas o projeto ainda é experimental (nota sobre TypeScript vs JavaScript no nome). Válido para power users que querem centralizar e versionar sua coleção de skills.

README

A tradução para o português deste README ainda está na fila.

Skills Manager

A visual web interface for managing Claude MCP Skills with Claude Code CLI integration.

Project Overview

This project provides a browser-based UI for managing skills in an MCP (Model Context Protocol) server. Skills are markdown-based instruction sets that Claude can load on-demand to gain specialized knowledge.

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        Skills Manager                           │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   ┌──────────────────┐         ┌──────────────────────────┐    │
│   │  Claude Desktop  │         │     Browser UI           │    │
│   │  (MCP Client)    │         │  skills-manager.html     │    │
│   └────────┬─────────┘         └────────────┬─────────────┘    │
│            │                                │                   │
│            │ stdio/MCP                      │ HTTP REST         │
│            │                                │                   │
│   ┌────────▼─────────┐         ┌────────────▼─────────────┐    │
│   │   server.py      │         │  skills_manager_api.py   │    │
│   │   (MCP Server)   │         │  (Flask API :5050)       │    │
│   └────────┬─────────┘         └────────────┬─────────────┘    │
│            │                                │                   │
│            └────────────┬───────────────────┘                   │
│                         │                                       │
│                         ▼                                       │
│                  ┌──────────────┐                               │
│                  │   skills/    │                               │
│                  │  (folder)    │                               │
│                  └──────────────┘                               │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

File Structure

skills-mcp/
├── server.py                 # MCP server (FastMCP) - connects to Claude Desktop
├── skills_manager_api.py     # Flask HTTP API server (port 5050)
├── skills_manager_app.py     # Standalone all-in-one app (for .exe build)
├── skills-manager.html       # Web UI (single-file, Tailwind + Lucide)
├── requirements.txt          # Python dependencies
├── build.bat                 # Windows build script for .exe
├── skills/                   # Skills directory
│   ├── my-skill/
│   │   ├── SKILL.md          # Main skill content
│   │   ├── _meta.json        # Metadata (tags, description)
│   │   ├── scripts/          # Optional helper scripts
│   │   └── references/       # Optional reference docs
│   └── another-skill/
│       └── ...
└── dist/                     # Built executable + assets
    ├── SkillsManager.exe
    ├── skills-manager.html
    └── README.md

Setup

Prerequisites

  • Python 3.10+
  • Node.js (optional, for Claude Code CLI)
  • Claude Code CLI (optional, for AI features)

Installation

cd skills-mcp
pip install -r requirements.txt

Running the API Server

python skills_manager_api.py

Opens at: http://localhost:5050

Running the MCP Server (for Claude Desktop)

The MCP server runs automatically when Claude Desktop starts (configured in claude_desktop_config.json).

Manual test:

python server.py

Daily Skills Catalogue Audit

The repo ships an automated review system that grades every skill daily and surfaces improvement opportunities. See reports/ for the latest output.

What it does

  • Pass 1 (deterministic, every run): structural defects — missing files, description drift between _meta.json and SKILL.md frontmatter, broken references, unknown depends_on targets, oversized SKILL.md files, thin asset-less skills, duplicate sub-skill triggers, stale reviews.
  • Pass 2 (one skill per run): content audit of the skill whose last_reviewed_at is oldest. Runs a deterministic rubric (description distinctness vs. tag-cluster siblings, library version mentions, asset richness, cross-references), proposes a relevance_tier (A/B/C/D), and optionally calls the Claude CLI for an LLM-assisted rubric.
  • Pass 3 (weekly): catalogue-level review — sibling description overlap, router necessity, tag-cluster drift vs. last week's snapshot, source distribution.

Running locally

# Add the audit metadata fields once (idempotent):
python scripts/backfill_audit_meta.py

# Daily run (writes reports/YYYY-MM-DD.md):
python scripts/run_daily_audit.py

# With weekly Pass 3 + the LLM rubric:
python scripts/run_daily_audit.py --weekly --use-llm

The GitHub Actions workflow .github/workflows/skills-audit.yml runs the daily audit at 06:30 UTC and commits the resulting report. The Monday run also performs Pass 3.

Metadata fields added to _meta.json

FieldTypeMeaning
last_reviewed_atISO date or nullWhen Pass 2 last audited this skill
review_scoreint 0–100 or nullComposite of distinctness + asset richness + freshness + cross-references
relevance_tier"A" / "B" / "C" / "D" / nullA = irreplaceable, B = trim & keep, C = redundant with base-model output, D = obsolete

The Skills Manager UI shows these as a filter dropdown and a per-card badge.

Development

Key Files to Edit

FilePurpose
skills-manager.htmlFrontend UI (vanilla JS, Tailwind CSS, Lucide icons)
skills_manager_api.pyBackend REST API (Flask)
server.pyMCP server for Claude Desktop integration
skills_manager_app.pyStandalone app (combines API + launcher for .exe)

API Endpoints

MethodEndpointDescription
GET/api/skillsList all skills
GET/api/skills/<name>Get skill details
POST/api/skillsCreate new skill
PUT/api/skills/<name>Update skill
DELETE/api/skills/<name>Delete skill
POST/api/import/folderImport skill from folder path
POST/api/import/jsonImport files via JSON
GET/api/browse?path=Browse filesystem
GET/api/claude/statusCheck Claude CLI availability
POST/api/claude/runRun Claude with prompt
POST/api/claude/generate-skillGenerate skill with AI

Frontend Structure

The UI is a single HTML file with embedded CSS and JavaScript:

  • Modals: Import, Folder Browser, File Upload, Generate, View, Claude Console
  • State: skills[], selectedFolderPath, browsePathCache{}, etc.
  • Key Functions:
    • browsePath(path) - Navigate filesystem
    • importSelectedFolder() - Copy folder to skills/
    • uploadFiles() - Upload files as new skill
    • generateSkill() - AI skill generation
    • runConsoleCommand() - Execute Claude prompts

Building the Executable

# Windows
build.bat

# Or manually
pip install pyinstaller
python -m PyInstaller --onefile --name "SkillsManager" --console ^
    --add-data "skills-manager.html;." skills_manager_app.py

Output: dist/SkillsManager.exe

Skill Format

SKILL.md Structure

---
name: skill-name
description: When Claude should use this skill
---

# Skill Name

## Overview
What this skill helps with.

## When to Use
- Trigger condition 1
- Trigger condition 2

## Quick Start
\`\`\`code
Example usage
\`\`\`

## Best Practices
- Practice 1
- Practice 2

## Examples
Practical examples here.

_meta.json Structure

{
  "name": "skill-name",
  "description": "One-line description",
  "tags": ["tag1", "tag2"],
  "sub_skills": [],
  "source": "imported"
}

Claude Desktop Configuration

Location: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "skills": {
      "command": "python",
      "args": ["C:/Users/<YOUR_USERNAME>/skills-mcp/server.py"]
    }
  }
}

MCP Tools (for Claude)

The MCP server exposes these tools to Claude:

ToolDescription
list_skills()List all available skills
get_skill(name)Load a skill's SKILL.md content
search_skills(query)Search skills by metadata
search_content(query)Full-text search across all skills
get_skills_batch([...])Load multiple skills at once
reload_index()Refresh skill index
validate_skills()Check skill integrity

Known Issues / TODO

  • Folder browser doesn't show drive letters on initial load (starts at root drives)
  • No confirmation before overwriting existing skills
  • File upload doesn't preserve folder structure from drag-drop
  • Claude Console output doesn't syntax highlight
  • No skill versioning or backup

Tech Stack

  • Backend: Python 3.11, Flask, Flask-CORS, FastMCP
  • Frontend: Vanilla JS, Tailwind CSS (CDN), Lucide Icons (CDN)
  • Build: PyInstaller
  • Protocol: MCP (Model Context Protocol)
Ver o original no GitHub

Bom para

Relacionados