MCPCloud.sh — Product and API reference
All concepts

What is an AI skill?

An AI skill is a versioned, installable package of instructions, workflow steps, and guardrails that teaches an AI agent how to perform a specific job — review a pull request, triage a support queue, produce a weekly report. Where an MCP server gives an agent capability (tools it can call), a skill gives it competence: how and when to use those tools, in what order, and what it must never do.

What’s inside a skill

The artifact at the center is a SKILL.md — the instructions an agent loads when the skill is invoked. Around it, a skill packages the procedure’s structure and its rules:

  • Instructions — the job, its steps, and the judgment calls, written for the agent that will execute them.
  • Workflow structure — the ordered steps or dependency graph the procedure follows.
  • Guardrails — hard constraints that ship inside the package: what the skill must never do, checked rather than hoped for.
  • Tool expectations — which MCP servers and tools the skill assumes, so an agent can verify capability before starting.

Skills vs. prompts vs. tools

A prompt is text you paste into one conversation; it drifts as it gets copied and has no version history. A tool is a single callable capability with no opinion about when to use it. A skill is the packaged procedure that sits above both: it composes tools into a workflow, encodes the rules, and is versioned like software — installed, updated, rolled back.

The division of labor is clean: MCP servers supply what an agent can do, skills supply how the job is done well.

Why packaging matters

Teams discover the same failure with prose prompts everywhere: the good version lives in one person’s notes, edits fork silently, and the guardrails are whatever the last author remembered to paste. Packaging fixes that the way it fixed code — a skill has a version, a changelog, a review step, and an owner.

It also changes distribution: an org can publish skills to a private registry and push updates to every workspace at once, and a public marketplace can carry skills the way package registries carry libraries — with the guardrails traveling inside the package instead of depending on each user’s prompt hygiene.

Common questions

How is a skill different from a prompt template?

A prompt template is unstructured text with blanks; a skill is a versioned artifact with structure — instructions, workflow steps, declared tool dependencies, and guardrails. The practical difference shows up over time: skills have an upgrade path, a review history, and one canonical current version.

Does a skill require an MCP server?

Not necessarily. Many skills reference MCP tools and declare which servers they expect, but a pure-instruction skill — a procedure with rules and no external calls — is a valid and common package.

How are skills distributed?

Through registries, like software packages: a private organization registry for internal procedures, or a public marketplace for shared ones. Workspaces install a skill at a version and take updates deliberately.

Is this the same as Claude Skills?

The same concept and a compatible artifact: the SKILL.md instruction format popularized by Anthropic. Skills authored on MCPCloud publish as standard SKILL.md packages, so any agent runtime that understands the format can consume them.