Initial commit

hooks/hooks.json

@@ -0,0 +1,14 @@
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/skill-activation-prompt.ts"
+          }
+        ]
+      }
+    ]
+  }
+}

hooks/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@skill-activation/hooks",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Hook scripts for skill-activation plugin",
+  "private": true,
+  "scripts": {
+    "test": "echo '{ \"prompt\": \"help me write a test\", \"cwd\": \".\", \"session_id\": \"test\", \"transcript_path\": \"/tmp/test\", \"permission_mode\": \"auto\" }' | npx tsx scripts/skill-activation-prompt.ts"
+  },
+  "dependencies": {
+    "tsx": "^4.19.2"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.7.2"
+  }
+}

hooks/scripts/skill-activation-prompt.ts

@@ -0,0 +1,387 @@
+#!/usr/bin/env node
+
+import { accessSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+interface HookInput {
+  session_id: string;
+  transcript_path: string;
+  cwd: string;
+  permission_mode: string;
+  prompt: string;
+}
+
+interface PromptTriggers {
+  keywords?: string[];
+  intentPatterns?: string[];
+}
+
+interface FileTriggers {
+  pathPatterns?: string[];
+  pathExclusions?: string[];
+  contentPatterns?: string[];
+}
+
+interface SkipConditions {
+  sessionSkillUsed?: boolean;
+  fileMarkers?: string[];
+  envOverride?: string;
+}
+
+interface SkillRule {
+  type: 'guardrail' | 'domain';
+  enforcement: 'block' | 'suggest' | 'warn';
+  priority: 'critical' | 'high' | 'medium' | 'low';
+  description?: string;
+  promptTriggers?: PromptTriggers;
+  fileTriggers?: FileTriggers;
+  blockMessage?: string;
+  skipConditions?: SkipConditions;
+}
+
+interface SkillRules {
+  version: string;
+  description?: string;
+  skills: Record<string, SkillRule>;
+  notes?: Record<string, any>;
+}
+
+interface InstalledPlugin {
+  version: string;
+  installedAt: string;
+  lastUpdated: string;
+  installPath: string;
+  gitCommitSha?: string;
+  isLocal?: boolean;
+}
+
+interface InstalledPlugins {
+  version: number;
+  plugins: Record<string, InstalledPlugin>;
+}
+
+interface MatchedSkill {
+  name: string;
+  displayName: string;
+  matchType: 'keyword' | 'intent';
+  config: SkillRule;
+  skillPath: string | null;
+}
+
+/**
+ * Parse a skill reference in format "plugin@marketplace:skill-name" Returns
+ * null if the reference is in legacy format (no plugin qualifier)
+ */
+function parseSkillRef(
+  skillRef: string,
+): { pluginId: string; skillName: string } | null {
+  const match = skillRef.match(/^(.+?)@(.+?):(.+)$/);
+  if (!match) {
+    return null; // Legacy format (local project skill)
+  }
+  const [, pluginName, marketplace, skillName] = match;
+  return {
+    pluginId: `${pluginName}@${marketplace}`,
+    skillName: skillName!,
+  };
+}
+
+/**
+ * Resolve a skill reference to an absolute file path Returns null if:
+ *
+ * - Plugin is not installed
+ * - Skill file doesn't exist in the plugin
+ *
+ * For legacy format (no plugin qualifier), looks in project .claude/skills/
+ */
+function resolveSkillPath(
+  skillRef: string,
+  installedPlugins: InstalledPlugins,
+): string | null {
+  const parsed = parseSkillRef(skillRef);
+
+  if (!parsed) {
+    // Legacy format: local project skill
+    const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+    const skillPath = join(
+      projectDir,
+      '.claude',
+      'skills',
+      skillRef,
+      'SKILL.md',
+    );
+
+    try {
+      accessSync(skillPath);
+      return skillPath;
+    } catch {
+      return null;
+    }
+  }
+
+  const { pluginId, skillName } = parsed;
+
+  // Check if plugin is installed
+  const plugin = installedPlugins.plugins[pluginId];
+  if (!plugin) {
+    return null; // Plugin not installed - gracefully skip
+  }
+
+  // Construct skill path
+  const skillPath = join(plugin.installPath, 'skills', skillName, 'SKILL.md');
+
+  // Verify skill exists
+  try {
+    accessSync(skillPath);
+    return skillPath;
+  } catch {
+    return null; // Skill doesn't exist - gracefully skip
+  }
+}
+
+/**
+ * Load installed plugins metadata from Claude's global config
+ */
+function loadInstalledPlugins(): InstalledPlugins {
+  const pluginsPath = join(
+    homedir(),
+    '.claude',
+    'plugins',
+    'installed_plugins.json',
+  );
+
+  try {
+    const content = readFileSync(pluginsPath, 'utf-8');
+    return JSON.parse(content);
+  } catch (err) {
+    // If we can't read installed plugins, return empty structure
+    console.error('Warning: Could not load installed plugins:', err);
+    return { version: 1, plugins: {} };
+  }
+}
+
+/**
+ * Create a display name for the skill For plugin skills:
+ * "plugin-name:skill-name" For local skills: just "skill-name"
+ */
+const getDisplayName = (skillRef: string): string => {
+  const parsed = parseSkillRef(skillRef);
+  if (!parsed) {
+    return skillRef; // Legacy format
+  }
+
+  const { pluginId, skillName } = parsed;
+  // Extract just the plugin name (before @)
+  const pluginName = pluginId.split('@')[0];
+  return `${pluginName}:${skillName}`;
+};
+
+const loadSkillRules = (rulesPath: string): SkillRules | undefined => {
+  try {
+    accessSync(rulesPath);
+    const pluginRules: SkillRules = JSON.parse(
+      readFileSync(rulesPath, 'utf-8'),
+    );
+
+    return pluginRules;
+  } catch {}
+};
+
+/**
+ * Load and merge skill rules from all sources in priority order:
+ *
+ * 1. Plugin-defined rules (lowest priority - defaults)
+ * 2. Global user rules ~/.claude/skill-rules.json (middle priority)
+ * 3. Project rules .claude/skill-rules.json (highest priority)
+ *
+ * Higher priority rules override lower priority rules
+ */
+const loadAllSkillRules = (
+  installedPlugins: InstalledPlugins,
+  projectDir: string,
+): SkillRules => {
+  const mergedRules: SkillRules = {
+    version: '1.0',
+    skills: {},
+  };
+
+  // 1. Load plugin-defined rules (lowest priority - defaults)
+  let pluginRulesLoaded = 0;
+  for (const plugin of Object.values(installedPlugins.plugins)) {
+    const rulesPath = join(plugin.installPath, 'skills', 'skill-rules.json');
+
+    const pluginRules = loadSkillRules(rulesPath);
+    if (pluginRules) {
+      Object.assign(mergedRules.skills, pluginRules.skills);
+      pluginRulesLoaded++;
+    }
+  }
+
+  // 2. Load global user rules (middle priority - overrides plugin defaults)
+  let globalRulesLoaded = false;
+  const globalRulesPath = join(homedir(), '.claude', 'skill-rules.json');
+  const globalRules = loadSkillRules(globalRulesPath);
+  if (globalRules) {
+    Object.assign(mergedRules.skills, globalRules.skills);
+    globalRulesLoaded = true;
+  }
+
+  // 3. Load project rules (highest priority - overrides everything)
+  const projectRulesPath = join(projectDir, '.claude', 'skill-rules.json');
+  let projectRulesLoaded = false;
+  const projectRules = loadSkillRules(projectRulesPath);
+  if (projectRules) {
+    Object.assign(mergedRules.skills, projectRules.skills);
+    projectRulesLoaded = true;
+  }
+
+  // Debug info (only if no rules found at all)
+  if (pluginRulesLoaded === 0 && !globalRulesLoaded && !projectRulesLoaded) {
+    console.error(
+      'Warning: No skill rules found in plugins, global config, or project config',
+    );
+  }
+
+  return mergedRules;
+};
+
+const main = async () => {
+  // Read input from stdin
+  const input = readFileSync(0, 'utf-8');
+  const data: HookInput = JSON.parse(input);
+  const prompt = data.prompt.toLowerCase();
+
+  // Load installed plugins
+  const installedPlugins = loadInstalledPlugins();
+
+  // Get project directory
+  const projectDir = process.env.CLAUDE_PROJECT_DIR || data.cwd;
+
+  // Load and merge all skill rules
+  const rules = loadAllSkillRules(installedPlugins, projectDir);
+
+  const matchedSkills: MatchedSkill[] = [];
+
+  // Check each skill for matches
+  for (const [skillRef, config] of Object.entries(rules.skills)) {
+    const triggers = config.promptTriggers;
+    if (!triggers) {
+      continue;
+    }
+
+    let matched = false;
+    let matchType: 'keyword' | 'intent' = 'keyword';
+
+    // Keyword matching
+    if (triggers.keywords) {
+      const keywordMatch = triggers.keywords.some((kw) =>
+        prompt.includes(kw.toLowerCase()),
+      );
+      if (keywordMatch) {
+        matched = true;
+        matchType = 'keyword';
+      }
+    }
+
+    // Intent pattern matching (only if not already matched by keyword)
+    if (!matched && triggers.intentPatterns) {
+      const intentMatch = triggers.intentPatterns.some((pattern) => {
+        const regex = new RegExp(pattern, 'i');
+        return regex.test(prompt);
+      });
+      if (intentMatch) {
+        matched = true;
+        matchType = 'intent';
+      }
+    }
+
+    if (matched) {
+      // Resolve skill path
+      const skillPath = resolveSkillPath(skillRef, installedPlugins);
+
+      // Only skip if skill doesn't exist
+      // Still show in output but mark as unavailable
+      matchedSkills.push({
+        name: skillRef,
+        displayName: getDisplayName(skillRef),
+        matchType,
+        config,
+        skillPath,
+      });
+    }
+  }
+
+  // Generate output if matches found
+  if (matchedSkills.length > 0) {
+    let output = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n';
+    output += '🎯 SKILL ACTIVATION CHECK\n';
+    output += '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n';
+
+    // Group by priority
+    const critical = matchedSkills.filter(
+      (s) => s.config.priority === 'critical',
+    );
+    const high = matchedSkills.filter((s) => s.config.priority === 'high');
+    const medium = matchedSkills.filter((s) => s.config.priority === 'medium');
+    const low = matchedSkills.filter((s) => s.config.priority === 'low');
+
+    // Helper to format skill with availability status
+    const formatSkill = (s: MatchedSkill): string => {
+      if (s.skillPath === null) {
+        return `  → ${s.displayName} ⚠️ (plugin not installed)`;
+      }
+      return `  → ${s.displayName}`;
+    };
+
+    if (critical.length > 0) {
+      output += '⚠️ CRITICAL SKILLS (REQUIRED):\n';
+      critical.forEach((s) => (output += formatSkill(s) + '\n'));
+      output += '\n';
+    }
+
+    if (high.length > 0) {
+      output += '📚 RECOMMENDED SKILLS:\n';
+      high.forEach((s) => (output += formatSkill(s) + '\n'));
+      output += '\n';
+    }
+
+    if (medium.length > 0) {
+      output += '💡 SUGGESTED SKILLS:\n';
+      medium.forEach((s) => (output += formatSkill(s) + '\n'));
+      output += '\n';
+    }
+
+    if (low.length > 0) {
+      output += '📌 OPTIONAL SKILLS:\n';
+      low.forEach((s) => (output += formatSkill(s) + '\n'));
+      output += '\n';
+    }
+
+    // Check if any skills are unavailable
+    const unavailable = matchedSkills.filter((s) => s.skillPath === null);
+    if (unavailable.length > 0) {
+      output += '💡 TIP: Some skills require installing additional plugins\n';
+    }
+
+    output += 'ACTION: Use Skill tool BEFORE responding\n';
+    output += '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n';
+
+    // Output JSON for UserPromptSubmit hook
+    const hookOutput = {
+      systemMessage: output, // Displayed directly to the user
+      hookSpecificOutput: {
+        hookEventName: 'UserPromptSubmit',
+        additionalContext: output, // Added to Claude's context
+      },
+    };
+
+    console.log(JSON.stringify(hookOutput, null, 2));
+  }
+  // No output when no skills match (allow prompt to proceed normally)
+};
+
+main().catch((err) => {
+  console.error('Uncaught error:', err);
+  process.exitCode = 1;
+});