Create your first SKILL.md: start with meeting notes

6 min readSkillshop operator and creator of the Maker Evan YouTube channel

Translated from Korean. View original

A good first skill starts with a small task you repeatedly request. In this exercise, you will create a skill that separates meeting notes into decisions and action items. Assuming Claude Code is installed, save one text file, invoke it and check whether it handles missing information correctly.

Illustration of task instructions and reference material in a folder
Skills can hold both instructions and reference materials. This is an AI-generated illustration.

What should I decide first?

Decide what the finished result should contain. Here it has three sections: decisions, action items and things to check. If an owner or deadline is missing from the note, mark it as undecided rather than inventing one.

This exercise does not include transcribing a meeting, adding calendar events or sending team messages. First check that the notes are organized as intended; that makes it clearer what to revise.

Where do I save the file?

To use this skill for a Claude Code project, create .claude/skills/meeting-note inside the project and save the file there as SKILL.md. If you use a notes app, save plain text and check that .txt was not appended to the filename.

In the folder diagram below, SKILL.md is a file and the rest are folders. If a file already exists, do not overwrite it; practice in a differently named skill folder.

  • My project
  • .claude
  • skills
  • meeting-note
  • SKILL.mdSave the example below here.
The folder structure for this project's meeting-note skill.

What goes in SKILL.md?

Paste the example below into the file, starting with the opening ---. The name matches the example folder, and the description explains when to use it.

---
name: meeting-note
description: Organize meeting notes into decisions and action items. Use when asked to organize minutes or extract owners and deadlines.
---

# Organize meeting notes

Use only the supplied notes as evidence and organize the result in Korean.
1. Write decisions, action items and things to check, in that order.
2. Include the task, owner and deadline for each action item.
3. Mark owners and deadlines absent from the notes as undecided.
4. Distinguish proposals from confirmed decisions.
5. Do not create calendar events or send messages.
Anthropic's English documentation showing how to create a first skill
The official documentation explains creating a folder and SKILL.md using a change-summary skill. It is different from the meeting-note example above.Source: Claude Code documentation
Open full-size image (opens in a new tab)
View original Korean screenshot
Anthropic 공식 문서의 첫 스킬 생성과 SKILL.md 작성 예시
공식 문서에서는 변경 사항 요약을 예로 들어 폴더와 SKILL.md 작성을 설명해요. 위 실습의 회의록 예시와는 다른 스킬이에요.출처: Anthropic 스킬 만들기 문서

How do I run it for the first time?

Open Claude Code in the project and try the request below. Naming the skill explicitly lets you check automatic selection separately from the quality of its output.

/meeting-note Please organize these notes: We decided to launch the new introduction page on Friday. Jisu will draft the copy by Thursday. The person responsible for images is not decided. We will discuss the English page again at the next meeting.

A good result lists the page launch as a decision and Jisu's draft as an action item. It must not present the image owner or English page as already decided.

What should I fix if the result is not right?

Point out one incorrect detail instead of asking it to ‘organize better.’ If it listed the English page as a confirmed date, for example, change the instruction to say that topics for the next meeting are not decisions.

Then try both the same note and a new one. This lets you check whether the skill applies the same criteria to new material rather than appearing to memorize one example.

Frequently asked questions

Q. Must SKILL.md be written in English? A. You can write the procedure in Korean. Keep the filename and configuration field names unchanged.

Q. Does creating a skill guarantee accurate meeting notes? A. No. In particular, compare owners, dates and decision status with the original. The goal of this exercise is to make the review criteria consistent.