Plugin Architect Skill for Claude

🏗️ Plugin Architect Protocol

本 Skill 定义了本项目构建 AI Plugins 的唯一标准。所有 Skill 的创建与修改必须遵循此方法论。

When This Skill Applies

• 当用户要求"创建一个新 Skill"时。
• 当需要重构现有 Skills 以符合标准时。
• 当需要为 Skill 添加外部工具 (MCP) 或快捷指令 (Slash Commands) 时。

Instructions

一个完整的 Plugin (Skill System) 由四个核心组件构成。

1. The Identity (plugin.json)

插件的身份证。定义插件在系统中的唯一标识。

• Location: .agent/.claude-plugin/plugin.json (Global) 或 skill-name/plugin.json (Local)
• Schema:

    {
      "schema_version": "1.0",
      "name": "devil-hunter-nexus-plugin",
      "description": "The cognitive engine and SEO factory for Roblox game sites.",
      "version": "1.0.0",
      "authors": ["Devil Hunter Team"]
    }

2. The Logic (SKILL.md)

AI 的思维链。必须包含明确的触发条件 (Trigger) 和结构化指令。

• Location: .agent/skills/<skill-name>/SKILL.md
• Frontmatter: Must include name and description.
• Mandatory Sections:
• ## When This Skill Applies: 明确的触发条件 (Contextual Triggers)。
• *Good*: "When the user asks to analyze SEO metadata."
• *Bad*: "Use this for SEO."
• ## Instructions: 具体的操作步骤、原则或代码规范。
• ## Actions (Optional): 可用的工具或脚本引用。

3. The Interface (commands/)

用户的快捷入口。定义以 / 开头的显式调用指令。

• Location: .agent/commands/<command-name>.md
• Format:

    ---
    description: Audit the current page for SEO compliance
    argument-hint: [url or path]
    active-skills: [nextjs-seo-foundations]
    ---
    
    # /audit-seo
    
    1. Check presence of Metadata (Title, Description).
    2. Validate JSON-LD Schema.
    3. Report missing 'canonical' tags.

4. The Tooling (.mcp.json)

外部能力的延伸。通过 Model Context Protocol 连接真实世界。

• Location: .agent/.mcp.json
• Usage: 如果 Skill 需要执行复杂脚本 (e.g., Python Script, Database Query)，需在此注册 MCP Server。

Workflow: How to Build a New Skill

• Define Intent: 是"思维模式" (Thinking) 还是"具体操作" (Action)?
• *Thinking* -> 重点编写 SKILL.md 的 Instructions。
• *Action* -> 重点编写 commands/ 和 scripts/。

• Create Directory: mkdir .agent/skills/<skill-name>

• Draft SKILL.md:
• Copy metadata template.
• Write strict "When This Skill Applies" triggers.
• Write verifiable Instructions.

• Register Command (Optional):
• If user needs frequent access, create .agent/commands/<skill-shortcut>.md.

• Validation:
• Ask AI: "Does this skill structure match the plugin-architect standard?"