[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6C290TFD997Y0K9D72JW7JP":3,"skill-same:01M6C290TFD997Y0K9D72JW7JP":92},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":45,"linkOnly":46,"markdownContent":47,"markdownBody":48,"frontMatter":49,"refName":52,"commitSha":53,"skillDirectory":54,"forksCount":55,"repositoryHtmlUrl":56,"repositoryHomepageUrl":6,"ownerHtmlUrl":57,"ownerBlogUrl":58,"ownerDescription":6,"updatedAt":59,"install":60,"resources":73},"01M6C290TFD997Y0K9D72JW7JP","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.","OpenHands\u002Fsoftware-agent-sdk","OpenHands","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F225919603?v=4","01M6C27VE6SQ4X635GVG804BRN","01M6C27VJK3R57C2Z3AVJ03NQS",1396,"MIT","https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"plugin","migrate","migrate agent plugin","when","codex","agent plugins","Existing","v1","platform","commands","kiro","structure","lsp","hooks","use","cursor","behavior","marketplace","ui","plugins","code","copilot","2026-11-10 10:12:30",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":14,"metadata":50,"description":7},{"version":51},"1.0.0","main","98849457621881ae2414719b82b8bc1cf535b4ab","tests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin",781,"https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk","https:\u002F\u002Fgithub.com\u002FOpenHands","https:\u002F\u002Fopenhands.dev","2026-11-15 01:41:08",{"source":8,"skillName":5,"commands":61,"prompt":71,"zipAvailable":72},[62,65,68],{"tool":63,"command":64},"npx","npx skills add OpenHands\u002Fsoftware-agent-sdk --skill migrate-agent-plugin",{"tool":66,"command":67},"bunx","bunx skills add OpenHands\u002Fsoftware-agent-sdk --skill migrate-agent-plugin",{"tool":69,"command":70},"pnpm","pnpm dlx skills add OpenHands\u002Fsoftware-agent-sdk --skill migrate-agent-plugin","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin\u002FSKILL.md",true,[74,80,84,88],{"path":75,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":78,"sourceHtmlUrl":79},"agents\u002Fopenai.yaml","REFERENCE","参考文档",43,"https:\u002F\u002Fgithub.com\u002Foscarrenalias\u002Ftakt\u002Fblob\u002Fmain\u002Ftemplates\u002Fskills\u002Ftask\u002Fdependency-graphing\u002Fagents\u002Fopenai.yaml",{"path":81,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Fclient-extensions.md",3038,"https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin\u002Freferences\u002Fclient-extensions.md",{"path":85,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":86,"sourceHtmlUrl":87},"references\u002Fmigration-guide.md",5372,"https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin\u002Freferences\u002Fmigration-guide.md",{"path":89,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":90,"sourceHtmlUrl":91},"references\u002Fvalidation-checklist.md",2553,"https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fagent-plugins-example\u002Fskills\u002Fmigrate-agent-plugin\u002Freferences\u002Fvalidation-checklist.md",[93,119,129,138,147,152],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":100,"publishedAt":45},"01M70N7TM3VRT2YVJWMFJB93R4","verify-sdk","This skill should be used to \"verify SDK behavior\", \"check an SDK change against the feature map\", \"run the SDK feature map\", \"maintain the SDK feature map\", or \"run the daily SDK map pass\". It holds the maintained map of what the OpenHands SDK does in-process (agent loop, LLMs, conversations, events, condensers, skills, plugins, MCP, hooks, sub-agents, critic, security, tools, workspaces, settings, observability, ACP), the control-sdk driver its recipes use, and sdk-map (check, owners, baseline, run, report).","https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fverify-sdk\u002FSKILL.md",[99],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[101,102,103,104,105,106,107,108,109,110,111,36,37,112,113,114,115,116,117,118],"verify sdk","verify","sdk","critic","conversations","feature","control","map","maintain","workspaces","daily","check","openhands","loop","observability","change","llms","MCP",{"skillNo":120,"name":121,"nameZh":6,"description":122,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":123,"categories":124,"keywords":125,"publishedAt":45},"01M6C29EG7KM3YYQK1TX747Q0X","only","The one component in a fixed location this format discovers.","https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fwrong-locations\u002Fskills\u002Fonly\u002FSKILL.md",[],[121,126,127,128],"location","format","component",{"skillNo":130,"name":131,"nameZh":6,"description":132,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":133,"categories":134,"keywords":135,"publishedAt":45},"01M6C29D0ZE9EAD0B72S5C7TYC","never","Must never be discovered; the manifest is rejected first.","https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Funsupported-schema\u002Fskills\u002Fnever\u002FSKILL.md",[],[131,136,137],"first","manifest",{"skillNo":139,"name":140,"nameZh":6,"description":141,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":142,"categories":143,"keywords":144,"publishedAt":45},"01M6C29BSP5CJZ6T7A2HM18C35","good","Loads while its broken sibling is skipped.","https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fpartial-failures\u002Fskills\u002Fgood\u002FSKILL.md",[],[140,145,146],"loads","broken",{"skillNo":148,"name":146,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":149,"categories":150,"keywords":151,"publishedAt":45},"01M6C29ADJKMKDVYG57TSAZV7J","https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fpartial-failures\u002Fskills\u002Fbroken\u002FSKILL.md",[],[146],{"skillNo":153,"name":154,"nameZh":6,"description":155,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":156,"categories":157,"keywords":158,"publishedAt":45},"01M6C2996Q7PX47VFV5P4KJ5F8","ok","Loads despite the two non-fatal manifest violations.","https:\u002F\u002Fgithub.com\u002FOpenHands\u002Fsoftware-agent-sdk\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fplugins\u002Fagent_plugins\u002Fnon-fatal-manifest\u002Fskills\u002Fok\u002FSKILL.md",[],[154,137,145]]