feat: add codespell for markdown spell checking

.codespell-ignore.txt

@@ -0,0 +1,3 @@
+cna
+pre-select
+te

.codespellrc

@@ -0,0 +1,3 @@
+[codespell]
+skip = .git,*.json,*.svg,*.png,.validate,dist,eval,.codespellrc
+ignore-words = .codespell-ignore.txt

.github/workflows/spell-check.yml

@@ -0,0 +1,16 @@
+name: Spell Check
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main]
+
+jobs:
+  codespell:
+    if: github.event.pull_request.draft == false || github.event_name == 'push'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871 # v4.2.1
+
+      - uses: codespell-project/actions-codespell@406322ec52dd7b488e48c1c4b82e2a8b3a1bf630 # v2.1

.pre-commit-config.yaml

@@ -8,6 +8,12 @@ repos:
       # Uses gitleaks on PATH (install: brew install gitleaks, or run scripts/install-hooks.sh)
       - id: gitleaks-system
 
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.3
+    hooks:
+      - id: codespell
+        args: [--config, .codespellrc]
+
   - repo: local
     hooks:
       - id: make-validate

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help install validate validate-structure validate-collection-schema validate-collection-compliance validate-skill-design validate-skill-design-changed validate-mcp-tools package clean check-uv
+.PHONY: help install validate validate-structure validate-collection-schema validate-collection-compliance validate-skill-design validate-skill-design-changed validate-mcp-tools validate-spelling package clean check-uv
 
 help:
 	@echo "agentic-plugins"
@@ -12,6 +12,7 @@ help:
 	@echo "  validate-skill-design         - Validate all skills (use PACK=rh-sre for a specific pack)"
 	@echo "  validate-skill-design-changed - Validate only changed skills (staged + unstaged, for local dev)"
 	@echo "  validate-mcp-tools            - Validate allowed-tools against live MCP servers (requires podman)"
+	@echo "  validate-spelling             - Run codespell spell check on all files"
 	@echo "  package                       - Package skills into ZIPs (output: dist/)"
 	@echo "  clean                         - Remove generated files"
 	@echo ""
@@ -98,6 +99,11 @@ validate-mcp-tools: check-uv
 	@uv run python scripts/validate_mcp_tools.py $(if $(PACK),$(PACK))
 	@echo "MCP tool validation complete!"
 
+validate-spelling: check-uv
+	@echo "Running spell check with codespell..."
+	@uv run codespell
+	@echo "Spell check passed!"
+
 package: check-uv
 	@uv run python scripts/package_skills.py
 

pyproject.toml

@@ -11,5 +11,6 @@ dependencies = [
 
 [dependency-groups]
 dev = [
+    "codespell>=2.3.0",
     "pre-commit>=4.0.0",
 ]