Note: This repository contains Necessity's implementation of skills for Claude. For information about the Agent Skills standard, see agentskills.io.
Skills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks. Skills teach Claude how to complete specific tasks in a repeatable way, whether that's creating documents with your company's brand guidelines, analyzing data using your organization's specific workflows, or automating personal tasks.
For more information, check out:
- What are skills?
- Using skills in Claude
- How to create custom skills
- Equipping agents for the real world with Agent Skills
Skills in this repo live under ./skills, each self-contained in its own folder with a SKILL.md file (Claude instructions) and a README.md file (human-facing overview).
Unstable work lives under ./skills/experimental/<skill-name>/ with the same SKILL.md + README.md layout.
- ./skills: Necessity skills (each skill:
SKILL.md+README.md) - ./skills/experimental: Experimental staging area
- ./spec: The Agent Skills specification
- ./template: Skill template (
SKILL.md+README.md)
You can register this repository as a Claude Code Plugin marketplace by running the following command in Claude Code:
/plugin marketplace add iamallyouneed/skills
Then, to install a specific set of skills:
- Select
Browse and install plugins - Select
necessity-agent-skills - Select
example-skills - Select
Install now
Alternatively, directly install the Plugin via:
/plugin install example-skills@necessity-agent-skills
To use any skill from this repository or upload custom skills, follow the instructions in Using skills in Claude.
You can upload custom skills via the Claude API. See the Skills API Quickstart for more.
Skills are simple to create — just a folder with a SKILL.md file containing YAML frontmatter and instructions. You can use the template-skill in this repository as a starting point:
---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---
# My Skill Name
[Add your instructions here that Claude will follow when this skill is active]
## Examples
- Example usage 1
- Example usage 2
## Guidelines
- Guideline 1
- Guideline 2
The frontmatter requires only two fields:
-
name— A unique identifier for your skill (lowercase, hyphens for spaces) -
description— A complete description of what the skill does and when to use it
The markdown content below contains the instructions, examples, and guidelines that Claude will follow. For more details, see How to create custom skills.