[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DE3X458DYY0QN5JYXQ9FBT":3,"skill-same:01M7DE3X458DYY0QN5JYXQ9FBT":60},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":14,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7DE3X458DYY0QN5JYXQ9FBT","migrate-agent-plugin",null,"Migrate an existing Claude, Copilot, Codex, Cursor, Kiro, VS Code, or other client-specific agent plugin to the portable Agent Plugins v1 structure while preserving platform-specific hooks, agents, commands, LSP, UI, and marketplace behavior. Use when auditing, converting, or modernizing an agent plugin.","chinmay7980\u002FCaffiPilot","chinmay7980","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F188092280?v=4","01M7DE2B4W0ZQT23WCJ0BA529B","Chinmay Soni","01M7DE2B5JVSYW71Z5V069E03T",1,"MIT","https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: migrate-agent-plugin\ndescription: Migrate an existing Claude, Copilot, Codex, Cursor, Kiro, VS Code, or other client-specific agent plugin to the portable Agent Plugins v1 structure while preserving platform-specific hooks, agents, commands, LSP, UI, and marketplace behavior. Use when auditing, converting, or modernizing an agent plugin.\nlicense: MIT\nmetadata:\n  version: \"1.0.0\"\n---\n\n# Migrate an Agent Plugin\n\nConvert an existing plugin to the Agent Plugins v1 portable core without prematurely removing behavior required by its current clients.\n\n## Source of truth\n\nUse the current [Agent Plugins specification](https:\u002F\u002Fagent-plugins.org\u002Fspecification) as the normative source.\n\nRead these references before editing:\n\n- [Migration guide](references\u002Fmigration-guide.md)\n- [Client extensions](references\u002Fclient-extensions.md)\n- [Validation checklist](references\u002Fvalidation-checklist.md)\n\n## Workflow\n\n1. Inventory the current plugin before moving files.\n   - Record every manifest, skill, prompt or command, agent, MCP server, hook, LSP server, UI resource, script, secret requirement, and marketplace entry.\n   - Identify the clients that currently load each artifact and the install paths or discovery rules they require.\n   - Run existing tests or capture a manual smoke-test baseline.\n\n2. Classify each artifact.\n   - Portable core: root `plugin.json`, Agent Skills in `skills\u002F`, and MCP servers in root `mcp.json`.\n   - Client extension: additional behavior loaded through a reverse-domain namespace owned and documented by a client.\n   - Compatibility layer: legacy files or a generated client package retained until that client supports the portable or namespaced form.\n   - Distribution metadata: marketplace catalogs, install policy, signing, and release configuration; these are outside the portable package format.\n\n3. Add the portable manifest.\n   - Create `plugin.json` at the plugin root.\n   - Set `$schema` to `https:\u002F\u002Fagent-plugins.org\u002Fschemas\u002F1.0.0\u002Fplugin.schema.json`.\n   - Include `name` and only supported metadata fields.\n   - Do not put component paths or client fields such as `hooks`, `agents`, `skills`, or `mcpServers` at the top level.\n\n4. Normalize portable components.\n   - Put each skill at `skills\u002F\u003Cskill-name>\u002FSKILL.md`; only immediate children of `skills\u002F` are discovered.\n   - Make each skill name match its parent directory and the Agent Skills naming rules.\n   - If MCP is present, convert it to root `mcp.json`, declare the matching v1.0.0 schema, and give every server an explicit `stdio`, `streamable-http`, or `sse` type.\n   - Use `${PLUGIN_ROOT}` for packaged read-only resources and `${PLUGIN_DATA}` for persistent writable state where the MCP schema permits expansion.\n\n5. Preserve non-core behavior.\n   - Use a client extension only when the target client publishes a reverse-domain namespace and its semantics.\n   - If the client still requires a legacy layout, keep or generate a separate compatibility package. Treat the portable files as the source of truth and avoid manually maintaining divergent copies.\n   - Do not invent a vendor namespace and assume an unrelated client will load it.\n\n6. Validate and test incrementally.\n   - Validate the portable manifest, every skill, optional MCP configuration, and package path containment.\n   - Test each supported client independently, including hooks and other compatibility behavior.\n   - Remove legacy artifacts only after the replacement passes the same behavior checks.\n\n## Required migration report\n\nBefore finishing, report:\n\n- The discovered source format and target clients.\n- A mapping from every original artifact to portable core, extension, compatibility layer, distribution metadata, or removal.\n- Files added, moved, generated, retained, and intentionally omitted.\n- Validation and client smoke-test results.\n- Remaining client-specific risks or manual steps.\n\nPrefer an additive, reversible migration. Never claim that hooks, agents, commands, LSP servers, UI, or marketplace metadata became portable Agent Plugins v1 components.\n","# Migrate an Agent Plugin\n\nConvert an existing plugin to the Agent Plugins v1 portable core without prematurely removing behavior required by its current clients.\n\n## Source of truth\n\nUse the current [Agent Plugins specification](https:\u002F\u002Fagent-plugins.org\u002Fspecification) as the normative source.\n\nRead these references before editing:\n\n- [Migration guide](references\u002Fmigration-guide.md)\n- [Client extensions](references\u002Fclient-extensions.md)\n- [Validation checklist](references\u002Fvalidation-checklist.md)\n\n## Workflow\n\n1. Inventory the current plugin before moving files.\n   - Record every manifest, skill, prompt or command, agent, MCP server, hook, LSP server, UI resource, script, secret requirement, and marketplace entry.\n   - Identify the clients that currently load each artifact and the install paths or discovery rules they require.\n   - Run existing tests or capture a manual smoke-test baseline.\n\n2. Classify each artifact.\n   - Portable core: root `plugin.json`, Agent Skills in `skills\u002F`, and MCP servers in root `mcp.json`.\n   - Client extension: additional behavior loaded through a reverse-domain namespace owned and documented by a client.\n   - Compatibility layer: legacy files or a generated client package retained until that client supports the portable or namespaced form.\n   - Distribution metadata: marketplace catalogs, install policy, signing, and release configuration; these are outside the portable package format.\n\n3. Add the portable manifest.\n   - Create `plugin.json` at the plugin root.\n   - Set `$schema` to `https:\u002F\u002Fagent-plugins.org\u002Fschemas\u002F1.0.0\u002Fplugin.schema.json`.\n   - Include `name` and only supported metadata fields.\n   - Do not put component paths or client fields such as `hooks`, `agents`, `skills`, or `mcpServers` at the top level.\n\n4. Normalize portable components.\n   - Put each skill at `skills\u002F\u003Cskill-name>\u002FSKILL.md`; only immediate children of `skills\u002F` are discovered.\n   - Make each skill name match its parent directory and the Agent Skills naming rules.\n   - If MCP is present, convert it to root `mcp.json`, declare the matching v1.0.0 schema, and give every server an explicit `stdio`, `streamable-http`, or `sse` type.\n   - Use `${PLUGIN_ROOT}` for packaged read-only resources and `${PLUGIN_DATA}` for persistent writable state where the MCP schema permits expansion.\n\n5. Preserve non-core behavior.\n   - Use a client extension only when the target client publishes a reverse-domain namespace and its semantics.\n   - If the client still requires a legacy layout, keep or generate a separate compatibility package. Treat the portable files as the source of truth and avoid manually maintaining divergent copies.\n   - Do not invent a vendor namespace and assume an unrelated client will load it.\n\n6. Validate and test incrementally.\n   - Validate the portable manifest, every skill, optional MCP configuration, and package path containment.\n   - Test each supported client independently, including hooks and other compatibility behavior.\n   - Remove legacy artifacts only after the replacement passes the same behavior checks.\n\n## Required migration report\n\nBefore finishing, report:\n\n- The discovered source format and target clients.\n- A mapping from every original artifact to portable core, extension, compatibility layer, distribution metadata, or removal.\n- Files added, moved, generated, retained, and intentionally omitted.\n- Validation and client smoke-test results.\n- Remaining client-specific risks or manual steps.\n\nPrefer an additive, reversible migration. Never claim that hooks, agents, commands, LSP servers, UI, or marketplace metadata became portable Agent Plugins v1 components.\n",{"name":5,"license":15,"metadata":24,"description":7},{"version":25},"1.0.0","main","dd95f71e2daa7e1b24de6445d979939459f459f8","tests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin","https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot","https:\u002F\u002Fgithub.com\u002Fchinmay7980","2026-11-08 17:33:20",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add chinmay7980\u002FCaffiPilot --skill migrate-agent-plugin",{"tool":38,"command":39},"bunx","bunx skills add chinmay7980\u002FCaffiPilot --skill migrate-agent-plugin",{"tool":41,"command":42},"pnpm","pnpm dlx skills add chinmay7980\u002FCaffiPilot --skill migrate-agent-plugin","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin\u002FSKILL.md",true,[46,52,56],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fclient-extensions.md","REFERENCE","参考文档",3038,"https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin\u002Freferences\u002Fclient-extensions.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fmigration-guide.md",5372,"https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin\u002Freferences\u002Fmigration-guide.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fvalidation-checklist.md",2553,"https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin\u002Freferences\u002Fvalidation-checklist.md",[61,68,75,82,88,95],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7DE4AQMK4Y1VX2ATCASH782","only","The one component in a fixed location this format discovers.","https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fwrong-locations\u002Fskills\u002Fonly\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7DE491C4KG07YMC0B624HJF","never","Must never be discovered; the manifest is rejected first.","https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Funsupported-schema\u002Fskills\u002Fnever\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7DE47PWVQS31S1YT5NQFKT0","good","Loads while its broken sibling is skipped.","https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fpartial-failures\u002Fskills\u002Fgood\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7DE46QQTB8WKF1DZHQF2PA4","broken","https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fpartial-failures\u002Fskills\u002Fbroken\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7DE45N8F29QR5XF4T3J9XZ7","ok","Loads despite the two non-fatal manifest violations.","https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fnon-fatal-manifest\u002Fskills\u002Fok\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7DE43RMTH4XKKQV20D1F5EZ","still-here","Loads while the whole MCP component is disabled.","https:\u002F\u002Fgithub.com\u002Fchinmay7980\u002FCaffiPilot\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fmcp-version-mismatch\u002Fskills\u002Fstill-here\u002FSKILL.md",[],[]]