Build Your First Skill — Have Claude Flag Only the Emails That Matter
What this project is
Give Claude read-only access to your inbox (a "tool"), then create a reusable "skill" — a saved set of instructions with your own rules for what counts as important — so you can ask "what important emails came in?" and get a focused answer any time. Along the way you'll see exactly why an AI needs both the ability to act and instructions about what to do.
Capabilities gained
- Connecting a read-only tool (your email) so Claude can see real information, not just talk about it
- Writing a skill — reusable instructions Claude follows the same way every time — and defining your own criteria for what matters
- Seeing that a skill is just an editable file: you can open it, read it, and change the rules whenever you want
Where else this applies
- Turning any repeatable "check this and tell me X" chore into a one-line request
- Building skills for other jobs — summarizing a client folder, drafting standard replies, weekly reporting
- Understanding what every AI "agent" is really made of, so you can judge or build one
Copy-paste build prompt
I've connected my Gmail with read-only access, and I want to create a reusable Skill that checks my inbox and tells me only about important emails. First, ask me what counts as "important" to me — for example specific senders, topics, words like "invoice" or "urgent," or anything time-sensitive. Ask a couple of quick questions to pin down my criteria. Then create the Skill: write the skill.md with a clear name and description, and instructions that tell you to scan my recent unread emails, judge each one against my criteria, and report back only the important ones — each with the sender, subject, why it's important, and what (if anything) it needs from me. Keep it strictly read-only: never send, delete, or change anything. Show me the skill.md so I can review and tweak it before I save it.
Copy-paste explanation prompt
Now explain what we just built, in plain language. What's the difference between the "tool" (my Gmail connection) and the "skill" (the instructions you just wrote)? Why do you need both — what happens if you have the tool but no skill, or the skill but no tool? And since the skill is just a saved file, what does that let me do later? Keep it short and beginner-friendly.
What’s going on
- You give Claude read-only access to your email — that's the "tool"
- You tell Claude your personal rules for what makes an email important — that's the context
- Claude packages those rules into a reusable Skill (a file) and you review it
- You save the skill, then ask Claude to run it and flag your important emails
- You open the saved skill under Customize → Skills and see it's a file you can edit anytime
Step-by-step instructions
Step 1 — Go to claude.ai and sign in.
Step 2 — Connect your email. Open Settings → Connectors (on some accounts it's under Customize → Connectors), find Gmail, and click Connect. Google's screen will ask you to approve access — it lists reading your mail and managing drafts. That's expected: Claude can read and draft, but it cannot send or delete emails on its own — you always send manually in Gmail. Approve to connect.
You should now see Gmail marked as connected. (Optional: click the connected Gmail connector to see its tools — this mission only uses the read tools; you can leave any draft/write tools set to ask first. Nothing here can send or delete your mail.)
Step 3 — Start a new chat and paste the build prompt above. Answer Claude's questions about what "important" means to you.
You should now see Claude ask about your criteria, then write a skill.md — a short file with a name, a description, and your rules.
Step 4 — Read the skill it wrote. If a rule is off, just say so ("also flag anything from my accountant") and it'll update the file. When it looks right, save it as a Skill — it lives under Customize → Skills.
You should now see your new skill saved at claude.ai/customize/skills.
Step 5 — In a new chat, ask: "Use my important-email skill and tell me what needs my attention."
You should now see Claude actually read your recent emails and report back only the ones that match your rules — sender, subject, and why each matters.
Step 6 — Open Customize → Skills and click your skill. Notice it's just a file — the name, description, and rules you set.
You should now see you can edit those rules anytime. That's the whole lesson: the tool let Claude reach your email, the skill told it what to do, and because the skill is a file, the workflow is yours to keep and change.