Scrollcraft
Chapter 2 of 15RO

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.

Chapter 2 of 156 min read

What you will learn

By the end of this chapter
  1. 01Explain what a skill is, and how its description decides when it loads.
  2. 02Find skills from trusted sources and judge one before you install it.
  3. 03Install a skill for your tool and check that it loads.
  4. 04Write a small skill of your own with a SKILL.md file.

01 · What a skill is

a

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.

text
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 run
b

The 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.

c

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 install

Anthropic’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.

A skill can include scripts that your AI runs on your machine. Open the SKILL.md and any file in 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 platform
A

Claude 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.

bash
# 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.

B

Claude Code: from the marketplace

Plugins carry skills. Add a marketplace once, install what you want, then reload.

inside Claude Code
/plugin marketplace add anthropics/claude-plugins-official
/plugin install skill-creator@claude-plugins-official
/reload-plugins
C

claude.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.

bash
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

Any

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.

bash
# 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 list

Source: 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
JobWhat to search forWhy it helps
Design directionfrontend design, UI designPushes typography, colour and layout away from template defaults.
Scroll recipecinematic scroll, scrollytelling, parallaxEncodes smooth scroll, reveals and parallax rules, and what to avoid.
Animation libraryGSAP, ScrollTriggerCorrect plugin usage. GSAP and its plugins are free to use since 2025, see the licence page.
3D or particlesthree.js, shaders, WebGLScene setup, points, shaders, interaction and performance.
Qualityaccessibility review, skill creatorChecks 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 file

If 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.

SKILL.md
---
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.
Test

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 tool

Ask 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

Prompt
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

Prompt
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.

Practice · Exercises

Try first, then compare
1

Rewrite 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.”

2

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.

3

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 course

Give the course project its own rules for motion, so every later step follows them without being reminded.

  1. Install one design skill from section 04 for your tool.
  2. Add your own scroll-motion-rules skill to the project, using the file below.
  3. Ask your AI which skills it would use to build the hero for [subject], and keep its answer in notes.md.
SKILL.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.md whose 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 criteria

0 of 4 criteria met

Next Prompting

A five-part brief, a worked before and after, a project rules file and six steering patterns.

Keyboard shortcuts: [ previous chapter · ] next chapter