Mastering Claude (Anthropic)Claude Code, connectors and Skills · Lesson 15 of 20

Skills and plugins: package your expertise for Claude

Article · 15 min · 8 min lecture

Video lecture

Skills and plugins: package your expertise for Claude

14 chapters · about 8 min · full transcript

Coming soon

Chapter 1 of 14

Skills and plugins

  • Package your know-how
  • Load it only when needed

The narrated lecture is in production

Every chapter is scripted and ready. Browse the chapters and read the full transcript now — the video will appear here when it’s published.

Chapters

The problem Skills solve

Project instructions are great for rules, but some work needs a procedure: your monthly reporting method, your brand's creative-review checklist, the exact way your firm formats a proposal, a script that builds a branded PowerPoint. Pasting long procedures into every chat wastes context and gets inconsistent.

Agent Skills (usually just "Skills") are folders of instructions, and optionally scripts and resources, that Claude loads only when a task needs them. At the start, Claude sees only each skill's short name and description; when your request matches, it reads the full instructions (and runs any bundled scripts where code execution is available). This "progressive disclosure" means you can have many skills installed without cluttering every conversation.

Skills work across Claude apps (Free and paid plans), Claude Code and the Claude API. Anthropic provides built-in skills (for example, for creating Word, Excel, PowerPoint and PDF files), and you can create your own.

Anatomy of a skill

A skill is a folder with a SKILL.md file. The top of the file has YAML front matter with a name and a description; the description is what Claude uses to decide when to load it, so make it specific.

---
name: creative-review
description: Review ad creatives, social posts and landing-page screenshots against Noor Organics brand guidelines. Use when asked to review, score or QA marketing visuals or copy for Noor Organics.
---

# Creative review (Noor Organics)

## Process
1. Describe what you see: layout, headline, CTA, colours, all text. No judgement yet.
2. Score 1-5 on: offer clarity at thumbnail size, brand fit, hierarchy, mobile legibility.
3. For each deduction, quote the rule from brand-rules.md.
4. Check claims against approved-claims.md. Flag anything not listed.
5. Check disclosure: paid content must carry the market's label (see brand-rules.md).
6. Output a table per creative, then one prioritised fix list, then "Uncertain readings".

## Never
- Invent performance predictions or statistics.
- Approve medical claims not in approved-claims.md.

Put supporting files beside it (brand-rules.md, approved-claims.md, maybe a script). Zip the folder to upload it in the Claude apps' skills settings, or place it in .claude/skills/creative-review/ in a repository for Claude Code.

Writing descriptions that trigger correctly

  • Say what it does and when to use it, with the words people actually type ("review", "QA", "score").
  • Include the brand, client or domain name if the skill is specific.
  • Keep one job per skill. A "marketing" mega-skill will load at the wrong times.

Plugins: bundles for teams

A plugin packages skills, connectors (MCP servers) and sub-agents together so a whole workflow can be installed in one step. In 2026 Anthropic introduced a plugin directory and, in September 2026, a developer portal for submitting plugins; vendors have launched plugins such as Salesforce in Claude (beta, September 2026) with dozens of pre-built sales skills. On Team and Enterprise plans, admins control which skills and plugins are available, and security scanning for third-party skills and plugins entered beta in August 2026.

Safety: skills can contain code

Skills can include scripts that Claude may run. Treat third-party skills like software:

  • Install only from trusted sources; read the SKILL.md and any scripts first.
  • Watch for instructions that fetch content from unknown URLs or send data out.
  • Keep secrets out of skill folders.
  • Use your admin's approved list on business plans.

Worked example: a reporting skill for an agency

A Riyadh performance agency writes a monthly-client-report skill: steps for pulling the export, the metric definitions they use (for example, ROAS definition), a bilingual report template, a script that builds the chart, and a "checks needed" rule. Any account manager can now type "monthly report for Client B from this export" and get the house format. When the metric definition changed, they updated one file instead of retraining twelve people.

Hands-on: build your first skill

  1. Pick a procedure you explain to colleagues repeatedly.
  2. Write SKILL.md with a precise name and description, a numbered process, a "never" list and an output format.
  3. Add one supporting file (rules, glossary or template).
  4. Upload it (or add it to .claude/skills/ in Claude Code) and test with three prompts: one that should trigger it, one borderline, one that should not.
  5. Refine the description until it triggers correctly.

Pitfalls

  • Vague descriptions ("helps with marketing") that never or always trigger.
  • Duplicating rules between Project instructions and skills; keep one source of truth.
  • Installing community skills without reading them.

How to measure success

Colleagues produce house-standard outputs without asking you, the skill triggers when it should (and not otherwise), and updating the procedure means editing one file.

Key takeaways

  • Skills are folders of instructions, scripts and resources that Claude loads only when relevant (progressive disclosure).
  • A SKILL.md needs a precise name and description; the description decides when it triggers, so name the job and trigger words.
  • Plugins bundle skills, connectors and sub-agents for one-step team installs; admins control availability on business plans.
  • Treat third-party skills like software: read them first, keep secrets out, and use approved sources.

Check your understanding

Quick questions to lock in the lesson. They don’t count towards your certificate.

  1. What does "progressive disclosure" mean for Skills?
  2. Your "creative-review" skill never triggers when colleagues type "QA these ads". What is the most likely fix?
  3. A colleague finds a free community skill that "optimises all your marketing". What should happen before installing it for the team?

Put it into practice

Write a SKILL.md for one procedure you explain repeatedly (name, precise description, numbered process, never-list, output format) plus one supporting file. Test with a triggering, a borderline and a non-triggering prompt.

Enrol for free to save your progress

Reading is always free. Enrol to keep your place, take the final assessment and earn a verifiable certificate.