From 5185a0e9d26f5c0ff16a5bad5bd99523a6d1e8ad Mon Sep 17 00:00:00 2001 From: Steve Nims Date: Sun, 7 Dec 2025 19:59:53 -0500 Subject: [PATCH 1/2] feat(agent-development): add comparative trigger phrases to skill description MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add 4 new trigger phrases for improved discoverability: - "difference between agent and skill" - "agent vs command" - "when should I use an agent" - "agent schema" These help users discover the skill's comparison table when asking conceptual questions about plugin components. Fixes #17 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- plugins/plugin-dev/skills/agent-development/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugins/plugin-dev/skills/agent-development/SKILL.md b/plugins/plugin-dev/skills/agent-development/SKILL.md index 928a139..d23010b 100644 --- a/plugins/plugin-dev/skills/agent-development/SKILL.md +++ b/plugins/plugin-dev/skills/agent-development/SKILL.md @@ -1,6 +1,6 @@ --- name: agent-development -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. +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. --- # Agent Development for Claude Code Plugins From 47bcbf87f9c7ab7fda65f9dc952b9fa13b072c84 Mon Sep 17 00:00:00 2001 From: Steve Nims Date: Sun, 7 Dec 2025 20:04:31 -0500 Subject: [PATCH 2/2] fix(ci): remove version requirement from skill validation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Skills no longer have version fields (removed in 8521d81), so the workflow was checking for something that doesn't exist. - Remove version from required skill frontmatter fields - Remove version matching check against plugin.json - Remove instruction to read plugin.json (no longer needed) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .github/workflows/component-validation.yml | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/.github/workflows/component-validation.yml b/.github/workflows/component-validation.yml index d5affcf..712f98b 100644 --- a/.github/workflows/component-validation.yml +++ b/.github/workflows/component-validation.yml @@ -85,9 +85,8 @@ jobs: ## Instructions - 1. First, read the plugin version from `plugins/plugin-dev/.claude-plugin/plugin.json` (needed for skill version validation) - 2. Read and validate ONLY the changed files listed above - 3. Return structured JSON with validation results + 1. Read and validate ONLY the changed files listed above + 2. Return structured JSON with validation results ## Validation Rules @@ -108,9 +107,8 @@ jobs: ### Skills (`plugins/plugin-dev/skills/*/SKILL.md`) For each changed skill SKILL.md file, verify: - - [ ] YAML frontmatter exists with `name`, `description`, `version` fields + - [ ] YAML frontmatter exists with `name`, `description` fields - [ ] `description` uses third-person with trigger phrases (starts with "This skill should be used when...") - - [ ] `version` matches the plugin.json version - [ ] Body length is reasonable (core concepts, not exhaustive documentation) ### Agents (`plugins/plugin-dev/agents/*.md`)