
skill-keyword-reminder
Automatically reminds Claude to load relevant skills when keyword triggers appear in user prompts
- version
- 1.2.1
- GitHub stars
- 14
Install
/plugin install skill-keyword-reminder@fprochazka-claude-code-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add fprochazka/claude-code-plugins.
Contents
Discovered from sourceAgents 1
Skill Keyword Reminder
Automatically reminds Claude to load relevant skills when keyword triggers appear in user prompts.
Overview
Claude Code skills are powerful, but Claude doesn't always remember to load them when they're relevant. You might ask about "Linear issues" and Claude forgets to invoke the linear skill first.
This plugin intercepts every user prompt via a UserPromptSubmit hook and scans for keywords defined in your skills. When a match is found, it injects a reminder into the context:
IMPORTANT: don't forget to load linear-mcp-cli skill and relevant references in it
How It Works
- User submits a prompt
UserPromptSubmithook triggersscan_skills.py- Script scans for
SKILL.mdfiles withtrigger-keywordsfrontmatter in:~/.claude/skills/*/SKILL.md(user-level skills)$CLAUDE_PROJECT_DIR/.claude/skills/*/SKILL.mdif env var is set- Otherwise,
.claude/skills/*/SKILL.mdwalking up from cwd to home
- If any keyword matches the prompt, injects a reminder via
additionalContext - Claude sees the reminder and loads the appropriate skill
Project-level skills take precedence over user-level skills with the same name.
If a skill directory contains a references/ subdirectory, the reminder also mentions to check references.
Smart deduplication: The plugin reads the current session transcript and skips reminders for skills that have already been loaded in this session.
Configuration
Add trigger-keywords to the YAML frontmatter of your SKILL.md files:
---
name: linear-mcp-cli
description: CLI for querying Linear issues and projects
trigger-keywords: linear, issue, issues, tasks, ticket, tickets
---
Note: The
trigger-keywordsattribute is non-standard and only recognized by this plugin. Claude Code may introduce its own keyword triggering mechanism in the future, which could make this plugin obsolete or require migration.
Keyword matching rules:
- Comma-separated list
- Case-insensitive matching
- Matched as whole words (e.g.,
linearmatches inlinear.appbut not innonlinear) - Multi-word keywords supported (e.g.,
deep research)
Example
Gemini Deep Research skill with trigger keywords:
# ~/.claude/skills/gemini-deep-research/SKILL.md
---
name: gemini-deep-research
trigger-keywords: deep research, deep dive, comprehensive analysis
---
Installation
From marketplace:
claude plugin marketplace add fprochazka/claude-code-plugins --scope user
claude plugin install skill-keyword-reminder@fprochazka-claude-code-plugins --scope user
Local testing:
claude --plugin-dir /path/to/plugins/skill-keyword-reminder
Requirements
- Python 3.10+
- No external dependencies (uses stdlib only)
Troubleshooting
Skill not being reminded
Issue: Keyword appears in prompt but no reminder is injected
Solution:
- Verify the skill has
trigger-keywordsin its SKILL.md frontmatter - Check the keyword is spelled correctly
- Ensure the SKILL.md is in one of:
~/.claude/skills/<skill-name>/SKILL.md.claude/skills/<skill-name>/SKILL.md(in project or parent directories)
- Test the script manually:
echo '{"prompt":"test linear","cwd":"/path/to/project"}' | python3 scripts/scan_skills.py
Author
Filip Procházka
License
MIT
Hooks 1
Sponsors
Details
- Marketplace
- fprochazka/claude-code-plugins
- Source
- plugins/skill-keyword-reminder
- Author
- Filip Procházka
- Category
- Productivity
More from fprochazka/claude-code-plugins
All 25- slackcliv2.0.7
- teamworkv0.2.1
- use-libsrc-mcpv0.1.0
- web-researcherv1.1.1
- agent-rolesv0.8.3
- ai-tool-use-validatorv0.2.0
- code-reviewv1.17.5
- diagramsv0.1.2
- gemini-cliv1.2.2
- gemini-deep-researchv1.0.0
- gitv0.3.3
- glabv1.3.5
- glab-mrv1.7.3
- gogcliv0.1.5
- llm-totov0.1.0
- markitdownv1.0.0
- metabasecliv1.0.3
- migrate-to-uvv1.2.0
- noisy-tools-in-subagentv0.7.1
- prosev0.3.2
- rabbitmqadminv0.2.1
- researchv0.1.2
- sdlcv0.23.3
- searxngcliv0.3.2