Improve project onboarding and CI

Author: Evan1108-Coder

.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+    branches: ["**"]
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  validate-skill:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Validate skill structure
+        run: node scripts/validate-skill.mjs

README.md

@@ -27,6 +27,22 @@ These visuals are generated from the actual repository structure and project wor
 
 Use this when an AI coding agent needs to understand a repo before editing, reviewing, testing, documenting, or designing.
 
+## Why Use This Skill?
+
+- Gives the agent factual project context before it starts changing files.
+- Separates code, design, docs, and testing lenses so scans can stay focused.
+- Reduces repeated manual explanations about stack, structure, conventions, and architecture.
+- Makes review and implementation prompts more grounded in the actual repository.
+
+## Quick Start
+
+```bash
+mkdir -p ~/.claude/skills
+git clone -b master-skill https://github.com/Evan1108-Coder/Project-Context-Review-Skill-Claude-Codex.git ~/.claude/skills/project-context-review
+```
+
+For project-local Claude Code installation, Codex usage, and Claude.ai import notes, see [Installation](#installation).
+
 ## Best Use Cases
 
 - Before implementing a feature in an unfamiliar codebase.
@@ -187,4 +203,4 @@ node scripts/validate-skill.mjs
 
 ## License
 
-MIT. See [LICENSE](LICENSE).
+MIT. See [LICENSE](LICENSE).