Snyk: How Claude Skills Work: Progressive Disclosure Explained

Name: Snyk: How Claude Skills Work: Progressive Disclosure Explained
Uploaded: 2026-08-09T07:10:45-04:00
Duration: 44 s
Description: Watch the full video here: https://youtu.be/EbLfnh0vJlk Use Snyk for free to find and fix security issues in your applications today! https://snyk.co/ugLYn ✍️ Resources ✍️ - Snyk Blog Post: https://snyk.io/articles/top-claude-skills-developers/ - Snyk ...

Snyk

08/09/2026

0 (0%)

Report Like Favorite

TL;DR

A Claude skill is a folder with a skill.md file containing YAML metadata and plain markdown instructions, optionally bundled with scripts and reference docs.
Claude uses progressive disclosure at startup, reading only the name and description of each skill — around 100 tokens — before deciding which to load fully.
Full skill instructions and supporting assets are only loaded when a task match is found, meaning unused skills cost virtually nothing in token overhead.

Summary

This short explainer breaks down exactly what a Claude skill is and why the architecture makes it practical to install many of them without degrading AI performance. A Claude skill is simply a folder containing a skill.md file, which includes a small YAML header with a name and description, followed by plain markdown instructions. Skills can also bundle supporting assets such as shell scripts, templates, and reference documentation alongside the core instruction file. The key engineering insight is the progressive disclosure loading model: when Claude starts up, it reads only the name and description of each installed skill — approximately 100 tokens per skill — and matches the user's task against those lightweight descriptors. Only when a match is found does Claude load the full instruction set, and supporting scripts or references are deferred even further, loading only if actually required during execution. This tiered loading strategy means that having dozens of skills installed carries virtually no token cost for skills that go unused in a given session, making the approach highly scalable for developer workflows that span multiple domains and task types.

Chapters

0:00 - What Is a Claude Skill
0:10 - Bundled Assets and Structure
0:14 - Progressive Disclosure Loading
0:33 - Cost of Unused Skills

Key Quotes

0:00 "A Claude skill is a folder with a file called skill.md inside it."
0:14 "Here's the clever part, and the reason you can install dozens of these without slowing Claude down. It uses what's called progressive disclosure."
0:23 "At startup, Claude only reads the name and description of each skill, roughly 100 tokens each. It matches your task against those descriptions, and only when it finds a match does it load the full instructions."
0:37 "So the cost of having a skill installed but unused is basically nothing."

FAQ

Does installing many Claude skills slow down performance or increase token usage?

No. Claude only reads the name and description of each skill at startup — roughly 100 tokens each. Full instructions and supporting files are only loaded when a skill is actually matched to a task, so unused skills cost virtually nothing.

What files make up a Claude skill?

At minimum, a skill is a folder containing a skill.md file with a YAML header (name and description) and plain markdown instructions. It can optionally include scripts, templates, and reference documentation that load only when needed.

Categories:

» Cybersecurity » Application Security
» Data Protection

Tags:

Show more Show less

Browse videos

Upcoming Webinar Calendar

11/10/2026

01:00 PM

11/10/2026

Zendesk: From AI Readiness to Results: A Framework for Transforming IT Service

https://www.truthinit.com/index.php/channel/2191/zendesk-from-ai-readiness-to-results-a-framework-for-transforming-it-service/
11/10/2026

01:00 PM

11/10/2026

Agentic Shopping Trends: Insights for the 2026 Holiday Season

https://www.truthinit.com/index.php/channel/2219/agentic-shopping-trends-insights-for-the-2026-holiday-season/
11/12/2026

01:00 PM

11/12/2026

Leaving VMware Means Leaving vSAN: Your VMware Exit Is Really a Storage Decision

https://www.truthinit.com/index.php/channel/2192/leaving-vmware-means-leaving-vsan-your-vmware-exit-is-really-a-storage-decision/
11/12/2026

01:00 PM

11/12/2026

Practical Session: Connecting On-Prem Data to Databricks via MinIO AIStor (Americas)

https://www.truthinit.com/index.php/channel/2202/practical-session-connecting-on-prem-data-to-databricks-via-minio-aistor-americas/
11/18/2026

08:00 AM

11/18/2026

Hands-On Workshop: Connecting On-Prem Data to Databricks via MinIO AIStor (International)

https://www.truthinit.com/index.php/channel/2194/hands-on-workshop-connecting-on-prem-data-to-databricks-via-minio-aistor-international/
11/19/2026

01:00 PM

11/19/2026

Securing the Microsoft Enterprise: Strengthening Configuration Management, Identity Security, and Data Protection

https://www.truthinit.com/index.php/channel/2076/securing-the-microsoft-enterprise-strengthening-configuration-management-identity-security-and-data-protection/
11/19/2026

01:00 PM

11/19/2026

Zendesk Deep Dive: Get the work done faster with Employee Service AI Agents

https://www.truthinit.com/index.php/channel/2181/zendesk-deep-dive-get-the-work-done-faster-with-employee-service-ai-agents/
11/19/2026

01:00 PM

11/19/2026

A Deep Dive into Muse, Dots, and Duet's Impact on Your Website

https://www.truthinit.com/index.php/channel/2228/a-deep-dive-into-muse-dots-and-duets-impact-on-your-website/
12/03/2026

01:00 PM

12/03/2026

CISO Insights: Steering Cybersecurity Strategies in an AI-Driven Era

https://www.truthinit.com/index.php/channel/2231/ciso-insights-steering-cybersecurity-strategies-in-an-ai-driven-era/
01/19/2027

02:00 PM

01/19/2027

HUMAN Dialogue: Embracing the Rise of the Empowered AI Consumer.

https://www.truthinit.com/index.php/channel/2160/human-dialogue-embracing-the-rise-of-the-empowered-ai-consumer/