From 55aa320c613c9b33ffe200e505a4b5d572962b55 Mon Sep 17 00:00:00 2001 From: Bechor Simhaev Date: Sun, 9 Aug 2026 16:02:11 +0300 Subject: [PATCH] fix(skills): use spec-conformant names in plugin-dev and hookify skills MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Eight bundled skills declare a title-cased `name` with spaces, e.g. name: Skill Development # plugins/plugin-dev/skills/skill-development/ name: MCP Integration # plugins/plugin-dev/skills/mcp-integration/ The Agent Skills specification requires the `name` field to contain only lowercase alphanumerics and hyphens, and to match the parent directory name. Both constraints are violated by all eight, so `skills-ref validate` rejects them. The two skills outside plugin-dev/hookify already follow the spec — `claude-opus-4-5-migration` and `frontend-design` — so this changes the eight outliers to the convention the repository already uses elsewhere. Only the frontmatter `name` field is touched. The prose headings in plugins/plugin-dev/README.md and the `#` titles inside each SKILL.md keep their human-readable capitalization, since neither is a skill identifier. Spec: https://agentskills.io/specification#name-field --- plugins/hookify/skills/writing-rules/SKILL.md | 2 +- plugins/plugin-dev/skills/agent-development/SKILL.md | 2 +- plugins/plugin-dev/skills/command-development/SKILL.md | 2 +- plugins/plugin-dev/skills/hook-development/SKILL.md | 2 +- plugins/plugin-dev/skills/mcp-integration/SKILL.md | 2 +- plugins/plugin-dev/skills/plugin-settings/SKILL.md | 2 +- plugins/plugin-dev/skills/plugin-structure/SKILL.md | 2 +- plugins/plugin-dev/skills/skill-development/SKILL.md | 2 +- 8 files changed, 8 insertions(+), 8 deletions(-) diff --git a/plugins/hookify/skills/writing-rules/SKILL.md b/plugins/hookify/skills/writing-rules/SKILL.md index 008168a4c9..ea630dbd5b 100644 --- a/plugins/hookify/skills/writing-rules/SKILL.md +++ b/plugins/hookify/skills/writing-rules/SKILL.md @@ -1,5 +1,5 @@ --- -name: Writing Hookify Rules +name: writing-rules description: This skill should be used when the user asks to "create a hookify rule", "write a hook rule", "configure hookify", "add a hookify rule", or needs guidance on hookify rule syntax and patterns. version: 0.1.0 --- diff --git a/plugins/plugin-dev/skills/agent-development/SKILL.md b/plugins/plugin-dev/skills/agent-development/SKILL.md index 36830932de..ca0e183bee 100644 --- a/plugins/plugin-dev/skills/agent-development/SKILL.md +++ b/plugins/plugin-dev/skills/agent-development/SKILL.md @@ -1,5 +1,5 @@ --- -name: Agent Development +name: agent-development 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. version: 0.1.0 --- diff --git a/plugins/plugin-dev/skills/command-development/SKILL.md b/plugins/plugin-dev/skills/command-development/SKILL.md index e39435e14d..57802118bd 100644 --- a/plugins/plugin-dev/skills/command-development/SKILL.md +++ b/plugins/plugin-dev/skills/command-development/SKILL.md @@ -1,5 +1,5 @@ --- -name: Command Development +name: command-development description: This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code. version: 0.2.0 --- diff --git a/plugins/plugin-dev/skills/hook-development/SKILL.md b/plugins/plugin-dev/skills/hook-development/SKILL.md index d1c0c199c7..6317441bfe 100644 --- a/plugins/plugin-dev/skills/hook-development/SKILL.md +++ b/plugins/plugin-dev/skills/hook-development/SKILL.md @@ -1,5 +1,5 @@ --- -name: Hook Development +name: hook-development description: This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API. version: 0.1.0 --- diff --git a/plugins/plugin-dev/skills/mcp-integration/SKILL.md b/plugins/plugin-dev/skills/mcp-integration/SKILL.md index d4fcd96cf6..aee6c05e14 100644 --- a/plugins/plugin-dev/skills/mcp-integration/SKILL.md +++ b/plugins/plugin-dev/skills/mcp-integration/SKILL.md @@ -1,5 +1,5 @@ --- -name: MCP Integration +name: mcp-integration description: This skill should be used when the user asks to "add MCP server", "integrate MCP", "configure MCP in plugin", "use .mcp.json", "set up Model Context Protocol", "connect external service", mentions "${CLAUDE_PLUGIN_ROOT} with MCP", or discusses MCP server types (SSE, stdio, HTTP, WebSocket). Provides comprehensive guidance for integrating Model Context Protocol servers into Claude Code plugins for external tool and service integration. version: 0.1.0 --- diff --git a/plugins/plugin-dev/skills/plugin-settings/SKILL.md b/plugins/plugin-dev/skills/plugin-settings/SKILL.md index 912a06e184..60ae4083cd 100644 --- a/plugins/plugin-dev/skills/plugin-settings/SKILL.md +++ b/plugins/plugin-dev/skills/plugin-settings/SKILL.md @@ -1,5 +1,5 @@ --- -name: Plugin Settings +name: plugin-settings description: This skill should be used when the user asks about "plugin settings", "store plugin configuration", "user-configurable plugin", ".local.md files", "plugin state files", "read YAML frontmatter", "per-project plugin settings", or wants to make plugin behavior configurable. Documents the .claude/plugin-name.local.md pattern for storing plugin-specific configuration with YAML frontmatter and markdown content. version: 0.1.0 --- diff --git a/plugins/plugin-dev/skills/plugin-structure/SKILL.md b/plugins/plugin-dev/skills/plugin-structure/SKILL.md index 6fb8a3baa1..6bcae94a52 100644 --- a/plugins/plugin-dev/skills/plugin-structure/SKILL.md +++ b/plugins/plugin-dev/skills/plugin-structure/SKILL.md @@ -1,5 +1,5 @@ --- -name: Plugin Structure +name: plugin-structure description: This skill should be used when the user asks to "create a plugin", "scaffold a plugin", "understand plugin structure", "organize plugin components", "set up plugin.json", "use ${CLAUDE_PLUGIN_ROOT}", "add commands/agents/skills/hooks", "configure auto-discovery", or needs guidance on plugin directory layout, manifest configuration, component organization, file naming conventions, or Claude Code plugin architecture best practices. version: 0.1.0 --- diff --git a/plugins/plugin-dev/skills/skill-development/SKILL.md b/plugins/plugin-dev/skills/skill-development/SKILL.md index ac75eedde7..e720adc438 100644 --- a/plugins/plugin-dev/skills/skill-development/SKILL.md +++ b/plugins/plugin-dev/skills/skill-development/SKILL.md @@ -1,5 +1,5 @@ --- -name: Skill Development +name: skill-development description: This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins. version: 0.1.0 ---