angular-doctor 1.1.3 → 1.2.0

package/README.md

@@ -40,6 +40,26 @@ npx -y angular-doctor@latest . --verbose
 
 ---
 
+## 🤖 Install for your coding agent
+
+Teach your coding agent to run Angular Doctor automatically after every Angular change:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/antonygiomarxdev/angular-doctor/main/install-skill.sh | bash
+```
+
+Supports **Cursor**, **Claude Code**, **Windsurf**, **Amp Code**, **Codex**, **Gemini CLI**, and **OpenCode**.
+
+Once installed, your agent will automatically run:
+
+```bash
+npx -y angular-doctor@latest . --verbose --diff
+```
+
+…after making Angular changes, catching issues before they reach review.
+
+---
+
 ## 🧭 Workspace support
 
 Angular Doctor automatically detects multiple projects:

package/dist/cli.mjs

@@ -1160,7 +1160,7 @@ const selectProjects = async (rootDirectory, projectFlag, skipPrompts) => {
 
 //#endregion
 //#region src/cli.ts
-const VERSION = "1.1.3";
+const VERSION = "1.2.0";
 const exitWithHint = () => {
 	logger.break();
 	logger.log("Cancelled.");

package/install-skill.sh

@@ -0,0 +1,181 @@
+#!/usr/bin/env bash
+# Installs the angular-doctor skill into your AI coding agent.
+# Supports: Cursor, Claude Code, Windsurf, Amp Code, Codex, Gemini CLI, OpenCode
+#
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/antonygiomarxdev/angular-doctor/main/install-skill.sh | bash
+
+set -euo pipefail
+
+SKILL_NAME="angular-doctor"
+SKILL_DESCRIPTION="Run after making Angular changes to catch issues early. Use when reviewing code, finishing a feature, or fixing bugs in an Angular project."
+SKILL_COMMAND="npx -y angular-doctor@latest . --verbose --diff"
+
+SKILL_BODY="# Angular Doctor
+
+Scans your Angular codebase for performance, correctness, and architecture issues. Outputs a 0-100 score with actionable diagnostics.
+
+## Usage
+
+\`\`\`bash
+${SKILL_COMMAND}
+\`\`\`
+
+## Workflow
+
+Run after making changes to catch issues early. Fix errors first, then re-run to verify the score improved."
+
+installed=0
+
+# ---------------------------------------------------------------------------
+# Cursor — .cursor/rules/angular-doctor.mdc
+# ---------------------------------------------------------------------------
+if [ -d ".cursor" ] || command -v cursor &>/dev/null; then
+  mkdir -p ".cursor/rules"
+  cat > ".cursor/rules/${SKILL_NAME}.mdc" <<EOF
+---
+description: ${SKILL_DESCRIPTION}
+globs:
+alwaysApply: false
+---
+
+${SKILL_BODY}
+EOF
+  echo "✓ Installed for Cursor (.cursor/rules/${SKILL_NAME}.mdc)"
+  installed=$((installed + 1))
+fi
+
+# ---------------------------------------------------------------------------
+# Claude Code — .claude/SKILL.md
+# ---------------------------------------------------------------------------
+if command -v claude &>/dev/null || [ -d ".claude" ]; then
+  mkdir -p ".claude"
+  cat > ".claude/${SKILL_NAME}.md" <<EOF
+---
+name: ${SKILL_NAME}
+description: ${SKILL_DESCRIPTION}
+---
+
+${SKILL_BODY}
+EOF
+  echo "✓ Installed for Claude Code (.claude/${SKILL_NAME}.md)"
+  installed=$((installed + 1))
+fi
+
+# ---------------------------------------------------------------------------
+# Windsurf — .windsurf/rules/angular-doctor.md
+# ---------------------------------------------------------------------------
+if [ -d ".windsurf" ] || command -v windsurf &>/dev/null; then
+  mkdir -p ".windsurf/rules"
+  cat > ".windsurf/rules/${SKILL_NAME}.md" <<EOF
+---
+description: ${SKILL_DESCRIPTION}
+---
+
+${SKILL_BODY}
+EOF
+  echo "✓ Installed for Windsurf (.windsurf/rules/${SKILL_NAME}.md)"
+  installed=$((installed + 1))
+fi
+
+# ---------------------------------------------------------------------------
+# Amp Code — .amp/skills/angular-doctor.md
+# ---------------------------------------------------------------------------
+if command -v amp &>/dev/null || [ -d ".amp" ]; then
+  mkdir -p ".amp/skills"
+  cat > ".amp/skills/${SKILL_NAME}.md" <<EOF
+---
+name: ${SKILL_NAME}
+description: ${SKILL_DESCRIPTION}
+---
+
+${SKILL_BODY}
+EOF
+  echo "✓ Installed for Amp Code (.amp/skills/${SKILL_NAME}.md)"
+  installed=$((installed + 1))
+fi
+
+# ---------------------------------------------------------------------------
+# Codex (OpenAI) — appended to AGENTS.md
+# ---------------------------------------------------------------------------
+if command -v codex &>/dev/null || [ -f "AGENTS.md" ]; then
+  AGENTS_ENTRY="
+## ${SKILL_NAME}
+
+${SKILL_DESCRIPTION}
+
+Run \`${SKILL_COMMAND}\` after making Angular changes.
+"
+  if [ -f "AGENTS.md" ]; then
+    if ! grep -q "${SKILL_NAME}" AGENTS.md 2>/dev/null; then
+      printf '\n%s' "${AGENTS_ENTRY}" >> AGENTS.md
+      echo "✓ Installed for Codex (appended to AGENTS.md)"
+      installed=$((installed + 1))
+    else
+      echo "  Codex: ${SKILL_NAME} already present in AGENTS.md, skipping."
+    fi
+  else
+    printf '%s' "${AGENTS_ENTRY}" > AGENTS.md
+    echo "✓ Installed for Codex (created AGENTS.md)"
+    installed=$((installed + 1))
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+# Gemini CLI — appended to GEMINI.md
+# ---------------------------------------------------------------------------
+if command -v gemini &>/dev/null || [ -f "GEMINI.md" ]; then
+  GEMINI_ENTRY="
+## ${SKILL_NAME}
+
+${SKILL_DESCRIPTION}
+
+Run \`${SKILL_COMMAND}\` after making Angular changes.
+"
+  if [ -f "GEMINI.md" ]; then
+    if ! grep -q "${SKILL_NAME}" GEMINI.md 2>/dev/null; then
+      printf '\n%s' "${GEMINI_ENTRY}" >> GEMINI.md
+      echo "✓ Installed for Gemini CLI (appended to GEMINI.md)"
+      installed=$((installed + 1))
+    else
+      echo "  Gemini CLI: ${SKILL_NAME} already present in GEMINI.md, skipping."
+    fi
+  else
+    printf '%s' "${GEMINI_ENTRY}" > GEMINI.md
+    echo "✓ Installed for Gemini CLI (created GEMINI.md)"
+    installed=$((installed + 1))
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+# OpenCode — .opencode/skills/angular-doctor.md
+# ---------------------------------------------------------------------------
+if command -v opencode &>/dev/null || [ -d ".opencode" ]; then
+  mkdir -p ".opencode/skills"
+  cat > ".opencode/skills/${SKILL_NAME}.md" <<EOF
+---
+name: ${SKILL_NAME}
+description: ${SKILL_DESCRIPTION}
+---
+
+${SKILL_BODY}
+EOF
+  echo "✓ Installed for OpenCode (.opencode/skills/${SKILL_NAME}.md)"
+  installed=$((installed + 1))
+fi
+
+# ---------------------------------------------------------------------------
+# Summary
+# ---------------------------------------------------------------------------
+echo ""
+if [ "${installed}" -eq 0 ]; then
+  echo "No supported AI coding agent detected in this directory."
+  echo ""
+  echo "Supported agents: Cursor, Claude Code, Windsurf, Amp Code, Codex, Gemini CLI, OpenCode"
+  echo ""
+  echo "To install manually, copy skills/angular-doctor/SKILL.md into your agent's rules directory."
+else
+  echo "angular-doctor skill installed for ${installed} agent(s)."
+  echo ""
+  echo "Your coding agent will now run angular-doctor automatically after Angular changes."
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-doctor",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "author": "Antony Giomar <antonygiomarx@gmail.com>",
   "description": "Diagnose and fix issues in your Angular app",
   "repository": {
@@ -16,7 +16,9 @@
   "bin": "bin/angular-doctor.js",
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "skills",
+    "install-skill.sh"
   ],
   "type": "module",
   "exports": {

package/skills/angular-doctor/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: angular-doctor
+description: Run after making Angular changes to catch issues early. Use when reviewing code, finishing a feature, or fixing bugs in an Angular project.
+version: 1.0.0
+---
+
+# Angular Doctor
+
+Scans your Angular codebase for performance, correctness, and architecture issues. Outputs a 0-100 score with actionable diagnostics.
+
+## Usage
+
+```bash
+npx -y angular-doctor@latest . --verbose --diff
+```
+
+## Workflow
+
+Run after making changes to catch issues early. Fix errors first, then re-run to verify the score improved.