Skip to content

Commit b6343e2

Browse files
erkcetclaude
erkcet
and
claude
committed
Upgrade to best-in-class awesome list with templates, hooks, and infrastructure
- Rewrite README.md with 22 sections grouped into 5 categories (982 lines) - Add 8 new CLAUDE.md templates: monorepo, rust, go, mobile, django, svelte, laravel, data-science - Fix duplicate post-tool-use key bug in hooks examples - Add new sections: Config Tools, Status Line, Plugins, Skills, Subagents, Multi-Agent Orchestration, Agent Teams, CI/CD, Usage Monitors, Security - Populate community projects (15+ repos), articles (8+), and videos - Add CC0-1.0 LICENSE file - Add GitHub issue templates (add-resource, broken-link) - Add weekly link check workflow (lychee) - Expand CONTRIBUTING.md with quality criteria and contribution categories - Expand PR template with category checkboxes Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent ef1451d commit b6343e2

15 files changed

Lines changed: 2002 additions & 217 deletions

File tree

‎.github/ISSUE_TEMPLATE/add-resource.yml‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
name: Suggest a Resource
2+
description: Suggest a tool, project, article, or other resource to add to the list.
3+
title: "[Resource] "
4+
labels: ["suggestion"]
5+
body:
6+
- type: dropdown
7+
id: category
8+
attributes:
9+
label: Category
10+
description: Which section does this resource belong to?
11+
options:
12+
- Community Project
13+
- MCP Server
14+
- CLAUDE.md Template
15+
- Hook Recipe
16+
- Article / Blog Post
17+
- Video / Tutorial
18+
- Workflow / Pattern
19+
- IDE Integration
20+
- Other
21+
validations:
22+
required: true
23+
- type: input
24+
id: name
25+
attributes:
26+
label: Resource Name
27+
placeholder: e.g., mcp-server-redis
28+
validations:
29+
required: true
30+
- type: input
31+
id: url
32+
attributes:
33+
label: URL
34+
placeholder: https://github.com/...
35+
validations:
36+
required: true
37+
- type: textarea
38+
id: description
39+
attributes:
40+
label: Description
41+
description: A one-line description (under 120 characters).
42+
placeholder: Redis integration for Claude Code via MCP.
43+
validations:
44+
required: true
45+
- type: textarea
46+
id: why
47+
attributes:
48+
label: Why should this be included?
49+
description: What makes this resource valuable? Is it actively maintained? Does it solve a unique problem?
50+
validations:
51+
required: false

‎.github/ISSUE_TEMPLATE/broken-link.yml‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
name: Report a Broken Link
2+
description: Report a dead or broken link in the list.
3+
title: "[Broken Link] "
4+
labels: ["broken-link"]
5+
body:
6+
- type: input
7+
id: url
8+
attributes:
9+
label: Broken URL
10+
description: The URL that is no longer working.
11+
placeholder: https://github.com/...
12+
validations:
13+
required: true
14+
- type: input
15+
id: section
16+
attributes:
17+
label: Section
18+
description: Which section of the README contains this link?
19+
placeholder: e.g., Community MCP Servers
20+
validations:
21+
required: true
22+
- type: dropdown
23+
id: type
24+
attributes:
25+
label: Issue Type
26+
options:
27+
- 404 Not Found
28+
- Repository deleted or archived
29+
- Domain expired
30+
- Redirects to unrelated page
31+
- Other
32+
validations:
33+
required: true
34+
- type: input
35+
id: replacement
36+
attributes:
37+
label: Suggested Replacement (optional)
38+
description: If you know an updated URL or a better alternative, please share it.
39+
placeholder: https://github.com/...
40+
validations:
41+
required: false

‎.github/pull_request_template.md‎

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,27 @@
22

33
<!-- Describe the resource(s) you're adding -->
44

5+
## Category
6+
7+
<!-- Check which section(s) your PR updates -->
8+
9+
- [ ] Official Resources
10+
- [ ] CLAUDE.md Template
11+
- [ ] MCP Server
12+
- [ ] Hook Recipe
13+
- [ ] Workflow / Pattern
14+
- [ ] Community Project
15+
- [ ] Article / Blog Post
16+
- [ ] Video / Tutorial
17+
- [ ] Other: <!-- describe -->
18+
519
## Checklist
620

721
- [ ] I have read the [contribution guidelines](../CONTRIBUTING.md)
822
- [ ] The resource is not a duplicate of an existing entry
923
- [ ] All links are working and accessible
10-
- [ ] Each entry has a concise description
11-
- [ ] Entries are placed in the correct section
12-
- [ ] Formatting matches existing entries
24+
- [ ] Each entry has a concise description (under 120 characters)
25+
- [ ] Entries are placed at the end of the correct section
26+
- [ ] Formatting matches existing entries: `- [Name](url) - Description.`
27+
- [ ] For projects: 100+ stars or unique use case
28+
- [ ] For templates: follows the established format with all standard sections

‎.github/workflows/links.yml‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
name: Check Links
2+
3+
on:
4+
push:
5+
branches: [main]
6+
paths:
7+
- "**.md"
8+
pull_request:
9+
branches: [main]
10+
paths:
11+
- "**.md"
12+
schedule:
13+
- cron: "0 9 * * 1" # Every Monday at 9 AM UTC
14+
workflow_dispatch:
15+
16+
jobs:
17+
linkcheck:
18+
runs-on: ubuntu-latest
19+
steps:
20+
- uses: actions/checkout@v4
21+
22+
- name: Check links with lychee
23+
uses: lycheeverse/lychee-action@v2
24+
with:
25+
args: >-
26+
--verbose
27+
--no-progress
28+
--accept 200,204,301,302,403,429
29+
--exclude-mail
30+
--exclude "^https://x\\.com"
31+
--exclude "^https://twitter\\.com"
32+
--exclude "^https://discord\\.gg"
33+
--exclude "^https://api\\.star-history\\.com"
34+
--timeout 30
35+
"README.md"
36+
"CONTRIBUTING.md"
37+
"templates/**/*.md"
38+
fail: true
39+
env:
40+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

‎CONTRIBUTING.md‎

Lines changed: 64 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,57 +1,91 @@
11
# Contributing to Awesome Claude Code
22

3-
Thanks for your interest in contributing! This list is community-driven, and every contribution helps.
3+
Thanks for your interest in contributing! This list is community-driven, and every contribution helps make it the best resource for Claude Code users.
44

5-
## Guidelines
5+
## What We Need
66

7-
### Adding a Resource
7+
| Category | Priority | Examples |
8+
|----------|----------|---------|
9+
| Community projects | High | Tools, CLIs, extensions built for Claude Code |
10+
| CLAUDE.md templates | High | Frameworks not yet covered (Elixir, C#/.NET, Vue, etc.) |
11+
| Hook recipes | High | Working hooks that solve real problems |
12+
| Articles & tutorials | Medium | Blog posts, guides, walkthroughs |
13+
| MCP servers | Medium | Community-built MCP server implementations |
14+
| Videos | Low | Video tutorials, demos, conference talks |
15+
| Workflow patterns | Low | Effective prompting strategies, automation scripts |
816

9-
1. Fork this repo.
10-
2. Create a branch: `git checkout -b add-resource-name`
11-
3. Add your resource to the appropriate section in `README.md`.
12-
4. Submit a pull request.
17+
## Quality Criteria
1318

14-
### What We're Looking For
19+
To keep this list useful and trustworthy, submissions must meet these standards:
1520

16-
- Tools, libraries, or servers that work with Claude Code.
17-
- Well-written articles or tutorials about Claude Code workflows.
18-
- CLAUDE.md templates for frameworks/stacks not yet covered.
19-
- Hook recipes that solve real problems.
20-
- Community projects built with Claude Code.
21+
### For Projects & Tools
22+
- **Active and maintained** — recent commits within the last 6 months, or stable/feature-complete.
23+
- **100+ GitHub stars OR unique use case** — popular projects are welcome, but niche tools that solve specific problems are too.
24+
- **Working and installable** — must have clear setup instructions and actually work.
25+
- **No spam or low-effort forks** — original work or significant improvements only.
2126

22-
### Quality Standards
27+
### For Articles & Tutorials
28+
- **Substantive content** — not just "I tried Claude Code and it's cool". Should teach something.
29+
- **Accurate and up-to-date** — outdated articles with deprecated commands will be removed.
30+
- **English language** — all content must be in English.
2331

24-
- **No duplicates.** Search existing entries before submitting.
25-
- **Working links.** All URLs must be live and accessible.
26-
- **Descriptions matter.** Every entry needs a concise, helpful description.
27-
- **English only.** All entries and descriptions should be in English.
28-
- **No self-promotion spam.** Your project is welcome if it's genuinely useful, but don't submit low-effort repos just for visibility.
32+
### For CLAUDE.md Templates
33+
- **Practical over theoretical** — based on real projects, not hypothetical structures.
34+
- **Follow the established format** — Project Overview, Commands table, Project Structure tree, Conventions, Environment Variables, Known Issues.
35+
- **Include explanatory comments** — help users understand and customize.
2936

30-
### Formatting
37+
## How to Contribute
3138

32-
Follow the existing format:
39+
### Adding a Resource
40+
41+
1. Fork this repo.
42+
2. Create a branch: `git checkout -b add-resource-name`.
43+
3. Add your resource to the appropriate section in `README.md`.
44+
4. Submit a pull request.
45+
46+
### Formatting Rules
47+
48+
Follow the existing format exactly:
3349

3450
```markdown
3551
- [Resource Name](https://link.to/resource) - One-line description ending with a period.
3652
```
3753

3854
- Use title case for resource names.
39-
- Descriptions should be one sentence, starting with a capital letter and ending with a period.
55+
- Descriptions: one sentence, starting with a capital letter, ending with a period.
4056
- Keep descriptions under 120 characters.
41-
- Place new entries at the end of the relevant section.
57+
- Place new entries at the **end** of the relevant section.
58+
- No star count badges or download stats on entries.
4259

43-
### CLAUDE.md Templates
44-
45-
If submitting a template:
60+
### Submitting a CLAUDE.md Template
4661

4762
1. Place it in `templates/claudemd/`.
4863
2. Name it after the framework/stack (e.g., `django.md`, `svelte.md`).
49-
3. Include comments explaining each section.
50-
4. Keep it practical — real-world over theoretical.
64+
3. Include the standard header: `# CLAUDE.md — [Framework] Template`.
65+
4. Include all standard sections (see existing templates for reference).
66+
5. Include comments explaining each section.
67+
68+
### Reporting Issues
69+
70+
- **Broken link?** [Open an issue](../../issues/new?template=broken-link.yml) or submit a PR to fix/remove it.
71+
- **Outdated resource?** Open an issue describing what's changed.
72+
- **Suggestion?** [Open a resource suggestion](../../issues/new?template=add-resource.yml).
73+
74+
## Link Validation
75+
76+
All links are automatically checked weekly via GitHub Actions. If a link is reported broken:
77+
78+
1. We'll try to find an updated URL.
79+
2. If the resource is gone, it will be removed.
80+
3. Archived/read-only repos are acceptable if the content is still valuable.
5181

52-
### Removals
82+
## Removals
5383

54-
If a link is broken or a project is abandoned, open an issue or submit a PR to remove it.
84+
Resources may be removed if they:
85+
- Have a broken link that can't be fixed.
86+
- Are abandoned with no activity for 12+ months and no longer work.
87+
- Are superseded by a better alternative.
88+
- Violate our quality criteria.
5589

5690
## Code of Conduct
5791

0 commit comments

Comments
 (0)