mcpField
M
my-first-skill

my-first-skill

github.com/numman-aliAgent workflows10.8k52 installsUpdated 40w ago
Repository

About my-first-skill

An example skill for AI coding agents that demonstrates the Anthropic SKILL.md format and progressive disclosure. It guides readers through structuring procedural instructions and supporting resources.

Key features

  1. 01SKILL.md structure guidance
  2. 02YAML frontmatter example
  3. 03Progressive disclosure approach
  4. 04Bundled resource guidance

Use cases

  1. 01Learning how agent skills are structured
  2. 02Testing the OpenSkills loader
  3. 03Organizing detailed instructions and resources

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/numman-ali/openskills --skill my-first-skill

After installing, type/my-first-skillin Claude Code to confirm it loaded.

Bundled filesreferences/skill-format.md

Details

From the project README

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

Comments

Markdown supported