72 72
73```yaml theme={null}73```yaml theme={null}
74---74---
75name: Your Skill Name75name: your-skill-name
76description: Brief description of what this Skill does and when to use it76description: Brief description of what this Skill does and when to use it
77---77---
78 78
85Show concrete examples of using this Skill.85Show concrete examples of using this Skill.
86```86```
87 87
88**Field requirements**:
89
90* `name`: Must use lowercase letters, numbers, and hyphens only (max 64 characters)
91* `description`: Brief description of what the Skill does and when to use it (max 1024 characters)
92
88The `description` field is critical for Claude to discover when to use your Skill. It should include both what the Skill does and when Claude should use it.93The `description` field is critical for Claude to discover when to use your Skill. It should include both what the Skill does and when Claude should use it.
89 94
90See the [best practices guide](/en/docs/agents-and-tools/agent-skills/best-practices) for complete authoring guidance.95See the [best practices guide](/en/docs/agents-and-tools/agent-skills/best-practices) for complete authoring guidance including validation rules.
91 96
92## Add supporting files97## Add supporting files
93 98
123 128
124```yaml theme={null}129```yaml theme={null}
125---130---
126name: Safe File Reader131name: safe-file-reader
127description: Read files without making changes. Use when you need read-only file access.132description: Read files without making changes. Use when you need read-only file access.
128allowed-tools: Read, Grep, Glob133allowed-tools: Read, Grep, Glob
129---134---
481 486
482```yaml theme={null}487```yaml theme={null}
483---488---
484name: Generating Commit Messages489name: generating-commit-messages
485description: Generates clear commit messages from git diffs. Use when writing commit messages or reviewing staged changes.490description: Generates clear commit messages from git diffs. Use when writing commit messages or reviewing staged changes.
486---491---
487 492
510 515
511```yaml theme={null}516```yaml theme={null}
512---517---
513name: Code Reviewer518name: code-reviewer
514description: Review code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.519description: Review code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
515allowed-tools: Read, Grep, Glob520allowed-tools: Read, Grep, Glob
516---521---
549 554
550````yaml theme={null}555````yaml theme={null}
551---556---
552name: PDF Processing557name: pdf-processing
553description: Extract text, fill forms, merge PDFs. Use when working with PDF files, forms, or document extraction. Requires pypdf and pdfplumber packages.558description: Extract text, fill forms, merge PDFs. Use when working with PDF files, forms, or document extraction. Requires pypdf and pdfplumber packages.
554---559---
555 560
592 Learn how Skills work across Claude products597 Learn how Skills work across Claude products
593 </Card>598 </Card>
594 599
600 <Card title="Use Skills in the Agent SDK" icon="cube" href="/en/api/agent-sdk/skills">
601 Use Skills programmatically with TypeScript and Python
602 </Card>
603
595 <Card title="Get started with Agent Skills" icon="rocket" href="/en/docs/agents-and-tools/agent-skills/quickstart">604 <Card title="Get started with Agent Skills" icon="rocket" href="/en/docs/agents-and-tools/agent-skills/quickstart">
596 Create your first Skill605 Create your first Skill
597 </Card>606 </Card>
