Skip to content

Commit 41f7c8b

Browse files
sjnimsclaude
andauthored
feat(agent-development): add comparative trigger phrases to skill description (#20)
## Summary - Add 4 new trigger phrases to the agent-development skill description - Improves discoverability for comparative and conceptual questions ## Problem Fixes #17 Users asking questions like "what's the difference between an agent and a skill?" wouldn't discover the agent-development skill, despite it having an excellent comparison table. ## Solution Added these specific trigger phrases to the description: - `"difference between agent and skill"` - `"agent vs command"` - `"when should I use an agent"` - `"agent schema"` ### Alternatives Considered - Adding a separate FAQ skill - rejected as agent-development already has comprehensive comparison content - Modifying skill body - unnecessary since triggering is the issue, not content ## Changes - `plugins/plugin-dev/skills/agent-development/SKILL.md`: Added 4 trigger phrases to description ## Testing - [x] Description under 1024 character limit (580 chars) - [x] Markdownlint passes - [x] Skill triggers on test queries (e.g., "what's the difference between an agent and a skill?") --- 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent 8521d81 commit 41f7c8b

File tree

2 files changed

+4
-6
lines changed

2 files changed

+4
-6
lines changed

.github/workflows/component-validation.yml

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -85,9 +85,8 @@ jobs:
8585
8686
## Instructions
8787
88-
1. First, read the plugin version from `plugins/plugin-dev/.claude-plugin/plugin.json` (needed for skill version validation)
89-
2. Read and validate ONLY the changed files listed above
90-
3. Return structured JSON with validation results
88+
1. Read and validate ONLY the changed files listed above
89+
2. Return structured JSON with validation results
9190
9291
## Validation Rules
9392
@@ -108,9 +107,8 @@ jobs:
108107
### Skills (`plugins/plugin-dev/skills/*/SKILL.md`)
109108
110109
For each changed skill SKILL.md file, verify:
111-
- [ ] YAML frontmatter exists with `name`, `description`, `version` fields
110+
- [ ] YAML frontmatter exists with `name`, `description` fields
112111
- [ ] `description` uses third-person with trigger phrases (starts with "This skill should be used when...")
113-
- [ ] `version` matches the plugin.json version
114112
- [ ] Body length is reasonable (core concepts, not exhaustive documentation)
115113
116114
### Agents (`plugins/plugin-dev/agents/*.md`)

plugins/plugin-dev/skills/agent-development/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: agent-development
3-
description: This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "design an agent for [task]", "how do I write agent descriptions", "what are the agent frontmatter fields", "validate my agent", "test agent triggering", "how to restrict agent tools", "what colors can agents use", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
3+
description: This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "design an agent for [task]", "how do I write agent descriptions", "what are the agent frontmatter fields", "validate my agent", "test agent triggering", "how to restrict agent tools", "what colors can agents use", "autonomous agent", "difference between agent and skill", "agent vs command", "when should I use an agent", "agent schema", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
44
---
55

66
# Agent Development for Claude Code Plugins

0 commit comments

Comments
 (0)