help

Help Skill

This is the default skill loaded by the skill-to-mcp server when no skills directory is specified.

Purpose

The skill-to-mcp server converts AI Skills (following Claude Skills format) into MCP server resources. This help skill provides basic information about using the server.

Available Tools

The server provides three core tools:

1. get_available_skills: Lists all available skills with their descriptions
2. get_skill_details: Returns the full SKILL.md content and file listing for a specific skill
3. get_skill_related_file: Reads any file within a skill directory

Installing Additional Skills

To use custom skills with this server, you need to:

1. Create or obtain a skills directory containing skill subdirectories
2. Configure the server to use your skills directory

Option 1: Using Command-Line Option

skill_to_mcp --skills-dir /path/to/your/skills

Or with uvx:

uvx skill_to_mcp --skills-dir /path/to/your/skills

Option 2: Using Environment Variable

Set the SKILLS_DIR environment variable:

export SKILLS_DIR=/path/to/your/skills
skill_to_mcp

Option 3: MCP Client Configuration

Configure your MCP client (e.g., Claude Desktop) to pass the skills directory:

{
  "mcpServers": {
    "my-skills": {
      "command": "uvx",
      "args": ["skill_to_mcp", "--skills-dir", "/path/to/your/skills"],
      "env": {
        "UV_PYTHON": "3.12"
      }
    }
  }
}

Creating Your Own Skills

Each skill must:

1. Have its own subdirectory
2. Contain a SKILL.md file with YAML frontmatter
3. Follow this frontmatter format:

---
name: my-skill-name
description: Brief description of what this skill does and when to use it
---

# Skill Content

Your skill instructions and documentation go here...

Example Skill Structure

my-skills/
├── skill-1/
│   ├── SKILL.md
│   ├── scripts/
│   │   └── example.py
│   └── references/
│       └── guidelines.md
└── skill-2/
    └── SKILL.md