my-first-skill
Example skill demonstrating Anthropic SKILL.md format. Load when learning to create skills or testing the OpenSkills loader.
How do I install this agent skill?
npx skills add https://github.com/numman-ali/openskills --skill my-first-skillIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a safe educational template for creating and understanding the SKILL.md format. It contains documentation and instructions without any executable code, network operations, or sensitive data access.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/2 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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:
- Create a directory:
mkdir my-skill/ - Add SKILL.md with YAML frontmatter:
--- name: my-skill description: When to use this skill --- - Write instructions in imperative form (not second person)
- 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.mdscripts/helper.sh→/path/to/my-first-skill/scripts/helper.sh
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/numman-ali/openskills/my-first-skill">View my-first-skill on skillZs</a>