MY

my-first-skill

Provides a template for structuring SKILL.md files and defines requirements for resource resolution and AI integration.

Install

mkdir -p .claude/skills/my-first-skill && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/8134" && unzip -o skill.zip -d .claude/skills/my-first-skill && rm skill.zip

Installs to .claude/skills/my-first-skill

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Example skill demonstrating Anthropic SKILL.md format. Load when learning to create skills or testing the OpenSkills loader.
124 chars✓ has a “when” trigger
Beginner

Key capabilities

  • Demonstrate SKILL.md structure
  • Reference skill creation patterns
  • Test OpenSkills loader functionality
  • Provide documentation examples

How it works

It serves as a reference implementation for the Anthropic SKILL.md format and directory structure.

Inputs & outputs

You give it
Skill creation request
You get back
Skill structure guidance

When to use my-first-skill

  • Learn to build new agent skills
  • Test the OpenSkills loader
  • Review AI documentation patterns

About this skill

My First Skill

This is an example skill demonstrating the Anthropic SKILL.md format.

Purpose

This skill shows how to structure procedural guidance for AI coding agents using progressive disclosure.

When to Use

Load this skill when:

  • Learning how skills work
  • Testing the OpenSkills loader
  • Understanding the SKILL.md format

Instructions

To create a skill:

  1. Create a directory: mkdir my-skill/
  2. Add SKILL.md with YAML frontmatter:
    ---
    name: my-skill
    description: When to use this skill
    ---
    
  3. Write instructions in imperative form (not second person)
  4. Reference bundled resources as needed

Bundled Resources

For detailed information about the SKILL.md specification:

See references/skill-format.md

Best Practices

  • Write in imperative/infinitive form: "To do X, execute Y"
  • NOT second person: avoid "You should..."
  • Keep SKILL.md under 5,000 words
  • Move detailed content to references/
  • Use scripts/ for executable code
  • Use assets/ for templates and output files

Resource Resolution

When this skill is loaded, the base directory is provided:

Base directory: /path/to/my-first-skill

Relative paths resolve from base directory:

  • references/skill-format.md/path/to/my-first-skill/references/skill-format.md
  • scripts/helper.sh/path/to/my-first-skill/scripts/helper.sh

When not to use it

  • Complex data processing

Limitations

  • Example skill only

How it compares

It acts as a template for skill development rather than performing functional tasks.

Compared to similar skills

my-first-skill side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
my-first-skill (this skill)09moNo flagsBeginner
skill-creator1283moReviewAdvanced
openrouter199moReviewIntermediate
skill-development178moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

skill-creator

anthropics

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

128200

openrouter

rawveg

OpenRouter API - Unified access to 400+ AI models through one API

19178

skill-development

anthropics

This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.

17145

command-development

anthropics

This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.

16133

agent-identifier

anthropics

This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.

15122

prompt-engineering-patterns

wshobson

Master advanced prompt engineering techniques to maximize LLM performance, reliability, and controllability in production. Use when optimizing prompts, improving LLM outputs, or designing production prompt templates.

19116

Search skills

Search the agent skills registry