mdskills

Learn

Guides, comparisons, and tutorials for AI agent skills.

Building with code
Guides

How to Build Your First MCP Server

Build a working MCP server in TypeScript from scratch. Covers the protocol, tool registration, and connecting to Claude Code.

Security lock on screen
Concepts

MCP Server Security: What to Check Before Connecting

MCP servers can read files, run commands, and make network requests. What to audit before giving an AI agent access to one.

Puzzle pieces connecting
Concepts

How MCP and SKILL.md Work Together

MCP gives agents tools. Skills give agents knowledge. Using both together is where AI coding gets powerful.

Network connections
Comparisons

MCP vs REST APIs: When to Use Each for AI Agents

MCP and REST APIs both connect agents to external services. Here is when MCP makes sense and when a plain API call is simpler.

Windows terminal
Agent Setup

How to Set Up Claude Code Skills on Windows

Windows-specific setup for Claude Code skills: file paths, PowerShell commands, WSL considerations, and common gotchas.

File folders organized
Agent Setup

Where Are Cursor Skills Stored? File Paths by OS

Every directory Cursor checks for .cursorrules and SKILL.md files on macOS, Linux, and Windows.

Code on screen
Agent Setup

Where Are Codex CLI Skills Stored?

File paths and directory structure for SKILL.md skills in OpenAI Codex CLI on every platform.

Terminal in dark room
Agent Setup

Where Are Gemini CLI Skills Stored?

How Gemini CLI discovers and loads SKILL.md files. Covers project-local, user-level, and plugin-installed skill paths.

Debugging interface
Agent Setup

Claude Code Skills Not Loading? Common Fixes

Your skill installed but Claude Code ignores it. Here are the most common causes and how to fix each one.

Team managing workflow
Guides

How to Update and Manage Your Installed AI Agent Skills

Keeping SKILL.md files current: checking versions, updating from Git, managing conflicts, and cleaning up unused skills.

Data metrics
Guides

How to Reduce Claude Code Token Usage with Skills

Skills that load on every request burn tokens. Here is how progressive loading works and how to keep costs down.

Technology pattern
Guides

AI Agent Skills Not Triggering? How the Description Field Works

The description in SKILL.md frontmatter controls when your skill activates. How agents match descriptions to user requests.