Agent skill

amp-skill-creator

PRIMARY skill creator. Use this by default when creating ANY skill. If user explicitly asks for a "Claude skill", "Claude-compatible skill", or "universal skill", use agent-skill-creator instead. Handles Amp-specific features (mcp.json, OAuth, Amp frontmatter).

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/amp-skill-creator

SKILL.md

Amp Skill Creator

This skill covers Amp-specific features for skill creation. After reading this, load the agent-skill-creator skill and follow its workflow, applying the overrides at the end of this document.

First: Ask Where to Install

Before creating a skill, ask the user where they want it installed (if they haven't already specified):

  • .agents/skills/ — workspace-local (project-specific)
  • ~/.config/amp/skills/ — global user

Amp-Specific Features

Amp Frontmatter Fields

Beyond the required name and description, Amp supports:

yaml
---
name: my-skill-name
description: What the skill does and when to use it
argument-hint: "[query]" # Shown in /skill-list (e.g., "[repo] [issue]")
disable-model-invocation: true # Hides from agent auto-detection (manual /skill only)
---

Bundled MCP Servers

Skills can bundle MCP servers via mcp.json in the skill root:

skill-name/
├── SKILL.md
└── mcp.json

mcp.json Format

json
{
  "local-server-name": {
    "command": "npx",
    "args": ["-y", "some-mcp-server@latest"],
    "env": {
      "API_KEY": "${MY_API_KEY}"
    },
    "includeTools": ["tool_a", "tool_b", "navigate_*"]
  },
  "remote-server-name": {
    "url": "https://some-mcp-server.com/mcp",
    "headers": {
      "Authorization": "Bearer ${TOKEN}"
    },
    "includeTools": ["tool_a", "tool_b"]
  }
}

Local Server Fields

Field Required Description
command Yes Command to run
args No Array of command arguments
env No Environment variables for the server
includeTools Recommended Glob patterns to filter exposed tools

Remote Server Fields

Field Required Description
url Yes URL of the MCP server
headers No Headers to send with requests
includeTools Recommended Glob patterns to filter exposed tools

Environment Variables

Use ${VAR_NAME} syntax in any field:

json
{
  "my-server": {
    "command": "node",
    "args": ["${HOME}/scripts/mcp-server.js"],
    "env": {
      "API_KEY": "${SERVICE_API_KEY}"
    }
  }
}

Always Filter Tools

MCP servers often expose many tools (20+ = thousands of tokens). Always use includeTools:

json
{
  "includeTools": ["navigate_page", "take_screenshot", "click"]
}

Glob patterns supported: ["navigate_*", "click"] or ["*"] for all.

Adding MCP Servers via CLI

Use amp mcp add to quickly generate MCP server config:

sh
# Local server (command-based)
amp mcp add <name> -- <command> [args...]

# Local server with env vars
amp mcp add <name> --env KEY=VAL -- <command> [args...]

# Remote server (URL-based, auto-detects transport)
amp mcp add <name> <url>

# Remote server with headers
amp mcp add <name> --header "Authorization=Bearer <token>" <url>

# Add to workspace settings instead of global
amp mcp add <name> --workspace -- <command> [args...]

Note: This command adds the server config to ~/.config/amp/settings.json (or workspace settings with --workspace), not directly into a skill's mcp.json. After running, copy the relevant entry from settings into your skill's mcp.json file.

Options

Option Description
--env KEY=VAL Environment variables (repeatable)
--header KEY=VAL HTTP headers for URL-based servers (repeatable)
--workspace Add to workspace settings instead of global (~/.config/amp/settings.json)

Examples

sh
# NPX-based server
amp mcp add context7 -- npx -y @upstash/context7-mcp

# Postgres with env vars
amp mcp add postgres --env PGUSER=myuser -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb

# Remote with auth header
amp mcp add sourcegraph --header "Authorization=token <token>" https://sourcegraph.example.com/.api/mcp/v1

# Remote with OAuth (auto-triggers browser auth)
amp mcp add linear https://mcp.linear.app/sse

# Workspace-specific server
amp mcp add project-server --workspace -- npx -y @some/server

Now: Load agent-skill-creator

Load the agent-skill-creator skill now and follow its 6-phase workflow for creating the skill content. Apply these overrides during implementation:

Overrides for agent-skill-creator

agent-skill-creator Says Amp Does Instead
Create marketplace.json Not used — Amp uses SKILL.md frontmatter only
Create .claude-plugin/ directory Not used in Amp
Skills in plugins/cache/ Use locations from "First: Ask Where to Install" above
plugins[0].description must sync with SKILL.md Not applicable — only SKILL.md frontmatter matters
Cross-platform export to Desktop/API Not applicable to Amp skills
Use -cskill suffix naming convention Optional — use descriptive names
Run /plugin marketplace add ./skill-name Skill will be loaded automatically based on file location

What to USE from agent-skill-creator:

  • ✅ General SKILL.md content structure (workflows, examples, error handling)
  • ✅ Scripts organization (scripts/, utils/)
  • ✅ References organization (references/)
  • ✅ Quality standards (1000+ words, real examples, no TODOs)
  • ✅ Modular architecture patterns
  • ✅ Testing approaches
  • ✅ Validation patterns

Didn't find tool you were looking for?

Be as detailed as possible for better results