# Build an agent skill

- Link: https://arqiv.si/teachers/build-an-agent-skill/
- Published: 2026-10-13T08:15:17-04:00
- Author: Steven Ryan

[Skip to content](https://arqiv.si/teachers/build-an-agent-skill/#main-content)

[arqiv](https://arqiv.si/)

[For educators](https://arqiv.si/teachers/)

Teach

 * [Start here](https://arqiv.si/teachers/)
 * [Lessons & printable kits](https://arqiv.si/teachers/resources/)
 * [Classroom labs](https://arqiv.si/teachers/labs/)
 * [Free 20-minute lesson](https://arqiv.si/teachers/free-ai-lesson/)

Plan

 * [Curriculum guide](https://arqiv.si/teachers/curriculum/)
 * [AI Learning Center](https://arqiv.si/teachers/ai-literacy/)
 * [Future of work unit](https://arqiv.si/future-of-work/)
 * [What the research says](https://arqiv.si/teachers/what-works/)
 * [AI education worldwide](https://arqiv.si/teachers/around-the-world/)

Understand

 * [Think First method](https://arqiv.si/teachers/think-first/)
 * [Our approach](https://arqiv.si/research/#our-method)
 * [AI vocabulary](https://arqiv.si/teachers/ai-vocabulary/)

By role

 * [Counselors](https://arqiv.si/counselors/)
 * [School leaders & PD](https://arqiv.si/schools/)
 * [Speaking & workshops](https://arqiv.si/speaking/)
 * [Products](https://arqiv.si/products/)

[Learn AI](https://arqiv.si/ai/topics/)

Start

 * [All AI topics](https://arqiv.si/ai/topics/)
 * [The AI journey, from zero](https://arqiv.si/ai/)
 * [Using AI well](https://arqiv.si/ai/talking-to-ai/)
 * [AI builds](https://arqiv.si/ai-builds/)

AI in the world

 * [Space](https://arqiv.si/space/)
 * [Weather](https://arqiv.si/weather/)
 * [Health](https://arqiv.si/health/)
 * [Engineering](https://arqiv.si/engineering/)
 * [Farming](https://arqiv.si/farming/)
 * [Quantum](https://arqiv.si/quantum/)

What it means

 * [Future of work](https://arqiv.si/future-of-work/)
 * [Your AI path](https://arqiv.si/ai/your-path/)
 * [Research, explained](https://arqiv.si/research/)

[Games & labs](https://arqiv.si/games/)[Research](https://arqiv.si/research/)[Blog](https://arqiv.si/blog/)
[About](https://arqiv.si/about/)

[Search or ask](https://arqiv.si/ai/topics/)[Newsletter](https://arqiv.si/newsletter/)
[ARQIV.FM ↗](https://arqiv.fm/)

Menu

For educators

[For educators: start page →](https://arqiv.si/teachers/)

Teach

 * [Start here](https://arqiv.si/teachers/)
 * [Lessons & printable kits](https://arqiv.si/teachers/resources/)
 * [Classroom labs](https://arqiv.si/teachers/labs/)
 * [Free 20-minute lesson](https://arqiv.si/teachers/free-ai-lesson/)

Plan

 * [Curriculum guide](https://arqiv.si/teachers/curriculum/)
 * [AI Learning Center](https://arqiv.si/teachers/ai-literacy/)
 * [Future of work unit](https://arqiv.si/future-of-work/)
 * [What the research says](https://arqiv.si/teachers/what-works/)
 * [AI education worldwide](https://arqiv.si/teachers/around-the-world/)

Understand

 * [Think First method](https://arqiv.si/teachers/think-first/)
 * [Our approach](https://arqiv.si/research/#our-method)
 * [AI vocabulary](https://arqiv.si/teachers/ai-vocabulary/)

By role

 * [Counselors](https://arqiv.si/counselors/)
 * [School leaders & PD](https://arqiv.si/schools/)
 * [Speaking & workshops](https://arqiv.si/speaking/)
 * [Products](https://arqiv.si/products/)

Learn AI

[Learn AI: start page →](https://arqiv.si/ai/topics/)

Start

 * [All AI topics](https://arqiv.si/ai/topics/)
 * [The AI journey, from zero](https://arqiv.si/ai/)
 * [Using AI well](https://arqiv.si/ai/talking-to-ai/)
 * [AI builds](https://arqiv.si/ai-builds/)

AI in the world

 * [Space](https://arqiv.si/space/)
 * [Weather](https://arqiv.si/weather/)
 * [Health](https://arqiv.si/health/)
 * [Engineering](https://arqiv.si/engineering/)
 * [Farming](https://arqiv.si/farming/)
 * [Quantum](https://arqiv.si/quantum/)

What it means

 * [Future of work](https://arqiv.si/future-of-work/)
 * [Your AI path](https://arqiv.si/ai/your-path/)
 * [Research, explained](https://arqiv.si/research/)

 * [Games & labs](https://arqiv.si/games/)
 * [Research](https://arqiv.si/research/)
 * [Blog](https://arqiv.si/blog/)
 * [About](https://arqiv.si/about/)

[Get the newsletter](https://arqiv.si/newsletter/)

[Start here](https://arqiv.si/teachers/)[Lessons & kits](https://arqiv.si/teachers/resources/)
[Curriculum](https://arqiv.si/teachers/curriculum/)[Labs](https://arqiv.si/teachers/labs/)
[Think First](https://arqiv.si/teachers/think-first/)[AI vocabulary](https://arqiv.si/teachers/ai-vocabulary/)
[For schools](https://arqiv.si/schools/)[Counselors](https://arqiv.si/counselors/)

Lesson · AI literacy · Writing and procedures

# Build an _agent skill_

An agent skill is a set of written instructions an AI agent follows for one kind
of job. This page has two parts: a skill builder for your own planning, and a 45-
minute lesson in which students write a skill on paper and a partner tests it by
acting as the agent.

**Level 1** AI after thinkingGrades 7–1245 minutesELA · CS · SciencePaper only (
AI demo optional)

[Open the skill builder](https://arqiv.si/teachers/build-an-agent-skill/#builder)

The big idea

### An agent follows the instructions you wrote, even where they differ from what you meant. Clear writing becomes a working tool.

**Students will be able to, without AI:**

 * Write a skill with a name, a description that says when to use it, steps and 
   rules
 * Test written instructions by having a partner follow them literally
 * Revise instructions using evidence from a test
 * Explain which rules must be enforced by code rather than requested in writing

Part 1 · For you

## The teacher _skill builder_

Turn a job you repeat every week into a skill. It works in your browser, needs no
account and saves nothing. Use “Classroom lesson” mode to show students a worked
example on the projector.

Builder

### Write, check and print a skill

Pick a starting point, change it to fit your class, write a short test plan, then
download the file or print it as a card.

1 · NameShort, lowercase, words joined by hyphens. Example: exit-tickets

2 · Description: what it does and when to use itThe agent reads only this line to
decide whether to open your skill. Include “Use when …”.

3 · Steps, one per line

4 · Rules and checks, one per lineLimits, things never to do, and when to ask instead
of guessing.

5 · An example request (optional)

Test plan · not part of the file

Three requests that _should_ use it

One request that should _not_ use itThe “should not” request tests whether your 
description is too broad.

my-skill/SKILL.mdlive preview

Quality and privacy checks

The interactive builder needs JavaScript. A skill is a folder containing a file 
named SKILL.md. Copy this example and change it for your class:

    ```prompt
    ---
    name: exit-tickets
    description: Writes three exit-ticket questions, with expected answers and a likely misconception, from a lesson objective. Use when a teacher shares a lesson objective, plan or notes and asks for exit tickets, a quick check or end-of-class questions.
    ---

    # Exit tickets from a lesson objective

    ## Steps
    1. Restate the objective in one plain sentence. If no grade level is given, ask for it.
    2. Write three questions: one to recall, one to apply, one that asks students to explain their thinking.
    3. Under each question, give a short expected answer and one likely misconception.
    4. Keep the reading level at or below the grade given.

    ## Rules
    - Short-answer questions unless multiple choice is asked for.
    - Never include student names, grades or any student information.
    - If the objective is too broad for three questions, say so and suggest how to narrow it.
    ```

Use your skill

### Three ways to try it

 1. Press **Download .zip**.
 2. In Claude on the web or desktop, turn on **code execution** in Settings (under 
    Capabilities). Skills need it.
 3. Open **Customize → Skills**, press **+**, choose **Upload a skill** and pick the.
    zip.
 4. Start a new chat and try the four requests from your test plan.

Menu names have moved before; if you cannot find them, search the Claude help center
for “use skills in Claude.” On a school account, your district may control which
skills are allowed.

Before you use one

### Three ground rules

 * **No student data in a skill.** Names, grades, IEP or 504 details, health information
   and contact details never belong in the file. The privacy check above flags common
   ones, but it cannot catch everything.
 * **Follow your school’s AI policy.** Use the tools and accounts your district 
   has approved, and do not paste student work into a tool that is not approved 
   for it.
 * **Read before you install.** Skills can contain scripts. Only install skills 
   you wrote or that come from people you trust, and read every file first.

Part 2 · Lesson flow · the 5 P’s

## Write it. _Test it on a person._

No student uses an AI tool in this lesson. Partners play the agent, which makes 
every unclear step visible. Claude’s apps are for adults 18 and over, and most AI
tools set age limits, so the optional demo runs on the teacher’s screen. [How the 5 P’s work →](https://arqiv.si/teachers/think-first/)

1

### Ponder

8 min○ Screens off · paper only

Read one vague instruction aloud: “Make a study guide.” Ask two volunteers to describe,
without talking to each other, exactly what they would make.

 1. Compare the two answers. How long? What goes in? What stays out? What if the notes
    are messy?
 2. Explain that an AI agent faces the same problem. A **skill** is a reusable instruction
    card for one job, with a label that tells the agent when to pull it out.
 3. Show the four parts on the board: **name**, **description** (what it does and when
    to use it), **steps**, **rules**.

Say to students“An agent will do exactly what your card says, and nothing you only
meant. Today you write the card and a classmate plays the agent.”

2

### Plan

12 min○ Screens off · paper only

Each student chooses a job from the worksheet (study guide, lab report check, science
news summary, or one of their own) and writes the skill.

 1. **Name** and **description**, including “Use when …”.
 2. Three to five **steps** someone could follow without asking questions.
 3. Two **rules**. One must say when to ask instead of guessing.
 4. A **test plan**: three requests that should use the skill and one that should not.

Say to students“The description is the only line the agent always reads. If it is
vague, your skill never gets used, or gets used at the wrong time.”

3

### Partner

10 min● Optional AI demo · teacher screen

Partners swap worksheets and play the agent. They must follow the card **literally**.

 1. **Choose or skip:** reading only the name and description, decide for each of the
    four test requests whether you would open this skill. Record yes or no in the test
    log.
 2. **Follow the steps:** talk through each step out loud as if doing the job. Put 
    a **?** next to any step where you had to guess.
 3. **Optional demo:** with a volunteer’s permission, type their skill into the builder
    on your projector, upload it to your own AI account, and run their four test requests
    live. Compare what the AI did with what the partner did.

Test log example Request: “Write my lab report for me.” Should use the skill? No
Partner opened it? Yes. Why: the description says “lab report”. Fix: add “Do not
use to write a report; only to check one.”

4

### Probe

10 min○ Screens off · paper only

Partners return the sheets. Each student revises using the evidence in their test
log.

 1. Fix the description for every request that was wrongly opened or wrongly skipped.
 2. Rewrite every step marked **?** so nobody would have to guess.
 3. In the revision box, write what you changed and which test result made you change
    it.
 4. Whole class, two minutes: name a job that should **never** be given to an agent
    skill, and say why.

5

### Prove

5 min○ Screens off · paper only

Exit ticket, on the worksheet, without help.

 1. Why does a skill’s description matter more than any other line?
 2. Name one rule from your skill that should be enforced by code (a **hook**) rather
    than just written as an instruction, and explain why.
 3. **Teacher key:** (1) The agent always sees the description and uses it to decide
    whether to open the skill; the rest is read only if it does. (2) Any rule that 
    must never be broken, such as never sending student information outside the school.
    Written instructions can be misread, forgotten in a long job or overridden by planted
    text; a hook runs the same way every time.

Printable

## Student _worksheet_

Two pages, one per student. Everything students hand in is handwritten, and the 
test log is filled in by a partner, so the thinking is visible.

### Write a skill for an AI agent

An agent follows your card exactly. Make it impossible to misunderstand.

Name:Date:Partner:

**Choose a job (circle one)**

**Study guide maker:** turns class notes into a one-page study guide.

**Lab report checker:** lists which required parts are missing, without rewriting.

**Science news summary:** what was found, how, and why it matters, in three sentences.

**My own job:** ____________________________

**1 · Name**_Short, lowercase, words joined by hyphens, like study-guide_

**2 · Description: what it does, and “Use when …”**

**3 · Steps**_Number them. Each step should be clear enough that nobody has to guess._

**4 · Rules**_One rule must say when to ask instead of guessing._

**5 · Test plan**

_Should use my skill_

_Should NOT use my skill_

**6 · Test log (your partner fills this in)**_Read only the name and description
to decide. Then follow the steps exactly; mark a ? where you had to guess._

| Request | Should use it? | Partner opened it? | Why | 
|  | Yes |  |  | 
|  | Yes |  |  | 
|  | Yes |  |  | 
|  | No |  |  |

**7 · Steps marked ? (partner)**

**8 · My revision: what I changed and which test result made me change it**

**9 · Exit ticket: why does the description matter more than any other line?**

**10 · Exit ticket: which of your rules should be enforced by code (a hook), and
why?**

Assessment

## Grade the _instructions and the testing_

Every row scores something students did themselves, in class. An AI could draft 
a skill; it cannot produce a partner’s test log or a revision based on it.

| Criteria | 4 · Excellent | 3 · Solid | 2 · Developing | 1 · Beginning | 
| Description | Says what it does and exactly when to use it; the partner chose correctly on all four requests | Says what and when; one wrong choice | Says what but not when | Missing or vague | 
| Steps | A partner could follow every step without guessing | One step needed a guess | Several steps needed guesses | Steps missing or out of order | 
| Rules and judgment | Clear limits, an “ask instead of guessing” rule, and no private information | Two useful rules | One vague rule | No rules | 
| Testing and revision | Every change is tied to a specific test result | Changes made, mostly linked to results | Changes made without evidence | No revision | 
| Explanation (exit ticket) | Explains the description’s role and picks a rule that truly needs a hook, with a reason | Both answers correct, reasons thin | One answer correct | Missing |

Why this is hard to cheat

The skill, the test log and the revision are written by hand in class. The test 
log comes from a classmate reading the card, so the revision has to answer real 
evidence. An AI-written skill would still have to survive a partner’s literal reading.

Adjust it

**Grades 7–8:** Give students one of the starter skills from the builder with two
steps left blank, and test with two requests instead of four.

**Grades 11–12:** Add a column to the test log: “Which rule should be a hook?” Or
compare a student skill with one Claude drafts on the teacher’s screen.

**No devices at all?** Already device-free. Skip the optional demo.

**Devices available?** Students may type their card into the builder in “Classroom
lesson” mode and print it. It runs in the browser, needs no account and saves nothing.

Discussion questions

 * Which jobs should never be handed to an agent, however good the instructions?
   Who decides?
 * If an agent follows a badly written skill and something goes wrong, who is responsible?
 * How is writing a skill like writing a recipe, a lab procedure or a substitute-
   teacher plan?
 * Why test with a request that should _not_ use the skill?

Extensions & connections

 * Background for you or older students: [How AI agents are built](https://arqiv.si/ai/how-agents-are-built/),
   especially Lab 5 (skill, connector or helpers?) and Lab 6 (be the hook).
 * Words to know: [agent skill](https://arqiv.si/teachers/ai-vocabulary/#agent-skill),
   [hook](https://arqiv.si/teachers/ai-vocabulary/#agent-hook), [prompt injection](https://arqiv.si/teachers/ai-vocabulary/#prompt-injection).
 * Careers: technical writers, process designers and safety engineers write instructions
   that others must follow exactly.

[← Background**How AI agents are built**](https://arqiv.si/ai/how-agents-are-built/)
[More for teachers →**Printable classroom resources**](https://arqiv.si/teachers/resources/)

Put curiosity to work

## Read it. Try it. Question it.

Every ARQIV lesson keeps the thinking on paper and puts AI in its place.

[The Think-First guide →](https://arqiv.si/teachers/think-first/)[AI words, explained →](https://arqiv.si/teachers/ai-vocabulary/)

Written by ARQIV, October 2026. Initial edition, not yet classroom-piloted; [tell us](https://arqiv.si/teachers/build-an-agent-skill/info@arqiv.fm?subject=Build%20an%20agent%20skill%20lesson)
how it goes.

[arqiv](https://arqiv.si/)

A little understanding changes everything.

[LISTEN: ARQIV.FM, OUR WEEKLY SHOW ↗](https://arqiv.fm/)

Educators

 * [Start here](https://arqiv.si/teachers/)
 * [Lessons & kits](https://arqiv.si/teachers/resources/)
 * [Curriculum](https://arqiv.si/teachers/curriculum/)
 * [Labs](https://arqiv.si/teachers/labs/)
 * [AI vocabulary](https://arqiv.si/teachers/ai-vocabulary/)

For your role

 * [Counselors](https://arqiv.si/counselors/)
 * [School leaders & PD](https://arqiv.si/schools/)
 * [Speaking & workshops](https://arqiv.si/speaking/)
 * [Products](https://arqiv.si/products/)

Learn

 * [Learn AI](https://arqiv.si/ai/topics/)
 * [Games & labs](https://arqiv.si/games/)
 * [Future of work](https://arqiv.si/future-of-work/)
 * [Research](https://arqiv.si/research/)
 * [Headlines](https://arqiv.si/news/)

ARQIV

 * [About & corrections](https://arqiv.si/about/)
 * [Our approach](https://arqiv.si/research/#our-method)
 * [Newsletter](https://arqiv.si/newsletter/)
 * [Privacy](https://arqiv.si/privacy-policy/)
 * [Get in touch](https://arqiv.si/teachers/build-an-agent-skill/info@arqiv.fm)

Classroom activities collect no student data.[info@arqiv.fm](https://arqiv.si/teachers/build-an-agent-skill/info@arqiv.fm)
