Home › Learn

Learn

Practical guides for building, distributing, and operating Claude Code skills. Everything here is hand-written reference material — no AI-generated filler. Tutorials cover the SKILL.md spec, design patterns from the catalog's top-scoring skills, and how Claude Code skills relate to neighbouring concepts like MCP servers and Claude API tools.

How to write a Claude Code skill

Step-by-step walkthrough — from ~/.claude/skills/<slug>/SKILL.md location to YAML frontmatter, anti-trigger discipline, and packaging for distribution. Includes a copy-pasteable starter template.

~2,500 words · for first-time skill authors

SKILL.md frontmatter reference

Complete reference for every YAML frontmatter field Claude Code recognizes — name, description, model, tags, allowed-tools, user-invokable, category, plus the optional metadata fields the registry indexes.

~1,800 words · technical reference

Claude Code skills vs MCP servers

When to write a skill, when to write an MCP server, when both. Architecture trade-offs, deployment differences, and a decision tree for picking the right primitive for your use case.

~2,200 words · for engineers picking architectures

More tutorials shipping soon. Suggest a topic at acreatorstore@translatea.com.