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.

主な機能

4 GitHub stars
Support for executable scripts and on-demand reference documentation
Progressive disclosure patterns to optimize token usage and context window performance
Comprehensive validation checklist for publishing high-quality agent skills
Strategic guidance on categorizing skills into developer-facing and user-facing domains
Standardized SKILL.md structure with mandatory frontmatter and metadata

ユースケース

Optimizing agent instructions to reduce latency and improve command accuracy
Building custom AI skills to automate complex B2C Commerce Cloud development patterns
Standardizing documentation and command patterns across distributed engineering teams

概要

主な機能

4 GitHub stars
Support for executable scripts and on-demand reference documentation
Progressive disclosure patterns to optimize token usage and context window performance
Comprehensive validation checklist for publishing high-quality agent skills
Strategic guidance on categorizing skills into developer-facing and user-facing domains
Standardized SKILL.md structure with mandatory frontmatter and metadata

ユースケース

Optimizing agent instructions to reduce latency and improve command accuracy
Building custom AI skills to automate complex B2C Commerce Cloud development patterns
Standardizing documentation and command patterns across distributed engineering teams