suggest

Suggest Command

Intelligently suggest plugins and chains based on what you want to do.

User Communication: Be direct. Show suggestions immediately without explaining the matching process.

Usage

/chainer:suggest "<what you want to do>"

Examples

/chainer:suggest "plan and implement a login feature"
/chainer:suggest "review my code for security issues"
/chainer:suggest "create an isolated workspace for testing"

Instructions for Claude

When user invokes this command:

Step 1: Parse Input

Extract the description from the user's message (everything after /chainer:suggest).

If no description provided, show error:

❌ Please provide a description of what you want to do

Examples:
  /chainer:suggest "plan and build a feature"
  /chainer:suggest "review my code"
  /chainer:suggest "create isolated workspace"

Step 2: Load Registry

Read the plugin registry to get plugin metadata and keywords:

const registryPath = '${CLAUDE_PLUGIN_ROOT}/registry/plugins.yaml';
const registryContent = Read(registryPath);
const registry = parseYaml(registryContent);

If registry doesn't exist or can't be parsed:

❌ Could not load plugin registry

Expected location: ${CLAUDE_PLUGIN_ROOT}/registry/plugins.yaml

Step 3: Keyword Matching

Tokenize description:

1. Convert to lowercase
2. Split on spaces and punctuation
3. Remove common stop words: "the", "a", "an", "and", "or", "to", "for", "in", "on", "with", "my", "i", "want", "need"
4. Extract meaningful words (2+ characters)

Score each plugin:

const scores = {};
const matchDetails = {};

for (const [pluginName, plugin] of Object.entries(registry.plugins)) {
  if (!plugin.keywords) continue;

  let score = 0;
  const matches = [];

  for (const keyword of plugin.keywords) {
    const keywordLower = keyword.toLowerCase();

    // Direct match (highest score)
    if (descriptionTokens.includes(keywordLower)) {
      score += 10;
      matches.push(keyword);
    }
    // Partial match (medium score)
    else if (descriptionTokens.some(t => t.includes(keywordLower) || keywordLower.includes(t))) {
      score += 5;
      matches.push(keyword);
    }
  }

  if (score > 0) {
    scores[pluginName] = score;
    matchDetails[pluginName] = matches;
  }
}