skills

Convert Claude-style skills into callable tools for MCP clients.

4.9k|489|Updated Aug 12, 2025
One-click install
npx skills add https://github.com/github/gh-aw --skill skills-github
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skills
Source: https://github.com/github/gh-aw/tree/main/skills/skillz-integration
Command: npx skills add https://github.com/github/gh-aw --skill skills-github

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skillz MCP Server converts Claude-style skills (SKILL.md files plus optional resources) into callable tools for MCP clients. It discovers each skill, exposes instructions and resources, and can run bundled helper scripts.

Core Features & Use Cases

  • Skill discovery: Automatically finds and exposes each skill found under a root skills directory via SKILL.md frontmatter.
  • Resource exposure: Makes instructions, references, and assets available to MCP clients for guided automation.
  • Scriptable automation: Runs bundled helper scripts to perform complex tasks within containerized MCP environments.
  • Use Case: Wire a skill into a GitHub Action to transform natural-language intents into concrete automated steps.

Quick Start

Configure Skillz as a MCP server in your workflow frontmatter, mount your skills directory, and reference SKILL.md to execute a skill.

Frequently Asked Questions about skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn Claude-style SKILL.md files into callable MCP tools?

To turn Claude-style SKILL.md files into callable MCP tools, you configure Skillz as an MCP server in your workflow, mount your root skills directory, and it automatically discovers and exposes each skill via YAML frontmatter.

How does skill discovery work for nested directories in an MCP server?

Skill discovery for nested directories works by automatically scanning a root skills folder to find SKILL.md files, parsing their YAML frontmatter, and exposing the identified instructions and resources to MCP clients.

Can I run helper scripts within containerized MCP environments using discovered skills?

Yes, you can run bundled helper scripts within containerized MCP environments. The server executes scripts stored under the scripts/ directory to perform complex automation tasks guided by natural-language intents.

What file structure is required to expose instructions and resources to MCP clients?

Exposing instructions and resources to MCP clients requires a SKILL.md file with YAML frontmatter at minimum, plus optional resources organized under scripts/, references/, and assets/ directories within each skill folder.

Does Skillz work with Docker and GitHub Actions for workflow automation?

Yes, Skillz works with Docker and GitHub Actions for workflow automation by wiring discovered skills into GitHub Actions, transforming natural-language intents into concrete automated steps within containerized MCP environments.