VibeKoding / Level 3 Β· MasterLevel 3 Β· Master / Claude Code Skills: Membungkus Logika Jadi ModulClaude Code Skills: Membungkus Logika Jadi Modul
VK

Claude Code Skills: Membungkus Logika Jadi ModulClaude Code Skills: Membungkus Logika Jadi Modul

πŸ“š Level 3 Β· MasterLevel 3 Β· Master 🌏 Dual Bahasa (ID / EN) ⚑ VibeKoding Native

Modul master Level 3 VibeKoding: Claude Code Skills: Membungkus Logika Jadi Modul.Modul master Level 3 VibeKoding: Claude Code Skills: Membungkus Logika Jadi Modul.

Introduction to SkillsIntroduction to Skills

Claude Code Skills is a feature that packages specialized knowledge, workflows, and best practices into reusable "skill packs."Claude Code Skills is a feature that packages specialized knowledge, workflows, and best practices into reusable "skill packs."

You can imagine Skills as "skill books" equipped for Claude. When you need it to complete a specific task, you no longer have to explain the requirements over and over again. Instead, it can directly carry out the work according to the standards defined in advance by the Skill.You can imagine Skills as "skill books" equipped for Claude. When you need it to complete a specific task, you no longer have to explain the requirements over and over again. Instead, it can directly carry out the work according to the standards defined in advance by the Skill.

Why do we need Skills?Why do we need Skills?

Before Skills existed, using Claude Code had several problems:Before Skills existed, using Claude Code had several problems:

Skills solve these problems and turn Claude into an "experienced team member" - it knows your project conventions, workflows, and best practices.Skills solve these problems and turn Claude into an "experienced team member" - it knows your project conventions, workflows, and best practices.

------

Why learn Skills now?Why learn Skills now?

Skills are becoming a must-have capability for AI engineers:Skills are becoming a must-have capability for AI engineers:

------

Quick StartQuick Start

Now that you understand the value of Skills, let's try them right away. This section will take you through installing your first Skill and completing a few interesting hands-on tasks so you can quickly build intuition.Now that you understand the value of Skills, let's try them right away. This section will take you through installing your first Skill and completing a few interesting hands-on tasks so you can quickly build intuition.

Step 1: Install find-skills (strongly recommended)Step 1: Install find-skills (strongly recommended)

Before you start using Skills, it is strongly recommended that you install find-skills first. It is the "ultimate skill search tool" in the AI Agent world and already has 60K+ subscriptions.Before you start using Skills, it is strongly recommended that you install find-skills first. It is the "ultimate skill search tool" in the AI Agent world and already has 60K+ subscriptions.

What is find-skills?What is find-skills?

Simply put, find-skills is like an "app store search engine" for AI Agents. When you need to complete a task but do not have a suitable local Skill, it will automatically search for and recommend the most appropriate one.Simply put, find-skills is like an "app store search engine" for AI Agents. When you need to complete a task but do not have a suitable local Skill, it will automatically search for and recommend the most appropriate one.

Install find-skills:Install find-skills:

bash
npx skills add vercel-labs/skills@find-skills -g -y

After installation, you can directly tell Claude what you need, and it will use find-skills to search for relevant skills automatically.After installation, you can directly tell Claude what you need, and it will use find-skills to search for relevant skills automatically.

Example usage:Example usage:

text
I need to optimize the performance of a React component. Help me find what skills I can use.

Claude will search through find-skills, then tell you which relevant skills it found so that you can choose one to install.Claude will search through find-skills, then tell you which relevant skills it found so that you can choose one to install.

Why install find-skills first?Why install find-skills first?

Before find-skills:Before find-skills:

After find-skills:After find-skills:

Note for Windows users: the official version has limited Windows support. The community has made a Windows-compatible version that supports CMD and PowerShell and adds Chinese-language search.Note for Windows users: the official version has limited Windows support. The community has made a Windows-compatible version that supports CMD and PowerShell and adds Chinese-language search.

Download the Windows version: [github.com/tongbei821/customize-skills](https://github.com/tongbei821/customize-skills/blob/main/findskills/SKILL.md)Download the Windows version: [github.com/tongbei821/customize-skills](https://github.com/tongbei821/customize-skills/blob/main/findskills/SKILL.md)

Installation steps:Installation steps:

  1. Download the Windows version of SKILL.mdDownload the Windows version of SKILL.md
  2. Replace the file in C:/Users/your-username/.agents/skills/find-skillsReplace the file in C:/Users/your-username/.agents/skills/find-skills
  3. Restart Claude Code and it will take effectRestart Claude Code and it will take effect
  4. Related links:Related links:

    • [Skills official website](https://skills.sh/) - browse all available skills[Skills official website](https://skills.sh/) - browse all available skills
    • [find-skills repository](https://github.com/vercel-labs/agent-skills) - official source code[find-skills repository](https://github.com/vercel-labs/agent-skills) - official source code

    Install and Try Your First SkillInstall and Try Your First Skill

    After installing find-skills, let's use it to search for and install a fun first Skill: the Remotion video creation tool.After installing find-skills, let's use it to search for and install a fun first Skill: the Remotion video creation tool.

    Step 1: Use find-skills to search for RemotionStep 1: Use find-skills to search for Remotion

    Type this in Claude Code:Type this in Claude Code:

    text
    Help me find skills related to Remotion. I want to make videos.
    

    Claude will search via find-skills and recommend remotion-dev/skills.Claude will search via find-skills and recommend remotion-dev/skills.

    Step 2: Install Remotion SkillsStep 2: Install Remotion Skills

    bash
    npx skills add remotion-dev/skills -g
    

    Step 3: Use it to build something funStep 3: Use it to build something fun

    Remotion is a framework for making videos with React code. After installing this Skill, you can ask Claude in natural language to help you write video code.Remotion is a framework for making videos with React code. After installing this Skill, you can ask Claude in natural language to help you write video code.

    Task 1: Make a cool animated text videoTask 1: Make a cool animated text video

    text
    Use Remotion to make a video: - 1920x1080, 5 seconds - A line of text "Hello World" flies in from the left - With rotation and scaling effects at the same time - The background is a gradient
    

    Claude will generate complete Remotion code, and you can run it to see the animation.Claude will generate complete Remotion code, and you can run it to see the animation.

    Task 2: Make a data visualization videoTask 2: Make a data visualization video

    text
    Make a 10-second video showing data growth: - Start with a bar chart - The bars grow one by one with animation - Numbers count upward - At the end, show large text saying "300% growth"
    

    Task 3: Make a multi-scene product demo videoTask 3: Make a multi-scene product demo video

    text
    Make a product demo video with three scenes: Scene 1: Logo fades in, 2 seconds Scene 2: Product features appear one by one, 3 seconds Scene 3: CTA button pops up, 2 seconds Use smooth transitions between each scene
    

    Run the code:Run the code:

    The code Claude generates is a complete Remotion project. You can:The code Claude generates is a complete Remotion project. You can:

    1. Create a new project: npx create-video my-videoCreate a new project: npx create-video my-video
    2. Copy Claude's generated code into itCopy Claude's generated code into it
    3. Run a preview: npm startRun a preview: npm start
    4. Render the video: npm run buildRender the video: npm run build
    5. ------

      The Second Skill: Use find-skills to solve "the frontend looks ugly and feels slow"The Second Skill: Use find-skills to solve "the frontend looks ugly and feels slow"

      Step 1: Describe your problem in natural languageStep 1: Describe your problem in natural language

      Directly tell Claude your high-level need:Directly tell Claude your high-level need:

      text
      My website looks outdated and loads slowly. Help me find what skills I can use.
      

      Or make it a bit more specific:Or make it a bit more specific:

      text
      I want the frontend to look better and stop being so laggy.
      

      Step 2: Claude will search with find-skillsStep 2: Claude will search with find-skills

      Claude will search the skills.sh database via find-skills and recommend related skills. For a requirement like "make it look better + reduce lag," it will recommend:Claude will search the skills.sh database via find-skills and recommend related skills. For a requirement like "make it look better + reduce lag," it will recommend:

      anthropics/skills/frontend-design (official skill)anthropics/skills/frontend-design (official skill)

      This skill is specifically designed to solve the problem of AI-generated interfaces that "look plain and generic," helping Claude design:This skill is specifically designed to solve the problem of AI-generated interfaces that "look plain and generic," helping Claude design:

      • unique visual styles that avoid the same old "AI template look"unique visual styles that avoid the same old "AI template look"
      • professional color schemes and typographyprofessional color schemes and typography
      • smooth animation effectssmooth animation effects
      • production-grade code quality, with clean code and naturally better performanceproduction-grade code quality, with clean code and naturally better performance

      Step 3: Install and use itStep 3: Install and use it

      Install:Install:

      bash
      npx skills add anthropics/skills/frontend-design -g
      

      Tasks you can complete with it:Tasks you can complete with it:

      text
      Help me redesign this page. I want it to look very professional and not like it was generated by AI.
      
      text
      This UI is too ugly. Rewrite it in a more modern design style.
      
      text
      Make a dark-theme dashboard with a strong tech feel.
      

      Claude will follow this skill's conventions and help you design:Claude will follow this skill's conventions and help you design:

      • a unique visual direction such as minimalism, retro-futurism, or brutalisma unique visual direction such as minimalism, retro-futurism, or brutalism
      • carefully chosen colors and fontscarefully chosen colors and fonts
      • reasonable spacing and layoutreasonable spacing and layout
      • smooth interactive animationsmooth interactive animation

      ------

      Comparing the Two SkillsComparing the Two Skills

      SkillsWhat problem does it solve?Fun factor
      remotion-dev/skillsMake videos with code⭐⭐⭐⭐⭐
      anthropics/skills/frontend-designMake the frontend look better⭐⭐⭐⭐

      ------

      The Third Skill: Use frontend-slides to quickly make beautiful PPT presentationsThe Third Skill: Use frontend-slides to quickly make beautiful PPT presentations

      IntroductionIntroduction

      frontend-slides is a Skill that lets you create beautiful HTML presentations with natural language - even if you do not know any CSS or JavaScript.frontend-slides is a Skill that lets you create beautiful HTML presentations with natural language - even if you do not know any CSS or JavaScript.

      Its core idea is "show, don't tell." If you cannot clearly describe the design style you want, it will generate 3 visual previews for you to choose from, rather than forcing you to describe abstract requirements like "blue background, large font."Its core idea is "show, don't tell." If you cannot clearly describe the design style you want, it will generate 3 visual previews for you to choose from, rather than forcing you to describe abstract requirements like "blue background, large font."

      Install frontend-slidesInstall frontend-slides

      Method 1: Install manuallyMethod 1: Install manually

      bash
      # Create the skill directory mkdir -p ~/.claude/skills/frontend-slides # Download files (or copy from GitHub) # 1. Visit https://github.com/zarazhangrui/frontend-slides # 2. Download SKILL.md and STYLE_PRESETS.md # 3. Put them into ~/.claude/skills/frontend-slides/
      

      Method 2: Install with find-skillsMethod 2: Install with find-skills

      text
      Help me find a skill for making PPT presentations
      

      Claude will search through find-skills and recommend frontend-slides.Claude will search through find-skills and recommend frontend-slides.

      Usage scenariosUsage scenarios

      Scenario 1: Create a presentation from scratchScenario 1: Create a presentation from scratch

      text
      /frontend-slides I want to create a fundraising pitch deck for an AI startup project, around 10 slides
      

      Claude will guide you to:Claude will guide you to:

      1. fill in the content of each slide such as titles, bullet points, and imagesfill in the content of each slide such as titles, bullet points, and images
      2. describe the feeling you want such as stunning, professional, or warmdescribe the feeling you want such as stunning, professional, or warm
      3. choose from 3 visual style previewschoose from 3 visual style previews
      4. create the complete HTML presentationcreate the complete HTML presentation
      5. open a preview in the browseropen a preview in the browser
      6. Scenario 2: Convert a PowerPoint fileScenario 2: Convert a PowerPoint file

        text
        /frontend-slides Convert my presentation.pptx into a web presentation
        

        Claude will:Claude will:

        1. extract all text, images, and notes from the PPTextract all text, images, and notes from the PPT
        2. show the extracted content for you to confirmshow the extracted content for you to confirm
        3. let you choose a visual stylelet you choose a visual style
        4. generate an HTML presentation that preserves all original contentgenerate an HTML presentation that preserves all original content
        5. Scenario 3: Quickly generate style previewsScenario 3: Quickly generate style previews

          text
          /frontend-slides I want to make a PPT for a technical talk. Show me the available visual styles first.
          

          Claude will directly generate 3 preview pages in different styles:Claude will directly generate 3 preview pages in different styles:

          • Dark themes: Neon Cyber, Terminal Green, Deep SpaceDark themes: Neon Cyber, Terminal Green, Deep Space
          • Light themes: Paper & Ink, Swiss Modern, Soft PastelLight themes: Paper & Ink, Swiss Modern, Soft Pastel
          • Special styles: Brutalist, Gradient WaveSpecial styles: Brutalist, Gradient Wave

          Built-in visual stylesBuilt-in visual styles

          Style nameCharacteristicsSuitable scenarios
          Neon CyberFuturistic tech feel, particle effectsTechnical talks, AI products
          Midnight ExecutiveHigh-end business, trustworthyBusiness reports, fundraising pitches
          Paper & InkEditorial style, literary atmosphereContent creation, educational sharing
          Swiss ModernClean geometry, Bauhaus styleDesign portfolios, minimalism
          BrutalistRaw, bold, attention-grabbingArt showcase, personal expression

          Output resultOutput result

          The generated presentation is a single-file HTML document that includes:The generated presentation is a single-file HTML document that includes:

          • complete styling and interaction codecomplete styling and interaction code
          • keyboard navigation with arrow keys and spacekeyboard navigation with arrow keys and space
          • touch and swipe supporttouch and swipe support
          • mouse wheel slide turningmouse wheel slide turning
          • progress bars and navigation dotsprogress bars and navigation dots
          • scroll-triggered animationscroll-triggered animation
          • responsive designresponsive design
          html
          <!DOCTYPE html> <html lang="zh-CN"> <head> <!-- All styles are inlined, zero dependencies --> </head> <body> <section class="slide title-slide"> <h1 class="reveal">Your Title</h1> </section> <!-- More slides... --> </body> </html>
          

          Why recommend it?Why recommend it?

          1. Zero dependency: a single HTML file that will still open 10 years from nowZero dependency: a single HTML file that will still open 10 years from now
          2. Visual discovery: no need to describe the design, just pick what you likeVisual discovery: no need to describe the design, just pick what you like
          3. PPT conversion: keep your existing content and give it a better visual skinPPT conversion: keep your existing content and give it a better visual skin
          4. Production-grade code: accessible, clearly commented, and easy to customizeProduction-grade code: accessible, clearly commented, and easy to customize
          5. Related links:Related links:

            • [frontend-slides GitHub repository](https://github.com/zarazhangrui/frontend-slides) - 6.1k+ stars[frontend-slides GitHub repository](https://github.com/zarazhangrui/frontend-slides) - 6.1k+ stars
            • [Online preview example](https://github.com/zarazhangrui/frontend-slides#output-example)[Online preview example](https://github.com/zarazhangrui/frontend-slides#output-example)

            ------

            Comparing the Three SkillsComparing the Three Skills

            SkillsWhat problem does it solve?Fun factorPracticality
            remotion-dev/skillsMake videos with code⭐⭐⭐⭐⭐⭐⭐⭐⭐
            anthropics/skills/frontend-designMake the frontend look better⭐⭐⭐⭐⭐⭐⭐⭐⭐
            frontend-slidesQuickly make beautiful PPTs⭐⭐⭐⭐⭐⭐⭐⭐⭐

            ------

            How to use them after installationHow to use them after installation

            After installation, you do not need any extra configuration. When you ask Claude to perform a related task, it will automatically call the corresponding Skill.After installation, you do not need any extra configuration. When you ask Claude to perform a related task, it will automatically call the corresponding Skill.

            View installed Skills:View installed Skills:

            bash
            npx skills list
            

            ------

            What are Skills?What are Skills?

            Core conceptCore concept

            Skills are "skill packs" stored in the file system and can include:Skills are "skill packs" stored in the file system and can include:

            • SKILL.md: the definition file for the skill, requiredSKILL.md: the definition file for the skill, required
            • scripts/: helper scripts, optionalscripts/: helper scripts, optional
            • templates/: output templates, optionaltemplates/: output templates, optional
            • references/: reference docs, optionalreferences/: reference docs, optional

            Skills vs. promptsSkills vs. prompts

            You may wonder: what is the difference between Skills and directly sending prompts to Claude?You may wonder: what is the difference between Skills and directly sending prompts to Claude?

            PromptsSkills
            Temporary, you have to repeat them every timePersistent, write once and reuse many times
            Live in conversation history and consume tokensLoaded on demand and save tokens
            Cannot be shared across sessionsCan be shared within a team
            Hard to version-controlCan be managed with Git

            Two types of SkillsTwo types of Skills

            Global Skills (personal):Global Skills (personal):

            • storage location: ~/.claude/skills/storage location: ~/.claude/skills/
            • scope: all projectsscope: all projects
            • suitable scenarios: general-purpose personal skillssuitable scenarios: general-purpose personal skills

            Project Skills (team):Project Skills (team):

            • storage location: project-directory/.claude/skills/storage location: project-directory/.claude/skills/
            • scope: the current projectscope: the current project
            • suitable scenarios: team sharing and project-specific conventionssuitable scenarios: team sharing and project-specific conventions

            How Skills workHow Skills work

            When Claude Code starts, it will:When Claude Code starts, it will:

            1. scan the Skills directoriesscan the Skills directories
            2. parse each SKILL.md fileparse each SKILL.md file
            3. extract YAML frontmatter metadataextract YAML frontmatter metadata
            4. add the skill content into its "knowledge base"add the skill content into its "knowledge base"
            5. automatically match triggers based on the descriptionautomatically match triggers based on the description
            6. ------

              SKILL.md File StructureSKILL.md File Structure

              Basic structureBasic structure

              A complete Skill directory looks like this:A complete Skill directory looks like this:

              text
              my-skill/ β”œβ”€β”€ SKILL.md # Required: skill definition file β”œβ”€β”€ scripts/ # Optional: helper scripts β”œβ”€β”€ templates/ # Optional: output templates β”œβ”€β”€ references/ # Optional: reference documents └── examples/ # Optional: example files
              

              SKILL.md templateSKILL.md template

              The SKILL.md file has two parts:The SKILL.md file has two parts:

              Part 1: YAML Frontmatter (metadata)Part 1: YAML Frontmatter (metadata)

              yaml
              --- name: skill-name # Skill name, becomes the /skill-name command description: short description # Used for Claude's automatic trigger matching category: development # Category tags: # Tags - code - automation ---
              

              Part 2: Markdown content (instructions)Part 2: Markdown content (instructions)

              markdown
              # Skill Title ## Use cases When to use this skill ## Execution steps 1. Step one 2. Step two ## Notes - Note 1 - Note 2
              

              Explanation of key fieldsExplanation of key fields

              FieldRequiredExplanation
              nameYesThe skill name. Only lowercase letters, numbers, and hyphens are allowed
              descriptionYesThe skill description. The more specific it is, the easier it is for Claude to match automatically
              categoryNoCategory label
              tagsNoAdditional category labels
              allowed-toolsNoTools that may be used without extra permission

              ------

              Skills vs. MCP: What is the difference?Skills vs. MCP: What is the difference?

              Many beginners confuse Skills and MCP, but they are completely different things.Many beginners confuse Skills and MCP, but they are completely different things.

              Core differencesCore differences

              DimensionSkillsMCP
              NatureKnowledge and workflowTools and interfaces
              What it providesTells AI "how to do it"Gives AI "what it can use"
              Storage locationskills/ directoryMCP server
              Configuration formatMarkdown filesJSON config files
              Trigger method/skill-name or automatic recognitionAutomatically loaded through configuration

              An intuitive analogyAn intuitive analogy

              If Claude were a "worker":If Claude were a "worker":

              • MCP would be the "tools" given to the worker, such as a wrench, a computer, and access permissionsMCP would be the "tools" given to the worker, such as a wrench, a computer, and access permissions
              • Skills would be the "operating manual" given to the worker, such as how to do code review or how to submit codeSkills would be the "operating manual" given to the worker, such as how to do code review or how to submit code

              Their relationshipTheir relationship

              Skills and MCP are not competing with each other. They are complementary:Skills and MCP are not competing with each other. They are complementary:

              text
              User task -> Claude recognizes the requirement ↓ Load relevant Skills (know how to do it) ↓ Call tools through MCP (have tools available) ↓ Complete the task
              

              ExampleExample

              Scenario: code reviewScenario: code review

              • Skills define the review steps, checklist, and output formatSkills define the review steps, checklist, and output format
              • MCP provides the ability to access GitHub PRs and fetch code diffsMCP provides the ability to access GitHub PRs and fetch code diffs

              Working together: Skills tell Claude "how to review," and MCP gives Claude "the ability to access the code."Working together: Skills tell Claude "how to review," and MCP gives Claude "the ability to access the code."

              Recommendation for choosingRecommendation for choosing

              Your needRecommended solution
              Need to define a workflowUse Skills
              Need to access external dataUse MCP
              Need bothUse them together

              ------

              Common Resources for Getting SkillsCommon Resources for Getting Skills

              Official resourcesOfficial resources

              • [Anthropic official Skills repository](https://github.com/anthropics/skills) - an officially maintained collection of skills[Anthropic official Skills repository](https://github.com/anthropics/skills) - an officially maintained collection of skills
              • [Claude Code official docs - Skills](https://docs.anthropic.com/en/docs/claude-code/configuration/skills) - official documentation[Claude Code official docs - Skills](https://docs.anthropic.com/en/docs/claude-code/configuration/skills) - official documentation

              GitHub community resourcesGitHub community resources

              RepositoryDescription
              [shanraisshan/claude-code-best-practice](https://github.com/shanraisshan/claude-code-best-practice)Community-maintained collection covering Skills, Agents, Hooks, and more
              [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code)Comprehensive toolkit including preconfigured Skills
              [JackyST0/awesome-agent-skills](https://github.com/JackyST0/awesome-agent-skills)Curated Skills resource list
              [jeffallan/claude-skills](https://github.com/jeffallan/claude-skills)66 professional skills and 300+ reference documents
              [GitCode/awesome-claude-skills](https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills)Selected open-source collection

              How to install community SkillsHow to install community Skills

              Using find-skills, you only need to tell Claude what you need, and it will automatically search and recommend:Using find-skills, you only need to tell Claude what you need, and it will automatically search and recommend:

              text
              Help me find a skill related to React performance optimization
              

              Claude will search the skills.sh database through find-skills, then list the most relevant skills, and you can choose one to install.Claude will search the skills.sh database through find-skills, then list the most relevant skills, and you can choose one to install.

              Search tips:Search tips:

              • use specific keywords: "react testing" is better than "testing"use specific keywords: "react testing" is better than "testing"
              • combine "domain + action": "nextjs deploy", "typescript lint"combine "domain + action": "nextjs deploy", "typescript lint"
              • prioritize skills with high install counts, since 10K+ usually means battle-testedprioritize skills with high install counts, since 10K+ usually means battle-tested
              • watch the trending list to discover emerging skillswatch the trending list to discover emerging skills

              ------

              How to Create Your Own SkillsHow to Create Your Own Skills

              There are two ways to create Skills: directly ask Claude to create one for you, or use the dedicated skill-creator tool.There are two ways to create Skills: directly ask Claude to create one for you, or use the dedicated skill-creator tool.

              Method 1: Directly ask Claude to help you create oneMethod 1: Directly ask Claude to help you create one

              This is the simplest approach. Just tell Claude your requirement in natural language.This is the simplest approach. Just tell Claude your requirement in natural language.

              Example:Example:

              text
              Please help me create a skill named "format-code" to automatically format code. Requirements: 1. Automatically detect the programming language 2. Apply the corresponding formatting rules 3. Return the diff before and after formatting
              

              Claude will automatically:Claude will automatically:

              1. create the directory structurecreate the directory structure
              2. generate the SKILL.md filegenerate the SKILL.md file
              3. fill in the YAML frontmatterfill in the YAML frontmatter
              4. write the skill contentwrite the skill content
              5. Suitable scenarios:Suitable scenarios:

                • quickly creating simple skillsquickly creating simple skills
                • you know what you want but are not familiar with the SKILL.md formatyou know what you want but are not familiar with the SKILL.md format
                • you want to iterate and modify quicklyyou want to iterate and modify quickly

                Method 2: Use skill-creatorMethod 2: Use skill-creator

                skill-creator is a dedicated tool for creating Skills. It guides you step by step through the process.skill-creator is a dedicated tool for creating Skills. It guides you step by step through the process.

                Install:Install:

                bash
                npx skills add anthropics/skills@skill-creator -g
                

                Or install the entire official skills repository:Or install the entire official skills repository:

                bash
                npx skills add anthropics/skills -g
                

                Use:Use:

                text
                /skill-creator
                

                Then fill in the prompts:Then fill in the prompts:

                • skill nameskill name
                • feature descriptionfeature description
                • usage scenariosusage scenarios
                • execution stepsexecution steps

                skill-creator will:skill-creator will:

                1. guide you to clarify the purpose of the skillguide you to clarify the purpose of the skill
                2. generate a draft SKILL.mdgenerate a draft SKILL.md
                3. create test casescreate test cases
                4. run evaluation and optimize itrun evaluation and optimize it
                5. Suitable scenarios:Suitable scenarios:

                  • creating complex skillscreating complex skills
                  • needing a more standard creation processneeding a more standard creation process
                  • wanting to test and verify the skillwanting to test and verify the skill

                  Comparison of the two methodsComparison of the two methods

                  Method 1: Direct creationMethod 2: skill-creator
                  Fast and simpleGuided steps
                  Suitable for simple skillsSuitable for complex skills
                  Completed directly in conversationStandardized process
                  Flexible modificationIncludes testing and verification

                  Tip: how to write a good requirementTip: how to write a good requirement

                  A good requirement description:A good requirement description:

                  text
                  Create a "git-commit" skill that automatically commits code. Execution steps: 1. Check which files were modified 2. Generate a commit message that follows Conventional Commits 3. Run git commit 4. Ask whether to push Notes: - Check for sensitive information before committing - Do not commit directories like dist/ or node_modules/
                  

                  A bad requirement description:A bad requirement description:

                  text
                  Help me write a skill for committing code
                  

                  That is too vague. Claude will not know exactly what it needs to do.That is too vague. Claude will not know exactly what it needs to do.

                  ------

                  Common Skill ExamplesCommon Skill Examples

                  Example 1: Code Review SkillExample 1: Code Review Skill

                  Create the directory and file:Create the directory and file:

                  bash
                  mkdir -p ~/.claude/skills/review-pr
                  
                  bash
                  cat > ~/.claude/skills/review-pr/SKILL.md << 'EOF' --- name: review-pr description: Review Pull Requests for code quality, security, and test coverage --- You are a senior code reviewer. ## Review workflow 1. **Code style check** - Does the code follow team conventions? - Are names clear? - Are comments sufficient? 2. **Security check** - Are there security vulnerabilities? - Is sensitive information exposed? - Is input validation complete? 3. **Testing check** - Are there enough tests? - Do test cases cover edge conditions? - Are the tests runnable? 4. **Overall evaluation** - What are the strengths? - What needs improvement? - Do you recommend approving the merge? ## Output format Please output the review results in a clear structure using a list format. EOF
                  

                  How to use it:How to use it:

                  text
                  /review-pr Please review the PR for the current branch
                  

                  Example 2: Git Auto-Commit SkillExample 2: Git Auto-Commit Skill

                  bash
                  mkdir -p ~/.claude/skills/git-commit
                  
                  bash
                  cat > ~/.claude/skills/git-commit/SKILL.md << 'EOF' --- name: git-commit description: Automatically detect changes, generate a commit message, and commit the code --- You are a skilled Git user. ## Execution workflow 1. **Check changes** Run `git status` to view modified files Run `git diff` to view detailed changes 2. **Generate commit message** Analyze the nature of the changes Generate a commit message that follows Conventional Commits Format: `type(scope): description` 3. **Security check** Check whether there is sensitive information such as keys, passwords, or tokens Check whether directories that should not be committed are included 4. **Execute after confirmation** Show the commit message for confirmation Run `git add` and `git commit` Ask whether a push is needed ## Notes - Do not commit directories such as node_modules/, dist/, or .next/ - Run tests before committing to ensure the code works - The commit message should clearly explain the change EOF
                  

                  How to use it:How to use it:

                  text
                  /git-commit
                  

                  Example 3: Test Generation SkillExample 3: Test Generation Skill

                  bash
                  mkdir -p ~/.claude/skills/gen-test
                  
                  bash
                  cat > ~/.claude/skills/gen-test/SKILL.md << 'EOF' --- name: gen-test description: Automatically generate unit tests for code to ensure correctness --- You are a test engineer. ## Workflow 1. **Analyze the code** - Understand the function or class - Identify inputs and outputs - Find edge cases 2. **Generate tests** - Use an appropriate test framework - Cover normal cases - Cover edge cases - Cover exceptional cases 3. **Validate the tests** - Make sure the tests can run - Make sure the tests can catch problems - Do not over-mock the implementation ## Test frameworks - JavaScript/TypeScript: Jest or Vitest - Python: pytest - Go: testing package ## Output format Output the test code first, then explain how to run the tests. EOF
                  

                  How to use it:How to use it:

                  text
                  /gen-test Generate unit tests for src/utils.ts
                  

                  Example 4: Documentation Generation SkillExample 4: Documentation Generation Skill

                  bash
                  mkdir -p ~/.claude/skills/gen-readme
                  
                  bash
                  cat > ~/.claude/skills/gen-readme/SKILL.md << 'EOF' --- name: gen-readme description: Automatically generate a README document for a project --- You are a technical documentation expert. ## Workflow 1. **Analyze the project** - Scan the project directory structure - Check package.json or other configuration files - Read the existing code 2. **Generate content** - Project introduction - Installation steps - Usage instructions - API documentation - Development guide 3. **Formatting** - Use a clear section structure - Add code examples - Add appropriate badges - Add license information ## Standard README structure - Project title and introduction - Features - Installation - Quick start - Usage instructions - API documentation - Development guide - Contribution guide - License EOF
                  

                  How to use it:How to use it:

                  text
                  /gen-readme Generate a README document for the current project
                  

                  ------

                  Advanced TipsAdvanced Tips

                  Combine Skills with HooksCombine Skills with Hooks

                  Hooks can automatically perform actions on specific events. Combined with Skills, they enable more powerful automation.Hooks can automatically perform actions on specific events. Combined with Skills, they enable more powerful automation.

                  For example, automatically format code after saving:For example, automatically format code after saving:

                  json
                  // .claude/hooks.json { "hooks": { "PostToolUse": [{ "matcher": { "tool_name": "Edit" }, "hook": { "type": "command", "command": "/format-code" // Call the format-code skill } }] } }
                  

                  Combine Skills with CommandsCombine Skills with Commands

                  Commands are simple shortcut commands. Skills are complex workflows. They can be used together.Commands are simple shortcut commands. Skills are complex workflows. They can be used together.

                  Team collaborationTeam collaboration

                  Share project Skills:Share project Skills:

                  1. put the Skills under .claude/skills/put the Skills under .claude/skills/
                  2. commit them to Gitcommit them to Git
                  3. team members can use them after cloning the projectteam members can use them after cloning the project
                  4. Version control:Version control:

                    • Skills can be version-controlled just like codeSkills can be version-controlled just like code
                    • each commit can record changes to Skillseach commit can record changes to Skills
                    • you can roll back to older versionsyou can roll back to older versions

                    ------

                    Frequently Asked QuestionsFrequently Asked Questions

                    Q1: Why was the Skill not triggered?Q1: Why was the Skill not triggered?

                    Possible reasons:Possible reasons:

                    • YAML frontmatter format is wrongYAML frontmatter format is wrong
                    • the description is not specific enoughthe description is not specific enough
                    • Claude Code was not restartedClaude Code was not restarted

                    How to solve it:How to solve it:

                    • check whether the YAML format is correctcheck whether the YAML format is correct
                    • improve the description and include specific usage scenariosimprove the description and include specific usage scenarios
                    • restart Claude Coderestart Claude Code

                    Q2: How do I write an accurate description?Q2: How do I write an accurate description?

                    A good description includes:A good description includes:

                    • the specific function of the skillthe specific function of the skill
                    • the usage scenario, such as "when the user mentions..."the usage scenario, such as "when the user mentions..."
                    • trigger keywordstrigger keywords

                    Bad example:Bad example:

                    text
                    description: Review code
                    

                    Good example:Good example:

                    text
                    description: Review Pull Request code. Trigger when the user mentions PR, review, or code review.
                    

                    Q3: What is the difference between Skills and Commands?Q3: What is the difference between Skills and Commands?

                    CommandsSkills
                    Simple shortcut commandsComplete workflows
                    A single .md fileA directory structure (SKILL.md + optional files)
                    Manually triggeredCan be automatically triggered
                    Suitable for simple operationsSuitable for complex processes

                    Q4: How do I debug a Skill?Q4: How do I debug a Skill?

                    1. Use /skills to check whether the skill was recognizedUse /skills to check whether the skill was recognized
                    2. Directly enter the skill name to trigger it manuallyDirectly enter the skill name to trigger it manually
                    3. Check whether the SKILL.md content is correctCheck whether the SKILL.md content is correct
                    4. Review the Claude Code logsReview the Claude Code logs
                    5. ------

                      ReferencesReferences

                      Official resourcesOfficial resources

                      • [Claude Code official docs - Skills](https://docs.anthropic.com/en/docs/claude-code/configuration/skills)[Claude Code official docs - Skills](https://docs.anthropic.com/en/docs/claude-code/configuration/skills)
                      • [Agent Skills standard](https://agentskills.io/)[Agent Skills standard](https://agentskills.io/)
                      • [Anthropic engineering article (practical ideas behind Agent Skills)](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)[Anthropic engineering article (practical ideas behind Agent Skills)](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
                      • [Anthropic official Skills GitHub repository](https://github.com/anthropics/skills)[Anthropic official Skills GitHub repository](https://github.com/anthropics/skills)
                      • [VS Code Copilot Agent Skills documentation](https://code.visualstudio.com/docs/copilot/customization/agent-skills)[VS Code Copilot Agent Skills documentation](https://code.visualstudio.com/docs/copilot/customization/agent-skills)

                      Resource directoriesResource directories

                      • [skills.sh](https://skills.sh/) - Vercel's Agent Skills app store with a 48,000+ skill library[skills.sh](https://skills.sh/) - Vercel's Agent Skills app store with a 48,000+ skill library
                      • [find-skills](https://github.com/vercel-labs/agent-skills) - intelligent skill search tool with 60K+ subscriptions[find-skills](https://github.com/vercel-labs/agent-skills) - intelligent skill search tool with 60K+ subscriptions
                      • [Skills marketplace (Chinese interface)](https://skillsmp.com/zh) - discover and install community Skills[Skills marketplace (Chinese interface)](https://skillsmp.com/zh) - discover and install community Skills

                      GitHub community projectsGitHub community projects

                      • [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) - Vercel Labs official Agent Skills collection, including find-skills[vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) - Vercel Labs official Agent Skills collection, including find-skills
                      • [claude-code-best-practice](https://github.com/shanraisshan/claude-code-best-practice) - community-maintained best-practices collection[claude-code-best-practice](https://github.com/shanraisshan/claude-code-best-practice) - community-maintained best-practices collection
                      • [everything-claude-code](https://github.com/affaan-m/everything-claude-code) - comprehensive toolkit including preconfigured Skills[everything-claude-code](https://github.com/affaan-m/everything-claude-code) - comprehensive toolkit including preconfigured Skills
                      • [awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) - curated list of selected Skills resources[awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) - curated list of selected Skills resources
                      • [superpowers](https://github.com/obra/superpowers) - collection of Skills for software development automation workflows[superpowers](https://github.com/obra/superpowers) - collection of Skills for software development automation workflows
                      • [jeffallan/claude-skills](https://github.com/jeffallan/claude-skills) - 66 professional skills and 300+ reference documents[jeffallan/claude-skills](https://github.com/jeffallan/claude-skills) - 66 professional skills and 300+ reference documents
                      • [awesome-agent-skills](https://github.com/JackyST0/awesome-agent-skills) - curated resource list[awesome-agent-skills](https://github.com/JackyST0/awesome-agent-skills) - curated resource list

                      Official Skill examplesOfficial Skill examples

                      • [skill-creator](https://github.com/anthropics/skills/tree/main/skills/skill-creator) - a skill for creating new skills[skill-creator](https://github.com/anthropics/skills/tree/main/skills/skill-creator) - a skill for creating new skills
                      • [mcp-builder](https://github.com/anthropics/skills/tree/main/skills/mcp-builder) - a skill for building MCP servers[mcp-builder](https://github.com/anthropics/skills/tree/main/skills/mcp-builder) - a skill for building MCP servers
                      • [slack-gif-creator](https://github.com/anthropics/skills/tree/main/skills/slack-gif-creator) - a skill for creating Slack GIFs[slack-gif-creator](https://github.com/anthropics/skills/tree/main/skills/slack-gif-creator) - a skill for creating Slack GIFs

                      Chinese tutorialsChinese tutorials

                      • [Complete guide to advanced Claude Code configuration and usage tips](https://blog.csdn.net/2601_95335870/article/details/158460599)[Complete guide to advanced Claude Code configuration and usage tips](https://blog.csdn.net/2601_95335870/article/details/158460599)
                      • [Vibe Coding - full-chain practice with CLAUDE.md, Skills, and Subagents](https://blog.csdn.net/yangshangwei/article/details/158319117)[Vibe Coding - full-chain practice with CLAUDE.md, Skills, and Subagents](https://blog.csdn.net/yangshangwei/article/details/158319117)
                      • [A step-by-step guide to customizing Claude Code Skills](https://m.blog.csdn.net/u010028049/article/details/157979705)[A step-by-step guide to customizing Claude Code Skills](https://m.blog.csdn.net/u010028049/article/details/157979705)

                      Further Reading: The Internal Mechanism of Claude SkillsFurther Reading: The Internal Mechanism of Claude Skills

                      Next, we will go deeper into how Claude Skills work internally, so you not only know how to use them, but also understand why they are designed this way.Next, we will go deeper into how Claude Skills work internally, so you not only know how to use them, but also understand why they are designed this way.

                      First-principles view: prompt-based dynamic context injectionFirst-principles view: prompt-based dynamic context injection

                      First, understand one key fact: Skills are not executable code.First, understand one key fact: Skills are not executable code.

                      Skills are essentially advanced instructions, or prompts, that are "injected" into Claude's context when needed. This design is called "Prompt-based Dynamic Context Injection & Meta-Tool Architecture."Skills are essentially advanced instructions, or prompts, that are "injected" into Claude's context when needed. This design is called "Prompt-based Dynamic Context Injection & Meta-Tool Architecture."

                      text
                      β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ User Requestβ”‚ ───> β”‚ LLM Matches β”‚ ───> β”‚ Trigger Skillβ”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚Description β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β–Ό β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Inject Full β”‚ β”‚ Instructions β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β–Ό β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Execute Task β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      

                      Three-layer progressive loading architecture (token optimization)Three-layer progressive loading architecture (token optimization)

                      To handle a large number of Skills without consuming too many tokens, Claude uses a smart three-layer loading mechanism:To handle a large number of Skills without consuming too many tokens, Claude uses a smart three-layer loading mechanism:

                      LayerContentWhen loadedToken cost
                      Layer 1: MetadataYAML frontmatter (name + description)When Claude starts~30-50 tokens/skill
                      Layer 2: InstructionsFull SKILL.md contentWhen the Skill is triggered~5,000 tokens
                      Layer 3: ResourcesScripts, templates, referencesAccessed from the file system on demandNot added to context

                      Advantages of this design:Advantages of this design:

                      • Suppose you have 100 Skills. At startup, only about 3,000-5,000 tokens are consumed for metadataSuppose you have 100 Skills. At startup, only about 3,000-5,000 tokens are consumed for metadata
                      • Only the triggered Skill loads its full contentOnly the triggered Skill loads its full content
                      • Resource files such as reference documents are never fully loaded into the contextResource files such as reference documents are never fully loaded into the context

                      Compared with no Skills:Compared with no Skills:

                      text
                      Without Skills: every conversation needs 50,000+ tokens to describe all capabilities With Skills: startup ~100 tokens/skill + 5,000 tokens loaded on demand Savings: on average 40,000+ tokens saved per conversation
                      

                      Dual context injection mechanismDual context injection mechanism

                      When a Skill is activated, the system makes two modifications at the same time:When a Skill is activated, the system makes two modifications at the same time:

                      1. Conversation context injection1. Conversation context injection

                      javascript
                      // What the user sees (visible message) <command-message>The "pdf" skill is loading</command-message> // What the AI actually receives (hidden meta-message) { isMeta: true, // marked as a meta-message, not shown in the UI content: ` # PDF Analysis Expert Instructions You are a professional PDF analysis expert. Workflow: 1. Use pdftotext to extract text 2. Analyze the document structure 3. Generate a summary report ... ` // full SKILL.md content, possibly thousands of words }
                      

                      2. Execution context modification2. Execution context modification

                      Besides injecting instructions, a Skill can also dynamically modify Claude's environment:Besides injecting instructions, a Skill can also dynamically modify Claude's environment:

                      Modification typeExampleExplanation
                      Tool permissionsallowed-tools: "Bash(pdftotext:*)"Temporarily grant access to a specific tool
                      Model switchingSwitch from Sonnet to OpusSome complex tasks require stronger reasoning
                      Context isolationCreate a child session spaceAvoid polluting the main conversation context

                      A routing mechanism based entirely on LLM reasoningA routing mechanism based entirely on LLM reasoning

                      This is a very important design decision: Claude Skills do not use hardcoded routing.This is a very important design decision: Claude Skills do not use hardcoded routing.

                      Traditional approachClaude Skills
                      ❌ Embedding vector matchingβœ… Pure LLM reasoning
                      ❌ Classifierβœ… Transformer forward pass
                      ❌ Regex or keyword matchingβœ… Natural language understanding
                      ❌ Separate routing algorithmβœ… Unified model decision-making

                      Workflow:Workflow:

                      text
                      1. The name and description of every Skill are formatted into the Skill tool description 2. Claude receives: - the user message - the list of available tools, including the Skill meta-tool - the Skill list, with name + description 3. Claude's natural language understanding matches the user's intent to a Skill description 4. When the match succeeds, it calls: command: "skill-name"
                      

                      Why design it this way?Why design it this way?

                      Hardcoded routing requires:Hardcoded routing requires:

                      • extra maintenance costextra maintenance cost
                      • no ability to understand complex semantic relationshipsno ability to understand complex semantic relationships
                      • difficulty handling multiple languagesdifficulty handling multiple languages
                      • no support for fuzzy matchingno support for fuzzy matching

                      Pure LLM reasoning:Pure LLM reasoning:

                      • leverages Claude's own language understandingleverages Claude's own language understanding
                      • automatically handles multiple languages, synonyms, and fuzzy descriptionsautomatically handles multiple languages, synonyms, and fuzzy descriptions
                      • requires no extra maintenancerequires no extra maintenance
                      • makes routing decisions more intelligentmakes routing decisions more intelligent

                      File parsing mechanismFile parsing mechanism

                      SKILL.md file structure:SKILL.md file structure:

                      bash
                      my-custom-skill/ β”œβ”€β”€ SKILL.md # Required: core definition file β”œβ”€β”€ config.json # Optional: metadata config β”œβ”€β”€ README.md # Recommended: usage documentation β”œβ”€β”€ scripts/ # Optional: executable scripts β”œβ”€β”€ templates/ # Optional: template folder └── references/ # Optional: reference documents
                      

                      Parsing flow:Parsing flow:

                      text
                      β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Claude Code startup β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β–Ό β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Scan ~/.claude/skills/ and .claude/skills/ directories β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β–Ό β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Use the gray-matter library to parse each SKILL.md β”‚ β”‚ YAML frontmatter β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β–Ό β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Validate required fields (name and description) β”‚ β”‚ - name: max 64 characters, only lowercase letters, β”‚ β”‚ numbers, and hyphens β”‚ β”‚ - description: used for LLM automatic matching β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β–Ό β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Extract metadata and build the Skill list β”‚ β”‚ (only load name + description, not the full body) β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      

                      Example of the full execution flowExample of the full execution flow

                      Let's look at the entire flow through a concrete example:Let's look at the entire flow through a concrete example:

                      text
                      User: "Help me analyze this PDF file" ═══════════════════════════════════════════════════════════════ Step 1: LLM decision ──────────────── Claude finds the description of the "pdf" skill in the Skill list: description: "Analyze PDF document content, extract text, generate a summary" ═══════════════════════════════════════════════════════════════ Step 2: System intervention ──────────────── Claude Code executes: 1. Read ~/.claude/skills/pdf/SKILL.md 2. Generate a visible message: "The pdf skill is loading" 3. Generate a hidden meta-message: the full SKILL.md content 4. Modify session permissions: allowed-tools = ["Bash(pdftotext:*)"] ═══════════════════════════════════════════════════════════════ Step 3: LLM execution ──────────────── Now Claude's context contains: - the original user request - the PDF expert workflow instructions - access permission to the pdftotext tool Claude executes: 1. Use pdftotext to extract the PDF text 2. Analyze the content structure 3. Generate a summary report 4. Present the result to the user ═══════════════════════════════════════════════════════════════ Step 4: Dispose after use ──────────────── After the task is completed, the full Skill content is removed from context (only the conversation history remains, not the full Skill instruction)
                      

                      Core design innovationsCore design innovations

                      InnovationTraditional approachSkills approachAdvantage
                      Source of capabilityFixed in model weightsDynamically loaded promptsExtensible and updatable
                      Token efficiencyAll capabilities always stay in memoryLoad on demandSave 80%+ tokens
                      Knowledge managementScattered in conversation historyModular file systemVersion-controllable and shareable
                      LifecycleContinuously occupies spaceDispose after useCleaner context

                      Academic foundationsAcademic foundations

                      The design of Claude Skills draws on the following research:The design of Claude Skills draws on the following research:

                      Research fieldRepresentative workApplied here as
                      Reinforcement learningVoyager (2023)The idea of accumulating a skill library
                      Cognitive architectureACT-R, SoarSeparation of procedural memory and declarative memory
                      Hierarchical policyOptions FrameworkThree-layer progressive loading

                      Core shift in thinking:Core shift in thinking:

                      text
                      Traditional: AI needs to remember everything ↓ Skills: AI knows where to find specialized knowledge ↓ Result: more like the thinking pattern of a human expert
                      

                      Relationship to the Agent Skills standardRelationship to the Agent Skills standard

                      Claude Skills follows the [Agent Skills open standard](https://agentskills.io/), which means:Claude Skills follows the [Agent Skills open standard](https://agentskills.io/), which means:

                      • βœ… Cross-platform compatibility: tools such as Cursor, Windsurf, and Aider also support itβœ… Cross-platform compatibility: tools such as Cursor, Windsurf, and Aider also support it
                      • βœ… Unified file format: standardized SKILL.md structureβœ… Unified file format: standardized SKILL.md structure
                      • βœ… Interoperability: Skills can be shared across different toolsβœ… Interoperability: Skills can be shared across different tools
                      text
                      Agent Skills standard defines: β”œβ”€β”€ Required: SKILL.md file (metadata + instructions) β”œβ”€β”€ Optional: scripts/ (executable code) β”œβ”€β”€ Optional: references/ (knowledge base documents) └── Optional: assets/ (templates and resources)
                      

                      Summary: why is this design brilliant?Summary: why is this design brilliant?

                      1. Decouples capability from the model: specialized knowledge no longer depends on model training and can be updated at any time through Markdown filesDecouples capability from the model: specialized knowledge no longer depends on model training and can be updated at any time through Markdown files
                        1. Extreme token efficiency: the three-layer loading mechanism ensures only necessary content is loadedExtreme token efficiency: the three-layer loading mechanism ensures only necessary content is loaded
                          1. Uses the LLM's own strengths: routing and matching rely entirely on Claude's language understanding, with no extra algorithm requiredUses the LLM's own strengths: routing and matching rely entirely on Claude's language understanding, with no extra algorithm required
                            1. Developer-friendly: creating a Skill only requires writing Markdown, not programmingDeveloper-friendly: creating a Skill only requires writing Markdown, not programming
                              1. Composable: Skills can reference and combine with each other to form complex workflowsComposable: Skills can reference and combine with each other to form complex workflows
                                1. Dispose after use: automatically cleans up after completion and keeps context freshDispose after use: automatically cleans up after completion and keeps context fresh
                                2. ------

                                  SummarySummary

                                  Skills are the key to turning Claude Code from a "general assistant" into a "team expert."Skills are the key to turning Claude Code from a "general assistant" into a "team expert."

                                  Through Skills, you can:Through Skills, you can:

                                  • standardize workflowsstandardize workflows
                                  • reuse team knowledgereuse team knowledge
                                  • improve collaboration efficiencyimprove collaboration efficiency
                                  • reduce repeated explanationreduce repeated explanation

                                  Remember: if you find yourself repeating the same instruction twice, you should consider creating a Skill.Remember: if you find yourself repeating the same instruction twice, you should consider creating a Skill.

                                  Now go create your first Skill.Now go create your first Skill.