Skills: what they are, where to find them, how to install them.
A skill is a folder of instructions that your AI loads only when a task matches. It is the difference between asking for a nice website and getting your rules followed every time.
What you will learn
By the end of this chapter- 01Explain what a skill is, and how its description decides when it loads.
- 02Find skills from trusted sources and judge one before you install it.
- 03Install a skill for your tool and check that it loads.
- 04Write a small skill of your own with a
SKILL.mdfile.
01 · What a skill is
A folder with one required file
A skill is a folder named after the skill. The only required file is SKILL.md. Optional folders hold references, templates and scripts.
cinematic-scroll/
├── SKILL.md required: name, description, instructions
├── references/ optional: longer notes, read only when needed
├── assets/ optional: templates and files to copy
└── scripts/ optional: code the AI can runThe description decides when it loads
The AI reads each skill’s name and description first, and loads the full instructions only when your request matches. A vague description means the skill never fires. Say what it does and when to use it, with the words you would actually type.
It is an open format
Skills follow the Agent Skills specification. The name uses lowercase letters, numbers and hyphens (up to 64 characters) and must match the folder name. The description can run to 1,024 characters. Claude, Gemini CLI and Codex all read this layout.
02 · Where to find skills
Read before you installAnthropic’s repository
Working examples you can read and copy, including brand-guidelines, internal-comms, pdf and skill-creator. github.com/anthropics/skills
The Claude plugin marketplace
Inside Claude Code, add the official marketplace and install from it. Commands are in the install section below.
skills.sh
A directory by Vercel with a leaderboard, topics, supported agents and an audits section. It also provides the npx skills installer. skills.sh
Library authors
GSAP publishes its own skills for animation plugins. github.com/greensock/gsap-skills
Your own
The most reliable skill is the one that holds your rules. The last section of this chapter gives you a full one to copy.
scripts/ before you install a skill from someone you do not know. Prefer official repositories and authors with a track record, and treat a high install count as popularity, not as proof of safety.03 · Install a skill
Per platformClaude Code: copy a folder
Put the skill folder in your personal skills folder to use it in every project, or in the project to share it with a team. Claude Code watches these folders, so no restart is needed.
# personal
cp -r cinematic-scroll ~/.claude/skills/
# project only
mkdir -p .claude/skills && cp -r cinematic-scroll .claude/skills/Run it with /cinematic-scroll, or describe a task that matches its description.
Claude Code: from the marketplace
Plugins carry skills. Add a marketplace once, install what you want, then reload.
/plugin marketplace add anthropics/claude-plugins-official
/plugin install skill-creator@claude-plugins-official
/reload-pluginsclaude.ai: upload a zip
Turn on code execution and file creation, open the Skills section of your settings (the current docs call it Customize, then Skills), choose Upload skill and pick a zip. The zip must contain the skill folder itself at the top level, and the folder name must match the skill name. Available on Pro, Max, Team and Enterprise plans.
zip -r cinematic-scroll.zip cinematic-scroll/
unzip -l cinematic-scroll.zip # every line should start with cinematic-scroll/Sources: Claude Code skills, Using skills in Claude, Create custom skills
Copy a folder
Gemini CLI reads skills from your personal folder or from the project. The alias .agents/skills/ works too and wins over .gemini/skills/ inside the same scope.
# personal
cp -r cinematic-scroll ~/.gemini/skills/
# project only
mkdir -p .gemini/skills && cp -r cinematic-scroll .gemini/skills/Install from Git
Install a skill straight from a repository, then check that Gemini sees it.
gemini skills install <git-url> --consent/skills list
/skills reload
/skills disable <name>The first time a matching task runs, Gemini asks you to confirm before it loads the skill.
Source: a third-party guide, How to add skills to Gemini CLI. Commands can change, so run /skills list to confirm.
Codex CLI: copy a folder
Codex scans the project, the repository root and your home folder. Start a new session after installing.
# personal
mkdir -p ~/.agents/skills && cp -r cinematic-scroll ~/.agents/skills/
# project only
mkdir -p .agents/skills && cp -r cinematic-scroll .agents/skills/Run it with $cinematic-scroll or describe the task. Codex also ships $skill-creator and $skill-installer.
ChatGPT website: ask it to build one
Start a chat with “Build me a skill that…” and describe the task, inputs, steps, output format and quality checks. ChatGPT drafts the skill in a panel, you refine it and click Install. Use it later by letting ChatGPT pick it or by @-mentioning it. In the beta, workspace owners switch skills on in workspace settings.
Sources: OpenAI, Build skills, OpenAI Academy, Skills.
One installer for many agents
The npx skills tool downloads a skill and links it into the right folder for the agent you choose. It names Claude Code, Gemini CLI, Codex, GitHub Copilot and Cursor among 27 or more supported agents.
# every skill in a repository
npx skills add vercel-labs/agent-skills
# one skill
npx skills add vercel-labs/agent-skills --skill frontend-design
# for one agent
npx skills add vercel-labs/agent-skills -a codex
npx skills listSource: a third-party write-up of the Vercel skills CLI. Check the project’s own docs for the current flags.
04 · The skills for a cinematic site
What to look for| Job | What to search for | Why it helps |
|---|---|---|
| Design direction | frontend design, UI design | Pushes typography, colour and layout away from template defaults. |
| Scroll recipe | cinematic scroll, scrollytelling, parallax | Encodes smooth scroll, reveals and parallax rules, and what to avoid. |
| Animation library | GSAP, ScrollTrigger | Correct plugin usage. GSAP and its plugins are free to use since 2025, see the licence page. |
| 3D or particles | three.js, shaders, WebGL | Scene setup, points, shaders, interaction and performance. |
| Quality | accessibility review, skill creator | Checks contrast and keyboard use, and tests that your own skill actually triggers. |
This very site was built with three skills from the author’s own setup: an artifact-design skill for layout and theming rules, a motion-design skill for easing and spring principles, and a cinematic-scroll-website skill for the Lenis, reveal and parallax rules. Those names may not exist in your catalogue. Search skills.sh with the keywords in the table instead.
05 · Write your own
Copy this fileIf you cannot find a skill you trust, write one. This is a complete cinematic-scroll skill. Save it as cinematic-scroll/SKILL.md, then install the folder with any method above.
---
name: cinematic-scroll
description: Build or review a modern minimalist website with cinematic scrolling: smooth inertial scroll, parallax hero, scroll reveals and one pinned moment. Use when the user asks for a cinematic, scrollytelling, parallax or smooth-scroll site.
---
# Cinematic scroll
## Rules
1. Use Lenis for smooth scrolling and drive it from requestAnimationFrame.
2. The hero has two or three background layers with data-speed between 0.15 and 0.5.
3. Every section after the hero sits in normal document flow.
4. Reveal content once, with opacity and a small translateY, when it enters the viewport.
5. At most one pinned section per page: horizontal scroll or scrollytelling.
6. Never use scroll-snap-type: y mandatory or fullscreen slides.
7. Honour prefers-reduced-motion: no smooth scroll, no parallax, no reveal movement.
8. Never invent statistics, testimonials or customer logos.
## Process
1. Ask for the subject, the audience and the one action the visitor should take.
2. Propose the section list and wait for approval before writing code.
3. Build with plain HTML, CSS and JavaScript in three files unless told otherwise.
4. Serve over HTTP, then check 375, 768 and 1440 px widths.
5. Report what was tested and what was not.Check that it loads
Ask your AI “Which skills do you have?” or use /skills list in Gemini CLI. Then send a request that should trigger it, such as “Build a smooth-scroll site with a parallax hero”. If it does not fire, rewrite the description with the words you used.
Practice · Work with AI
The same task in your toolAsk the tool what it already knows, then let it write your first skill while you review the file.
Open a terminal in the project folder and run claude. Press Shift+Tab until plan mode is on, paste the prompt, read the plan, then approve it. Project rules go in CLAUDE.md.
Which skills are loaded
List the skills you can use in this session, with one line on when each one loads. Do not run any of them.Write a skill
Create a skill named scroll-motion-rules in .claude/skills/. Its SKILL.md needs a name and a description saying it applies when building or reviewing scroll animation. The body lists these rules: animate only transform and opacity; every effect has a still version under prefers-reduced-motion; hide content only under a .js class; reveals rise 24px over 0.9s with cubic-bezier(.2,.7,.2,1), once. Show me the file before you save it.Open a terminal in the project folder and run gemini; the first time, it asks whether you trust the folder, so say yes for your project. Paste the prompt. Gemini CLI asks before it edits a file or runs a command: read each request before you accept it. Project rules go in GEMINI.md.
Which skills are loaded
List the skills you can use in this session, with one line on when each one loads. Do not run any of them.Write a skill
Create a skill named scroll-motion-rules in .gemini/skills/. Its SKILL.md needs a name and a description saying it applies when building or reviewing scroll animation. The body lists these rules: animate only transform and opacity; every effect has a still version under prefers-reduced-motion; hide content only under a .js class; reveals rise 24px over 0.9s with cubic-bezier(.2,.7,.2,1), once. Show me the file before you save it.Open a terminal in the project folder and run codex, then paste the prompt and approve each change. In the ChatGPT app without Codex, attach the files, paste the prompt and copy the changes back yourself. Project rules go in AGENTS.md.
Which skills are loaded
List the skills you can use in this session, with one line on when each one loads. Do not run any of them.Write a skill
Create a skill named scroll-motion-rules in .agents/skills/. Its SKILL.md needs a name and a description saying it applies when building or reviewing scroll animation. The body lists these rules: animate only transform and opacity; every effect has a still version under prefers-reduced-motion; hide content only under a .js class; reveals rise 24px over 0.9s with cubic-bezier(.2,.7,.2,1), once. Show me the file before you save it.Practice · Exercises
Try first, then compareRewrite a description
Open the SKILL.md of a skill you installed. Rewrite its description as one sentence that says what it does and when it should load.
Hint: the model reads only the description to decide whether to open the rest.
Show the solution
A good description names the task and the trigger words a person would use, for example: “Builds minimalist scroll animation. Use when adding reveals, parallax, pinned sections or smooth scrolling to a web page.”
Make it load
Ask your AI for a reveal animation without naming your skill. Check whether it followed your rules.
Hint: if it did not, the description probably does not match how you asked.
Show the solution
Ask “Which skills did you use for that?”. If yours is missing, add the words you actually used (reveal, scroll, animation) to its description and try again in a new session.
Audit before installing
Pick a third-party skill. Before installing it, read every file in its folder and write down anything you would not want it to do.
Hint: look beyond SKILL.md: scripts and reference files count too.
Show the solution
Look for scripts that run shell commands, network requests, and instructions that have nothing to do with the description. A skill runs with your tool’s permissions, so install only what you have read and understood.
Practice · Course project
One site, built across the courseGive the course project its own rules for motion, so every later step follows them without being reminded.
- Install one design skill from section 04 for your tool.
- Add your own
scroll-motion-rulesskill to the project, using the file below. - Ask your AI which skills it would use to build the hero for [subject], and keep its answer in
notes.md.
---
name: scroll-motion-rules
description: Rules for scroll animation on this site. Use when adding or reviewing reveals, parallax, pinned sections or smooth scrolling.
---
# Scroll motion rules
- Animate only transform and opacity.
- Every effect has a still version under prefers-reduced-motion.
- Hide content only under a .js class, so nothing is lost if a script fails.
- Reveals rise 24px over 0.9s with cubic-bezier(.2, .7, .2, 1), once.Practice · Test it
Check the result- The skill folder holds a
SKILL.mdwhose frontmatter has a name and a description. - Asked which skills it can use, your AI names
scroll-motion-rules. - A reveal it writes animates only transform and opacity and has a reduced-motion rule.
Practice · Assessment
Acceptance criteria0 of 4 criteria met