Summary
This PR adds CLAUDE.md, a comprehensive guidance document for AI assistants working with the Awesome Claude Skills repository. This file serves as a reference guide for understanding the project structure, skill anatomy, contribution workflows, and quality standards.
Key Changes
- New file:
CLAUDE.md — A 149-line guidance document covering:
- Project overview and repository structure
- Skill anatomy with YAML frontmatter requirements
- Bundled resources (scripts, references, assets)
- Languages used across the project
- Naming conventions and commit message styles
- Step-by-step guide for adding new skills
- README.md category organization
- Quality standards for all skills
- Key files reference table
- License information
Implementation Details
The document is structured to be:
- Scannable — Clear headings, tables, and code blocks for quick reference
- Comprehensive — Covers both high-level concepts and practical details
- Actionable — Includes concrete examples (naming patterns, commit messages, directory structure)
- Maintainer-friendly — Serves as a single source of truth for AI assistants contributing to or working with the repository
This enables AI assistants to quickly understand the project's conventions, structure, and quality expectations without needing to infer them from existing code or documentation.
https://claude.ai/code/session_01KCg6XZfEKRCL3TTaNCPUaU
@oleksiibarsuk-engchecks…claude/claude-md-mlaj771hiy2pc1g3-mQjTB → master1 files · +190 −0updated 4mo ago