Initial commit

This commit is contained in:
Zhongwei Li
2025-11-30 08:20:15 +08:00
commit 0b1f4556bc
36 changed files with 2888 additions and 0 deletions

View File

@@ -0,0 +1,8 @@
# Assets
Bundled resources for skills-powerkit skill
- [ ] plugin_template/: Template files for creating new plugins.
- [ ] validation_rules.json: JSON file containing validation rules for plugins.
- [ ] example_plugin/: Example plugin with all the required files and directory structure.
- [ ] marketplace_schema.json: JSON schema for the marketplace catalog.

View File

@@ -0,0 +1,32 @@
{
"skill": {
"name": "skill-name",
"version": "1.0.0",
"enabled": true,
"settings": {
"verbose": false,
"autoActivate": true,
"toolRestrictions": true
}
},
"triggers": {
"keywords": [
"example-trigger-1",
"example-trigger-2"
],
"patterns": []
},
"tools": {
"allowed": [
"Read",
"Grep",
"Bash"
],
"restricted": []
},
"metadata": {
"author": "Plugin Author",
"category": "general",
"tags": []
}
}

View File

@@ -0,0 +1,153 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Marketplace Plugin Schema",
"description": "JSON schema for plugins in the claude-code-plugins marketplace.",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the plugin (e.g., UUID).",
"example": "skills-powerkit-12345",
"_comment": "Consider using a UUID generator for this."
},
"name": {
"type": "string",
"description": "Human-readable name of the plugin.",
"example": "Skills Powerkit"
},
"version": {
"type": "string",
"description": "Semantic version of the plugin.",
"example": "1.0.0"
},
"description": {
"type": "string",
"description": "A brief description of the plugin's functionality.",
"example": "The ultimate plugin management toolkit for the claude-code-plugins marketplace."
},
"author": {
"type": "string",
"description": "Name of the plugin author or organization.",
"example": "Awesome Plugin Devs Inc."
},
"author_url": {
"type": "string",
"format": "url",
"description": "URL to the author's website or profile.",
"example": "https://awesomeplugindevs.com"
},
"repository_url": {
"type": "string",
"format": "url",
"description": "URL to the plugin's source code repository.",
"example": "https://github.com/awesomeplugindevs/skills-powerkit"
},
"license": {
"type": "string",
"description": "License under which the plugin is distributed.",
"example": "MIT"
},
"tags": {
"type": "array",
"description": "Keywords or tags to help users find the plugin.",
"items": {
"type": "string"
},
"example": ["plugin management", "development", "validation", "marketplace", "meta-plugin"]
},
"category": {
"type": "string",
"description": "Category the plugin belongs to.",
"example": "Development Tools"
},
"skills": {
"type": "array",
"description": "List of skills provided by the plugin.",
"items": {
"type": "string"
},
"example": [
"create_plugin",
"validate_plugin",
"audit_plugin",
"manage_plugin",
"update_plugin"
]
},
"icon_url": {
"type": "string",
"format": "url",
"description": "URL to the plugin's icon.",
"example": "https://example.com/icons/skills-powerkit.png"
},
"readme_url": {
"type": "string",
"format": "url",
"description": "URL to the plugin's README file.",
"example": "https://raw.githubusercontent.com/awesomeplugindevs/skills-powerkit/main/README.md"
},
"plugin_url": {
"type": "string",
"format": "url",
"description": "URL to the main plugin manifest or entry point.",
"example": "https://raw.githubusercontent.com/awesomeplugindevs/skills-powerkit/main/plugin.yaml"
},
"dependencies": {
"type": "array",
"description": "List of other plugins or libraries this plugin depends on.",
"items": {
"type": "string"
},
"example": []
},
"type": {
"type": "string",
"description": "Type of plugin.",
"example": "meta-plugin"
},
"pricing": {
"type": "object",
"description": "Pricing information for the plugin (if applicable).",
"properties": {
"type": {
"type": "string",
"enum": ["free", "paid", "subscription"],
"description": "Type of pricing model."
},
"price": {
"type": "number",
"description": "Price of the plugin (if applicable).",
"example": 9.99
},
"currency": {
"type": "string",
"description": "Currency of the price (if applicable).",
"example": "USD"
},
"interval": {
"type": "string",
"description": "Billing interval (if applicable).",
"enum": ["monthly", "yearly"],
"example": "monthly"
}
},
"required": ["type"]
}
},
"required": [
"id",
"name",
"version",
"description",
"author",
"author_url",
"repository_url",
"license",
"tags",
"category",
"skills",
"icon_url",
"readme_url",
"plugin_url"
]
}

View File

@@ -0,0 +1,28 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Claude Skill Configuration",
"type": "object",
"required": ["name", "description"],
"properties": {
"name": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 64,
"description": "Skill identifier (lowercase, hyphens only)"
},
"description": {
"type": "string",
"maxLength": 1024,
"description": "What the skill does and when to use it"
},
"allowed-tools": {
"type": "string",
"description": "Comma-separated list of allowed tools"
},
"version": {
"type": "string",
"pattern": "^\\d+\\.\\d+\\.\\d+$",
"description": "Semantic version (x.y.z)"
}
}
}

View File

@@ -0,0 +1,27 @@
{
"testCases": [
{
"name": "Basic activation test",
"input": "trigger phrase example",
"expected": {
"activated": true,
"toolsUsed": ["Read", "Grep"],
"success": true
}
},
{
"name": "Complex workflow test",
"input": "multi-step trigger example",
"expected": {
"activated": true,
"steps": 3,
"toolsUsed": ["Read", "Write", "Bash"],
"success": true
}
}
],
"fixtures": {
"sampleInput": "example data",
"expectedOutput": "processed result"
}
}

View File

@@ -0,0 +1,113 @@
{
"_comment": "Validation rules for plugins in the claude-code-plugins marketplace. These rules are used by the 'validate_plugin' skill.",
"plugin_name": {
"type": "string",
"required": true,
"min_length": 3,
"max_length": 64,
"pattern": "^[a-z0-9-]+$",
"_comment": "Plugin name must be lowercase, alphanumeric, and can contain hyphens. No spaces allowed.",
"error_message": "Plugin name must be lowercase, alphanumeric, and contain only hyphens. Minimum 3 characters, maximum 64."
},
"description": {
"type": "string",
"required": true,
"min_length": 20,
"max_length": 500,
"_comment": "A concise description of the plugin's functionality.",
"error_message": "Description must be between 20 and 500 characters."
},
"version": {
"type": "string",
"required": true,
"pattern": "^\\d+\\.\\d+\\.\\d+$",
"_comment": "Semantic versioning (e.g., 1.0.0).",
"error_message": "Version must follow semantic versioning (e.g., 1.0.0)."
},
"author": {
"type": "string",
"required": true,
"min_length": 3,
"max_length": 64,
"_comment": "Author's name or organization.",
"error_message": "Author must be between 3 and 64 characters."
},
"skills": {
"type": "array",
"min_items": 1,
"_comment": "List of skills provided by the plugin.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"required": true,
"min_length": 3,
"max_length": 64,
"pattern": "^[a-zA-Z0-9_]+$",
"_comment": "Skill name must be alphanumeric and can contain underscores.",
"error_message": "Skill name must be alphanumeric and contain only underscores. Minimum 3 characters, maximum 64."
},
"description": {
"type": "string",
"required": true,
"min_length": 20,
"max_length": 500,
"_comment": "A concise description of the skill's functionality.",
"error_message": "Skill description must be between 20 and 500 characters."
},
"parameters": {
"type": "object",
"_comment": "Parameters accepted by the skill. Should correspond to the function signature.",
"additionalProperties": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": ["string", "number", "boolean", "array", "object"],
"required": true,
"_comment": "Data type of the parameter."
},
"description": {
"type": "string",
"required": true,
"min_length": 10,
"max_length": 200,
"_comment": "Description of the parameter's purpose.",
"error_message": "Parameter description must be between 10 and 200 characters."
},
"required": {
"type": "boolean",
"default": false,
"_comment": "Whether the parameter is required."
}
},
"required": ["type", "description"]
}
}
},
"required": ["name", "description"]
}
},
"api_url": {
"type": "string",
"required": true,
"format": "uri",
"_comment": "Base URL for the plugin's API.",
"error_message": "API URL must be a valid URL."
},
"license": {
"type": "string",
"required": true,
"enum": ["MIT", "Apache-2.0", "GPL-3.0", "BSD-3-Clause", "Other"],
"_comment": "License under which the plugin is distributed.",
"error_message": "Invalid license type."
},
"privacy_policy_url": {
"type": "string",
"required": false,
"format": "uri",
"_comment": "URL for the plugin's privacy policy. Required if the plugin collects user data.",
"error_message": "Privacy policy URL must be a valid URL."
}
}