package_as_plugin
DestructiveIdempotent
Wrap generated Ansible skills into an Agent Plugins directory with plugin.json and optional mcp.json, replacing existing skills trees to produce a distributable plugin archive.
Instructions
Wrap already-generated skills into an Agent Plugins directory.
Does not change generate_* output layout. Copies
skills/{collection-kebab}/{skill}/ into
{output_dir}/{plugin}/skills/{skill}/ and writes plugin.json
(and optionally mcp.json + .tar.gz) per the Agent Plugins
specification. Replaces any existing skills/ tree under the target
plugin directory (destructive but idempotent).
Returns: {"collection", "plugin_name", "plugin_dir", "skill_count", "skills", "plugin_json", "mcp_json", "archive"} or {"error": str} on failure.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mcp_url | No | Absolute MCP endpoint URL when mcp_transport is 'streamable-http' (e.g. 'https://aap.example.com/mcp/skills/'). Ignored for stdio. | |
| collection | Yes | Collection namespace whose generated skills to wrap (e.g. 'netbox.netbox'). | |
| output_dir | Yes | Parent directory where the Agent Plugin directory will be created (e.g. '.' or '/tmp/agent-plugins'). | |
| source_dir | No | Optional skills root to read from. Defaults to ANSIBLE_KNOW_SKILLS_PATH or SKILLS_DIR (same roots as list_skills). | |
| plugin_name | No | Optional Agent Plugins manifest name / directory name. Defaults to 'ansible-{collection-kebab}-agentplugin' (e.g. 'ansible-netbox-netbox-agentplugin'). Must satisfy Agent Plugins §5.5 (1-64 chars, [a-z0-9.-]). | |
| mcp_transport | No | MCP transport for mcp.json when include_mcp_config is true: 'stdio' (default, uvx ansible-know-mcp) or 'streamable-http' (requires mcp_url for an AAP-hosted know-mcp endpoint). | stdio |
| write_tarball | No | When true (default), also write {plugin_name}-{version}.tar.gz beside the plugin directory (Pulp/AAP-friendly artifact). Requires write_plugin_json=True. | |
| write_plugin_json | No | When true (default), write plugin.json with Agent Plugins v1.0.0 manifest fields. Required when write_tarball is true. | |
| include_mcp_config | No | When true (default), write mcp.json for know-mcp (see mcp_transport). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |