Skip to content

feat: strengthen agent-development skill trigger phrases #10

@sjnims

Description

@sjnims

Summary

The agent-development skill description could be improved with more natural, query-style trigger phrases to improve skill discovery and activation.

Current Description

description: This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.

Issues with Current Triggers

Some trigger phrases are fragments rather than natural user queries:

  • "agent frontmatter" - fragment, not a question
  • "agent tools" - fragment
  • "agent colors" - fragment
  • "when to use description" - awkward phrasing

Proposed Improvements

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.

Changes:

  • "agent frontmatter""what are the agent frontmatter fields"
  • "agent tools""how to restrict agent tools"
  • "agent colors""what colors can agents use"
  • Added: "design an agent for [task]"
  • Added: "how do I write agent descriptions"
  • Added: "validate my agent"
  • Added: "test agent triggering"

Acceptance Criteria

  • Description uses natural query-style phrases
  • Common user intents are covered
  • Skill triggers reliably on expected queries

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions