Where should I store developer-specific skills?

Skills intended for contributors working on a specific codebase should be placed in the .claude/skills/ directory.

Can I run code within a Claude Skill?

Yes, you can include an optional scripts/ directory containing executable code like shell scripts, Python, or JavaScript that agents can run to perform tasks.

What is a Claude Code Skill?

A Claude Code Skill is a specialized capability that provides domain-specific guidance, implementation patterns, and instructions to enhance an AI agent's performance on specific tasks.

How do I optimize the token budget for a skill?

Use progressive disclosure by keeping the main SKILL.md under 500 lines and moving detailed content to the references folder to be loaded only when needed.

What are the required files for a skill?

Every skill requires a folder containing a SKILL.md file with name and description frontmatter, though it can optionally include scripts, assets, and references.

Claude Skill Authoring

Name: Claude Skill Authoring
Author: SalesforceCommerceCloud

bySalesforceCommerceCloud

•

学习与文档

Guides developers through the process of creating, structuring, and optimizing high-performance user-facing skills for Claude Code agents.

The Claude Skill Authoring framework provides a standardized methodology for building specialized capabilities that enhance AI agent behavior. It establishes a clear directory structure for metadata, executable scripts, and documentation, while introducing progressive disclosure patterns to manage token budgets effectively. By following these guidelines, developers can ensure their agents remain efficient and context-aware, making it an essential tool for anyone creating custom agentic workflows or domain-specific developer tooling.

主要功能

014 GitHub stars

02Support for executable scripts and on-demand reference documentation

03Progressive disclosure patterns to optimize token usage and context window performance

04Comprehensive validation checklist for publishing high-quality agent skills

05Strategic guidance on categorizing skills into developer-facing and user-facing domains

06Standardized SKILL.md structure with mandatory frontmatter and metadata

使用场景

01Optimizing agent instructions to reduce latency and improve command accuracy

02Building custom AI skills to automate complex B2C Commerce Cloud development patterns

03Standardizing documentation and command patterns across distributed engineering teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add salesforcecommercecloud/b2c-developer-tooling skill-authoring

For use in Claude.ai and ChatGPT

Download Skill