numman-ali
Install My First Skill
Pick your agent. Every command is ready to paste.
npx skills add numman-ali/openskillsThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads my-first-skill when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the my-first-skill skill”. In Codex, type $my-first-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:
- 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
Tips for My First Skill
- • Start a fresh session after installing so your agent picks up the new skill.
- • It bundles reference files. The agent reads them only when needed, so they cost no context until then.
- • If two skills overlap, mention the one you want by name.
Questions about My First Skill
What does the My First Skill skill do?
Example skill demonstrating Anthropic SKILL.md format. Load when learning to create skills or testing the OpenSkills loader.
How do I install My First Skill?
Run "npx skills add numman-ali/openskills" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does My First Skill work in Cursor and Codex?
Yes. My First Skill uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is My First Skill free?
My First Skill is open source on GitHub. It is free to install; check the license before commercial use.
Who made My First Skill?
My First Skill is published by numman-ali in the numman-ali/openskills repository.
