diff --git a/queries/README.md b/queries/README.md
new file mode 100644
index 0000000..c57abc2
--- /dev/null
+++ b/queries/README.md
@@ -0,0 +1,36 @@
+# Syntax Highlighting Queries
+
+This directory contains Tree-sitter query files for syntax highlighting.
+
+## Attribution
+
+These queries are derived from the [Helix editor](https://github.com/helix-editor/helix) project.
+
+Helix is licensed under the Mozilla Public License 2.0 (MPL-2.0).
+
+We are grateful to the Helix maintainers and contributors for their excellent work on comprehensive, well-tested Tree-sitter queries.
+
+## Structure
+
+Each language has its own subdirectory containing:
+
+- `highlights.scm` — Syntax highlighting queries
+- `injections.scm` — Language injection queries (e.g., bash in Nix strings)
+- `locals.scm` — Local variable scoping (where applicable)
+
+## Supported Languages
+
+- Bash / Shell
+- C
+- CSS
+- Go
+- HTML
+- JavaScript
+- JSON
+- Markdown
+- Nix
+- Python
+- Rust
+- TOML
+- TypeScript
+- YAML
diff --git a/themes/README.md b/themes/README.md
index 7bc9894..bce7bf4 100644
--- a/themes/README.md
+++ b/themes/README.md
@@ -2,6 +2,12 @@
 
 This directory contains CSS themes for sukr's syntax highlighting system.
 
+## Attribution
+
+These themes are adapted from the [Helix editor](https://github.com/helix-editor/helix) theme collection.
+
+Helix is licensed under the Mozilla Public License 2.0 (MPL-2.0). We are grateful to the Helix maintainers and contributors, as well as the original theme authors, for their excellent work.
+
 ## Available Themes
 
 | Theme                  | Description                  |