accessibility-baseline

SKILL.MD — Modular AI Assistant Engineering Skills

A cross-platform scaffolding toolkit and catalog of curated engineering skills for AI coding assistants (Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI / Antigravity, OpenAI Codex, Zed, and more).

Whether you are an enterprise team enforcing strict quality gates or a vibe coder building fast prototypes, SKILL.MD provides modular, task-triggered behavioral guidelines that activate only when relevant—keeping assistant context windows lean, focused, and effective.

---

Quickstart

You can initialize skills directly into any project from the public GitHub repository, or clone the repository to run locally.

🌐 Option 1: Direct from Public Repo (No Clone Needed)

Run directly from inside your project repository without cloning:

Windows (PowerShell)

# Initialize Claude Code skills (default) in current project
irm https://raw.githubusercontent.com/JustinANelson/SKILL.MD/master/init-skills.ps1 | iex

# Initialize for Cursor (.cursor/rules/*.mdc)
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/JustinANelson/SKILL.MD/master/init-skills.ps1))) -Tool cursor

# Initialize for all supported assistants with overwrite
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/JustinANelson/SKILL.MD/master/init-skills.ps1))) -Tool all -Force

# Target a specific directory
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/JustinANelson/SKILL.MD/master/init-skills.ps1))) -Target "C:\path\to\my-app" -Tool cursor

macOS / Linux / WSL (Bash / Zsh)

# Initialize Claude Code skills (default) in current project
curl -fsSL https://raw.githubusercontent.com/JustinANelson/SKILL.MD/master/init-skills.sh | bash

# Initialize for Cursor (.cursor/rules/*.mdc)
curl -fsSL https://raw.githubusercontent.com/JustinANelson/SKILL.MD/master/init-skills.sh | bash -s -- --tool cursor

# Initialize for all supported assistants with overwrite
curl -fsSL https://raw.githubusercontent.com/JustinANelson/SKILL.MD/master/init-skills.sh | bash -s -- --tool all --force

# Target a specific directory
curl -fsSL https://raw.githubusercontent.com/JustinANelson/SKILL.MD/master/init-skills.sh | bash -s -- /path/to/my-app --tool cursor

[!TIP] Windows Users in PowerShell: Use the PowerShell commands under Windows (PowerShell) above. In Windows PowerShell, curl is aliased to Invoke-WebRequest (which does not accept -fsSL). If you are running Bash/WSL from PowerShell, invoke curl.exe explicitly (e.g. curl.exe -fsSL ... | bash).

---

💻 Option 2: Run from Local Repository

Clone or download this repository, then run the initializer targeting your project directory:

git clone https://github.com/JustinANelson/SKILL.MD.git
cd SKILL.MD

Windows (PowerShell / CMD)

# Initialize Claude Code skills in current directory
.\init-skills.ps1

# Initialize for Cursor (.cursor/rules/*.mdc) targeting your app
.\init-skills.ps1 -Target "C:\path\to\my-app" -Tool cursor

# Initialize for all supported assistants with overwrite
.\init-skills.ps1 -Target "C:\path\to\my-app" -Tool all -Force

You can also run directly from Command Prompt via init-skills.bat:

init-skills.bat "C:\path\to\my-app" --tool all

macOS / Linux / WSL (Bash / Zsh)

# Make script executable (first time only)
chmod +x init-skills.sh

# Initialize Claude Code skills in current directory
./init-skills.sh

# Initialize for a specific tool and target
./init-skills.sh /path/to/my-app --tool copilot

# List all available skills
./init-skills.sh --list

---

Supported AI Assistants & Formats

Using the --tool flag, you can scaffold formats tailored to each assistant's native configuration:

See templates/AI-TOOL-LOCATIONS.md for full details on each tool's configuration paths.

---

Skill Catalog (43 Total Skills)

🎨 Vibe Coder Essentials (10 Skills)

Designed to solve the most common frustrations and traps when building apps by prompting. Install with --category vibe-coder-essentials.

🛡️ Core Engineering Gates (8 Skills)

Industry-standard software engineering practices, static analysis, and quality baselines. Install with --category core-engineering-gates.