Which integrations are available for this server?

Enables discovery, installation, and lifecycle management of agent skills hosted in GitHub repositories. Serves managed agent skills to GitHub Copilot via MCP, allowing for on-demand searching and loading of instructions. Provides specialized skills for machine learning and AI engineering, such as dataset creation and model evaluation. Delivers operational skills for Kubernetes management, including tools for deployment, monitoring, and troubleshooting. Manages and validates agent skills defined using Markdown for structured instructions and documentation. Utilizes YAML for managing skill metadata, enabling advanced filtering by category, tag, and namespace.

How do I use SkillPort?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SkillPort search for a skill that can handle web scraping" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

⚓ SkillPort

The SkillOps Toolkit for Agent Skills

SkillOps = Validate, manage, and deliver skills at scale.

Python MCP License

Why SkillPort?

When you...	SkillPort...
Use a coding agent without native skill support	Serves via MCP or CLI
Build your own AI agent	Provides MCP server, CLI, and Python library
Have 50+ skills and need the right one fast	Search-first loading (Tool Search Tool pattern)
Check skills before deployment	Validates against the spec in CI
Manage skill metadata programmatically	Provides `meta` commands
Find a skill on GitHub	Installs with `add <url>`

Fully compatible with the Agent Skills specification.

Features

Validate

Check skills against the Agent Skills specification.

skillport validate                    # Validate all skills
skillport validate ./skills           # Validate specific directory
skillport validate --json             # CI-friendly JSON output

Catches missing fields, naming issues, and spec violations before they cause problems.

Manage

Full lifecycle management from any source.

# Add from GitHub (shorthand)
skillport add anthropics/skills skills

# Add from GitHub (full URL)
skillport add https://github.com/anthropics/skills/tree/main/skills

# Add from local path or zip
skillport add ./my-skills
skillport add skills.zip

# Update, list, remove
skillport update                      # Update all from original sources
skillport list                        # See installed skills
skillport remove <skill-id>           # Uninstall

Metadata

Update skill metadata without editing files manually. Useful for automation and keeping skills consistent across a team.

skillport meta get <skill> <key>      # Get metadata value
skillport meta set <skill> <key> <val> # Set metadata value
skillport meta unset <skill> <key>    # Remove metadata key

Serve

MCP server for clients that don't natively support Agent Skills.

Inspired by Anthropic's Tool Search Tool pattern — search first, load on demand:

Tool	Purpose
`search_skills(query)`	Find skills by description (full-text search)
`load_skill(skill_id)`	Get full instructions + path

Why search matters: With 50+ skills, loading all upfront consumes context and hurts accuracy. SkillPort loads metadata only (~100 tokens/skill), then full instructions on demand.

Works with Cursor, Copilot, Windsurf, Cline, Codex, and any MCP-compatible client.

Quick Start

Install

uv tool install skillport
# or: pip install skillport

Add Skills

# Add from GitHub
skillport add anthropics/skills skills

# Or use a custom skills directory
skillport --skills-dir .claude/skills add anthropics/skills skills

Validate

skillport validate
# ✓ All 5 skill(s) pass validation

Connect to Agents

Choose how to deliver skills to your AI agents:

Mode	Best for	Setup
CLI Mode	Agents with shell access (Cursor, Windsurf, Codex, etc.)	Per-project
MCP Mode	MCP-compatible clients, multi-project	One-time

CLI Mode

For agents that can run shell commands. No MCP configuration required.

skillport init                        # Initialize project
skillport doc                         # Generate AGENTS.md with skill table
skillport show <id>                   # Load full instructions for a skill

How it works:

skillport doc generates a skill table in AGENTS.md
The agent reads AGENTS.md to discover available skills
When needed, the agent runs skillport show <id> to load full instructions

MCP Mode

For MCP-compatible clients. Install the server:

uv tool install skillport-mcp

Add to your client's config:

{
  "mcpServers": {
    "skillport": {
      "command": "uvx",
      "args": ["skillport-mcp"],
      "env": { "SKILLPORT_SKILLS_DIR": "~/.skillport/skills" }
    }
  }
}

Cursor

Install MCP Server

VS Code / GitHub Copilot

Install in VS Code

Kiro

Add to Kiro

CLI Agents

# Codex
codex mcp add skillport -- uvx skillport-mcp

# Claude Code
claude mcp add skillport -- uvx skillport-mcp

Organization

Organize skills with categories and tags. Works with both CLI and MCP modes.

Categories & Tags

Use metadata to organize and filter skills:

# SKILL.md frontmatter
metadata:
  skillport:
    category: development
    tags: [testing, quality]
    alwaysApply: true  # Always available (Core Skills)

Per-Client Filtering

Expose different skills to different agents:

{
  "mcpServers": {
    "skillport-dev": {
      "command": "uvx",
      "args": ["skillport-mcp"],
      "env": { "SKILLPORT_ENABLED_CATEGORIES": "development,testing" }
    },
    "skillport-writing": {
      "command": "uvx",
      "args": ["skillport-mcp"],
      "env": { "SKILLPORT_ENABLED_CATEGORIES": "writing,research" }
    }
  }
}

Configuration

Variable	Description	Default
`SKILLPORT_SKILLS_DIR`	Skills directory	`~/.skillport/skills`
`SKILLPORT_ENABLED_CATEGORIES`	Filter by category	all
`SKILLPORT_ENABLED_SKILLS`	Filter by skill ID	all
`SKILLPORT_ENABLED_NAMESPACES`	Filter by namespace	all
`SKILLPORT_CORE_SKILLS_MODE`	Core Skills behavior (`auto`/`explicit`/`none`)	`auto`

Creating Skills

Create a SKILL.md with YAML frontmatter:

---
name: my-skill
description: What this skill does
metadata:
  skillport:
    category: development
    tags: [example]
---
# My Skill

Instructions for the AI agent.

See Creating Skills Guide for best practices.

Skill Sources

Source	Features	Target	URL
Anthropic Official	Document skills (docx, pdf, pptx, xlsx), design, MCP builder	All users	GitHub
Awesome Claude Skills	Curated community collection, 2.5k+ stars	Discovery	GitHub
Hugging Face Skills	Dataset creation, model evaluation, LLM training, paper publishing	ML/AI engineers	GitHub
Claude Scientific Skills	128+ scientific skills (bio, chem, ML), 26+ databases	Researchers	GitHub
ClaudeKit Skills	30+ skills, auth, multimodal, problem-solving frameworks	Full-stack devs	GitHub
Superpowers	TDD, debugging, parallel agents, code review workflows	Quality-focused devs	GitHub
Kubernetes Operations	K8s deployment, monitoring, troubleshooting	DevOps/SRE	GitHub

Learn More

Development

Status: Work in progress. APIs may change.

git clone https://github.com/gotalab/skillport.git
cd skillport
uv sync

# Run MCP server
SKILLPORT_SKILLS_DIR=.skills uv run skillport-mcp

# Run CLI
uv run skillport --help

# Run tests
uv run pytest

License

MIT

SkillPort

⚓ SkillPort

Why SkillPort?

Features

Validate

Manage

Metadata

Serve

Quick Start

Install

Add Skills

Validate

Connect to Agents

CLI Mode

MCP Mode

Organization

Categories & Tags

Per-Client Filtering

Configuration

Creating Skills

Skill Sources

Learn More

Development

License

Resources

Latest Blog Posts

MCP directory API