Skip to content

Commit 5abf30e

Browse files
authored
Add author and notebook registry for cookbooks (anthropics#237)
initialize cookbook registry and author management system Add JSON schemas and YAML configurations for managing cookbook metadata and author information. This includes: - authors_schema.json: Schema for mapping GitHub usernames to author details - registry_schema.json: Schema for cookbook metadata with required fields (title, path, slug, category, github_url, authors, date) - authors.yml: Initial author mappings with Anthropic and contributors - registry.yaml: Comprehensive cookbook registry with 70+ entries across multiple categories (capabilities, patterns, tools, multimodal, etc.)
1 parent b29ec6f commit 5abf30e

File tree

7 files changed

+1033
-0
lines changed

7 files changed

+1033
-0
lines changed

.github/authors_schema.json

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
{
2+
"$schema": "http://json-schema.org/draft-07/schema#",
3+
"title": "Authors Schema",
4+
"description": "Schema for authors.yml - maps GitHub usernames to author details",
5+
"type": "object",
6+
"patternProperties": {
7+
"^[a-zA-Z0-9_-]+$": {
8+
"type": "object",
9+
"properties": {
10+
"name": {
11+
"type": "string",
12+
"description": "Full display name of the author"
13+
},
14+
"website": {
15+
"type": "string",
16+
"format": "uri",
17+
"description": "Author's website URL (optional)"
18+
},
19+
"avatar": {
20+
"type": "string",
21+
"format": "uri",
22+
"description": "Avatar image URL (optional, defaults to https://github.com/username.png)"
23+
}
24+
},
25+
"required": ["name"],
26+
"additionalProperties": false
27+
}
28+
},
29+
"additionalProperties": false
30+
}

.github/registry_schema.json

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
{
2+
"$schema": "http://json-schema.org/draft-07/schema#",
3+
"title": "Registry Schema",
4+
"description": "Schema for registry.yaml - cookbook metadata",
5+
"type": "array",
6+
"items": {
7+
"type": "object",
8+
"properties": {
9+
"title": {
10+
"type": "string",
11+
"description": "Title of the cookbook"
12+
},
13+
"description": {
14+
"type": "string",
15+
"description": "Brief description of the cookbook"
16+
},
17+
"path": {
18+
"type": "string",
19+
"description": "Path to the notebook file"
20+
},
21+
"slug": {
22+
"type": "string",
23+
"pattern": "^[a-z0-9-]+$",
24+
"description": "URL-friendly slug for the cookbook"
25+
},
26+
"categories": {
27+
"type": "array",
28+
"items": {
29+
"type": "string",
30+
"enum": [
31+
"Agent Patterns",
32+
"Claude Agent SDK",
33+
"Evals",
34+
"Fine-Tuning",
35+
"Multimodal",
36+
"Integrations",
37+
"Observability",
38+
"RAG & Retrieval",
39+
"Responses",
40+
"Skills",
41+
"Thinking",
42+
"Tools"
43+
]
44+
},
45+
"minItems": 1,
46+
"description": "Categories of the cookbook"
47+
},
48+
"github_url": {
49+
"type": "string",
50+
"format": "uri",
51+
"description": "GitHub URL to the notebook"
52+
},
53+
"authors": {
54+
"type": "array",
55+
"items": {
56+
"type": "string",
57+
"description": "GitHub username (must match keys in authors.yml)"
58+
},
59+
"minItems": 1,
60+
"description": "List of author GitHub usernames"
61+
},
62+
"date": {
63+
"type": "string",
64+
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
65+
"description": "Publication date in YYYY-MM-DD format"
66+
},
67+
"tags": {
68+
"type": "array",
69+
"items": {
70+
"type": "string"
71+
},
72+
"description": "Tags for the cookbook"
73+
},
74+
"difficulty": {
75+
"type": "string",
76+
"enum": ["beginner", "intermediate", "advanced", ""],
77+
"description": "Difficulty level (optional)"
78+
},
79+
"use_case": {
80+
"type": "string",
81+
"description": "Use case category (optional)"
82+
},
83+
"thumbnail": {
84+
"type": "string",
85+
"description": "Thumbnail image URL (optional)"
86+
},
87+
"archived": {
88+
"type": "boolean",
89+
"description": "Whether the cookbook is archived (optional, defaults to false)"
90+
}
91+
},
92+
"required": ["title", "path", "categories", "authors", "date"],
93+
"additionalProperties": false
94+
}
95+
}

0 commit comments

Comments
 (0)