apply-anthropic-skill-best-practices

Name: apply-anthropic-skill-best-practices
Author: NeoLabHQ

847installs132forks

How to install apply-anthropic-skill-best-practices?

neolabhq/context-engineering-kit/apply-anthropic-skill-best-practices

$npx -y skills add NeoLabHQ/context-engineering-kit --skill apply-anthropic-skill-best-practices

Installs into the current project.

Summary

Comprehensive guide for skill development based on Anthropic's official best practices - use for complex skills requiring detailed structure

Files · 1

View on GitHub

SKILL.md

1	# Anthropic's official skill authoring best practices
2
3	Apply Anthropic's official skill authoring best practices to your skill.
4
5	Good Skills are concise, well-structured, and tested with real usage. This guide provides practical authoring decisions to help you write Skills that Claude can discover and use effectively.
6
7	## Core principles
8
9	### Skill Metadata
10
11	Not every token in your Skill has an immediate cost. At startup, only the metadata (name and description) from all Skills is pre-loaded. Claude reads SKILL.md only when the Skill becomes relevant, and reads additional files only as needed. However, being concise in SKILL.md still matters: once Claude loads it, every token competes with conversation history and other context.
12
13	### Test with all models you plan to use
14
15	Skills act as additions to models, so effectiveness depends on the underlying model. Test your Skill with all the models you plan to use it with.
16
17	Testing considerations by model:
18
19	- Claude Haiku (fast, economical): Does the Skill provide enough guidance?
20	- Claude Sonnet (balanced): Is the Skill clear and efficient?
21	- Claude Opus (powerful reasoning): Does the Skill avoid over-explaining?
22
23	What works perfectly for Opus might need more detail for Haiku. If you plan to use your Skill across multiple models, aim for instructions that work well with all of them.
24
25	## Skill structure
26
27	<Note>
28	YAML Frontmatter: The SKILL.md frontmatter supports two fields:
29
30	- `name` - Human-readable name of the Skill (64 characters maximum)
31	- `description` - One-line description of what the Skill does and when to use it (1024 characters maximum)
32
33	For complete Skill structure details, see the [Skills overview](docs.claude.com/en/docs/agents-and-tools/agent-skills/overview#skill-structure).
34	</Note>
35
36	### Naming conventions
37
38	Use consistent naming patterns to make Skills easier to reference and discuss. We recommend using gerund form (verb + -ing) for Skill names, as this clearly describes the activity or capability the Skill provides.
39
40	Good naming examples (gerund form):
41
42	- "Processing PDFs"
43	- "Analyzing spreadsheets"
44	- "Managing databases"
45	- "Testing code"
46	- "Writing documentation"
47
48	Acceptable alternatives:
49
50	- Noun phrases: "PDF Processing", "Spreadsheet Analysis"
51	- Action-oriented: "Process PDFs", "Analyze Spreadsheets"
52
53	Avoid:
54
55	- Vague names: "Helper", "Utils", "Tools"
56	- Overly generic: "Documents", "Data", "Files"
57	- Inconsistent patterns within your skill collection
58
59	Consistent naming makes it easier to:
60
61	- Reference Skills in documentation and conversations
62	- Understand what a Skill does at a glance
63	- Organize and search through multiple Skills
64	- Maintain a professional, cohesive skill library
65
66	### Writing effective descriptions
67
68	The `description` field enables Skill discovery and should include both what the Skill does and when to use it.
69
70	<Warning>
71	Always write in third person. The description is injected into the system prompt, and inconsistent point-of-view can cause discovery problems.
72
73	- Good: "Processes Excel files and generates reports"
74	- Avoid: "I can help you process Excel files"
75	- Avoid: "You can use this to process Excel files"
76	</Warning>
77
78	Be specific and include key terms. Include both what the Skill does and specific triggers/contexts for when to use it.
79
80	Each Skill has exactly one description field. The description is critical for skill selection: Claude uses it to choose the right Skill from potentially 100+ available Skills. Your description must provide enough detail for Claude to know when to select this Skill, while the rest of SKILL.md provides the implementation details.
81
82	Effective examples:
83
84	PDF Processing skill:
85
86	```yaml theme={null}
87	description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
88	```
89
90	Excel Analysis skill:
91
92	```yaml theme={null}
93	description: Analyze Excel spreadsheets, create pivot tables, generate charts. Use when analyzing Excel files, spreadsheets, tabular data, or .xlsx files.
94	```
95
96	Git Commit Helper skill:
97
98	```yaml theme={null}
99	description: Generate descriptive commit messages by analyzing git diffs. Use when the user asks for help writing commit messages or reviewing staged changes.
100	```
101
102	Avoid vague descriptions like these:
103
104	```yaml theme={null}
105	description: Helps with documents
106	```
107
108	```yaml theme={null}
109	description: Processes data
110	```
111
112	```yaml theme={null}
113	description: Does stuff with files
114	```
115
116	### Progressive disclosure patterns
117
118	SKILL.md serves as an overview that points Claude to detailed materials as needed, like a table of contents in an onboarding guide.

People who liked this also viewed

6 picks

Type

apply-anthropic-skill-best-practices

847installs132forks

View on GitHub

How to install apply-anthropic-skill-best-practices?

neolabhq/context-engineering-kit/apply-anthropic-skill-best-practices

$npx -y skills add NeoLabHQ/context-engineering-kit --skill apply-anthropic-skill-best-practices

Installs into the current project.

Summary

Comprehensive guide for skill development based on Anthropic's official best practices - use for complex skills requiring detailed structure

Files · 1

View on GitHub

SKILL.md

1	# Anthropic's official skill authoring best practices
2
3	Apply Anthropic's official skill authoring best practices to your skill.
4
5	Good Skills are concise, well-structured, and tested with real usage. This guide provides practical authoring decisions to help you write Skills that Claude can discover and use effectively.
6
7	## Core principles
8
9	### Skill Metadata
10
11	Not every token in your Skill has an immediate cost. At startup, only the metadata (name and description) from all Skills is pre-loaded. Claude reads SKILL.md only when the Skill becomes relevant, and reads additional files only as needed. However, being concise in SKILL.md still matters: once Claude loads it, every token competes with conversation history and other context.
12
13	### Test with all models you plan to use
14
15	Skills act as additions to models, so effectiveness depends on the underlying model. Test your Skill with all the models you plan to use it with.
16
17	Testing considerations by model:
18
19	- Claude Haiku (fast, economical): Does the Skill provide enough guidance?
20	- Claude Sonnet (balanced): Is the Skill clear and efficient?
21	- Claude Opus (powerful reasoning): Does the Skill avoid over-explaining?
22
23	What works perfectly for Opus might need more detail for Haiku. If you plan to use your Skill across multiple models, aim for instructions that work well with all of them.
24
25	## Skill structure
26
27	<Note>
28	YAML Frontmatter: The SKILL.md frontmatter supports two fields:
29
30	- `name` - Human-readable name of the Skill (64 characters maximum)
31	- `description` - One-line description of what the Skill does and when to use it (1024 characters maximum)
32
33	For complete Skill structure details, see the [Skills overview](docs.claude.com/en/docs/agents-and-tools/agent-skills/overview#skill-structure).
34	</Note>
35
36	### Naming conventions
37
38	Use consistent naming patterns to make Skills easier to reference and discuss. We recommend using gerund form (verb + -ing) for Skill names, as this clearly describes the activity or capability the Skill provides.
39
40	Good naming examples (gerund form):
41
42	- "Processing PDFs"
43	- "Analyzing spreadsheets"
44	- "Managing databases"
45	- "Testing code"
46	- "Writing documentation"
47
48	Acceptable alternatives:
49
50	- Noun phrases: "PDF Processing", "Spreadsheet Analysis"
51	- Action-oriented: "Process PDFs", "Analyze Spreadsheets"
52
53	Avoid:
54
55	- Vague names: "Helper", "Utils", "Tools"
56	- Overly generic: "Documents", "Data", "Files"
57	- Inconsistent patterns within your skill collection
58
59	Consistent naming makes it easier to:
60
61	- Reference Skills in documentation and conversations
62	- Understand what a Skill does at a glance
63	- Organize and search through multiple Skills
64	- Maintain a professional, cohesive skill library
65
66	### Writing effective descriptions
67
68	The `description` field enables Skill discovery and should include both what the Skill does and when to use it.
69
70	<Warning>
71	Always write in third person. The description is injected into the system prompt, and inconsistent point-of-view can cause discovery problems.
72
73	- Good: "Processes Excel files and generates reports"
74	- Avoid: "I can help you process Excel files"
75	- Avoid: "You can use this to process Excel files"
76	</Warning>
77
78	Be specific and include key terms. Include both what the Skill does and specific triggers/contexts for when to use it.
79
80	Each Skill has exactly one description field. The description is critical for skill selection: Claude uses it to choose the right Skill from potentially 100+ available Skills. Your description must provide enough detail for Claude to know when to select this Skill, while the rest of SKILL.md provides the implementation details.
81
82	Effective examples:
83
84	PDF Processing skill:
85
86	```yaml theme={null}
87	description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
88	```
89
90	Excel Analysis skill:
91
92	```yaml theme={null}
93	description: Analyze Excel spreadsheets, create pivot tables, generate charts. Use when analyzing Excel files, spreadsheets, tabular data, or .xlsx files.
94	```
95
96	Git Commit Helper skill:
97
98	```yaml theme={null}
99	description: Generate descriptive commit messages by analyzing git diffs. Use when the user asks for help writing commit messages or reviewing staged changes.
100	```
101
102	Avoid vague descriptions like these:
103
104	```yaml theme={null}
105	description: Helps with documents
106	```
107
108	```yaml theme={null}
109	description: Processes data
110	```
111
112	```yaml theme={null}
113	description: Does stuff with files
114	```
115
116	### Progressive disclosure patterns
117
118	SKILL.md serves as an overview that points Claude to detailed materials as needed, like a table of contents in an onboarding guide.

People who liked this also viewed

6 picks

Type