[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CYACVCBHQZ3MMP3CZR3X7G":3,"skill-same:01M7CYACVCBHQZ3MMP3CZR3X7G":48},{"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":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":47},"01M7CYACVCBHQZ3MMP3CZR3X7G","change-backport",null,"Ports a change already merged on one version line of a package to another (`vN\u002Fdev` or `support\u002FN.x`). Checks it belongs there, applies it in a worktree, builds, tests and reviews it, and opens a draft PR. Use when asked to port, backport or forward-port a fix or feature, or apply a change to the other version.","mattbrailsford\u002Fumbraco-devkit","mattbrailsford","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F527305?v=4","01M7CY974D4XX1P90YSXQC1T39","Matt Brailsford","01M7CY9751PSRA3EHBH03G936J",3,"MIT","https:\u002F\u002Fgithub.com\u002Fmattbrailsford\u002Fumbraco-devkit\u002Fblob\u002Fmain\u002Fplugins\u002Fumbraco-devkit\u002Fskills\u002Fchange-backport\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: change-backport\ndescription: >-\n  Ports a change already merged on one version line of a package to another (`vN\u002Fdev` or\n  `support\u002FN.x`). Checks it belongs there, applies it in a worktree, builds, tests and\n  reviews it, and opens a draft PR. Use when asked to port, backport or forward-port a fix\n  or feature, or apply a change to the other version.\nuser-invocable: true\nargument-hint: \u003Ccommit SHA | PR number | branch> [target line, e.g. v17]\n---\n\n# change-backport\n\nTake one change that already exists on one line and land it on another, as its own reviewed\nPR. A port is a small, known change, so this skill makes the edit itself, the way `quick-fix`\ndoes, and still sends the result through the `reviewer`.\n\n## Scope\n\n- IN: a change with a concrete source (a commit, a merged PR, or a branch) moving to one other\n  line. Ports in either direction.\n- OUT: deciding the branch model or which lines exist. That's `git-workflow`'s \"Umbraco\n  packages and version tracking\" section. Writing the change in the first place: that's\n  `quick-fix` or the `feature-*` pipeline on the source line. A change that has to be\n  redesigned for the target line (a different extension point, an API that doesn't exist\n  there) is a new change: stop and suggest `feature-explore` on the target line. Moving the\n  whole package to a new CMS major is `major-upgrade`.\n\n## Argument\n\n`$ARGUMENTS` names the source change and, optionally, the target line. If the source is only\na description (\"the null check fix from last week\"), find the commit or PR and confirm it with\nthe user. Don't re-derive a fix from a description when a real commit exists. If no target is\ngiven and the project supports exactly two lines, the target is the other one; otherwise ask.\n\n## Preflight\n\n1. **Find the lines.** Read `CLAUDE.md` for the lines the project supports, each line's\n   integration branch, and each line's phase (active, security fixes only, or end of life). If\n   `CLAUDE.md` doesn't say, list the remote branches and ask; don't infer a phase from a\n   branch name.\n2. **Check the target should get it.**\n   - Active: features and fixes.\n   - Security fixes only: a security fix, nothing else.\n   - End of life: nothing, unless the user asks for it anyway.\n\n   Then check for a reason not to port: the source commit body or PR saying the change only\n   applies to one major (as `git-workflow` asks commits to say), or a project memory note. If\n   the change touches something that differs between the lines and you can't tell whether it\n   applies, ask.\n3. **Check it isn't already there.** Search the target line's history for the source PR\n   number, the commit subject, and the changed lines. A partial earlier port means you port\n   only the rest.\n4. **Read the whole change.** For a PR, list every commit in it, not only the last one. Note\n   any database migration and any public signature change.\n\n## Steps\n\n1. **Cut a fresh worktree on the target line.** Create it from the main checkout, never from\n   inside another worktree. Use the same mechanism `feature-build` uses (the project's\n   `WorktreeCreate` hook or Claude Code's native worktree), named for the change and the\n   target line, following `git-workflow`'s branch naming. Then confirm `pwd`, the branch, and\n   that its base is the target line's integration branch (`git log --oneline -3`). If the base\n   is wrong, stop and fix it before applying anything. Porting onto the wrong base is worse\n   than not porting.\n2. **Apply the change.**\n   - Clean commits: `git cherry-pick -x \u003Csha>...` in their original order. `-x` records the\n     source SHA in each message.\n   - Conflicts: read each one and resolve it by hand. Never take a side wholesale with\n     `--ours` or `--theirs`.\n   - Code that differs on the target line (a renamed type, an API the older CMS major doesn't\n     have): apply the diff by hand and adapt it to the target line's code. Load the stack\n     skills the change touches (`umbraco-package-conventions`, `ef-core-data`,\n     `umbraco-backoffice-conventions`, and so on), the same way `quick-fix` does.\n   - **A database migration:** copy the migration files, never generate them again on the\n     target line. See `ef-core-data`'s \"Porting a migration to another version line\".\n   - **An `[Obsolete]` member:** keep the same removal version as the source line, per\n     `umbraco-package-conventions`.\n3. **Verify on the target line.** Run the build, the tests, and the lint\u002Fformat check from\n   `CLAUDE.md` for the products the change touches. Then smoke it through the real entry point\n   on the target line's demo site, in the order `feature-build`'s \"Smoke the real entry point\"\n   step gives. Passing on the source line proves nothing here. If the site can't run, say \"not\n   verified end to end\" and why in the hand-off.\n4. **Review.** Dispatch one `reviewer` subagent (Agent tool, `subagent_type: reviewer`)\n   against the port's diff. Give it the source change as the task, and say what you adapted\n   and why, so it can check the adaptation and not only the code. Fix Critical and Important\n   findings and review again until `PASS`, giving each re-review the round's diff and\n   previous findings, as in `feature-build`'s \"Recurse\" step. If it still fails after three\n   rounds, stop and report the findings.\n5. **Commit.** Keep the source commit's Conventional Commits type and scope, and its message\n   where it still describes the change. Add `Port of \u003Csource PR or SHA> to \u003Ctarget line>.` to\n   the body.\n6. **Open a draft PR.** Ask before pushing. Then open the PR as a draft against the target\n   line's integration branch, with `pr-describe` writing the body, per `git-workflow`. The body\n   links the source PR, and says what was adapted. Draft the matching one-line link for the\n   source PR (\"Ported to \u003Ctarget line> in #\u003Cn>\"). Never merge, however green the checks are.\n\n## Hand off\n\nThe port PR's link, what was verified (build, tests, end-to-end smoke, or \"not verified end to\nend\" and why), the review verdict, what was adapted, and the drafted link for the source PR.\n\n- **If another skill started this one**, return those and stop. That skill decides what runs\n  next.\n- **Otherwise**, post the source PR link on the user's yes, and offer to remove the worktree\n  once the port PR merges.\n\n## Rules\n\n- One target line per run, one worktree per target line. Porting to two lines is two runs.\n- Never merge, and never push to an integration branch directly.\n- Never skip a line's phase rule without the user asking.\n- Never port a change whose source PR is still open. Its review may still change it.\n","# change-backport\n\nTake one change that already exists on one line and land it on another, as its own reviewed\nPR. A port is a small, known change, so this skill makes the edit itself, the way `quick-fix`\ndoes, and still sends the result through the `reviewer`.\n\n## Scope\n\n- IN: a change with a concrete source (a commit, a merged PR, or a branch) moving to one other\n  line. Ports in either direction.\n- OUT: deciding the branch model or which lines exist. That's `git-workflow`'s \"Umbraco\n  packages and version tracking\" section. Writing the change in the first place: that's\n  `quick-fix` or the `feature-*` pipeline on the source line. A change that has to be\n  redesigned for the target line (a different extension point, an API that doesn't exist\n  there) is a new change: stop and suggest `feature-explore` on the target line. Moving the\n  whole package to a new CMS major is `major-upgrade`.\n\n## Argument\n\n`$ARGUMENTS` names the source change and, optionally, the target line. If the source is only\na description (\"the null check fix from last week\"), find the commit or PR and confirm it with\nthe user. Don't re-derive a fix from a description when a real commit exists. If no target is\ngiven and the project supports exactly two lines, the target is the other one; otherwise ask.\n\n## Preflight\n\n1. **Find the lines.** Read `CLAUDE.md` for the lines the project supports, each line's\n   integration branch, and each line's phase (active, security fixes only, or end of life). If\n   `CLAUDE.md` doesn't say, list the remote branches and ask; don't infer a phase from a\n   branch name.\n2. **Check the target should get it.**\n   - Active: features and fixes.\n   - Security fixes only: a security fix, nothing else.\n   - End of life: nothing, unless the user asks for it anyway.\n\n   Then check for a reason not to port: the source commit body or PR saying the change only\n   applies to one major (as `git-workflow` asks commits to say), or a project memory note. If\n   the change touches something that differs between the lines and you can't tell whether it\n   applies, ask.\n3. **Check it isn't already there.** Search the target line's history for the source PR\n   number, the commit subject, and the changed lines. A partial earlier port means you port\n   only the rest.\n4. **Read the whole change.** For a PR, list every commit in it, not only the last one. Note\n   any database migration and any public signature change.\n\n## Steps\n\n1. **Cut a fresh worktree on the target line.** Create it from the main checkout, never from\n   inside another worktree. Use the same mechanism `feature-build` uses (the project's\n   `WorktreeCreate` hook or Claude Code's native worktree), named for the change and the\n   target line, following `git-workflow`'s branch naming. Then confirm `pwd`, the branch, and\n   that its base is the target line's integration branch (`git log --oneline -3`). If the base\n   is wrong, stop and fix it before applying anything. Porting onto the wrong base is worse\n   than not porting.\n2. **Apply the change.**\n   - Clean commits: `git cherry-pick -x \u003Csha>...` in their original order. `-x` records the\n     source SHA in each message.\n   - Conflicts: read each one and resolve it by hand. Never take a side wholesale with\n     `--ours` or `--theirs`.\n   - Code that differs on the target line (a renamed type, an API the older CMS major doesn't\n     have): apply the diff by hand and adapt it to the target line's code. Load the stack\n     skills the change touches (`umbraco-package-conventions`, `ef-core-data`,\n     `umbraco-backoffice-conventions`, and so on), the same way `quick-fix` does.\n   - **A database migration:** copy the migration files, never generate them again on the\n     target line. See `ef-core-data`'s \"Porting a migration to another version line\".\n   - **An `[Obsolete]` member:** keep the same removal version as the source line, per\n     `umbraco-package-conventions`.\n3. **Verify on the target line.** Run the build, the tests, and the lint\u002Fformat check from\n   `CLAUDE.md` for the products the change touches. Then smoke it through the real entry point\n   on the target line's demo site, in the order `feature-build`'s \"Smoke the real entry point\"\n   step gives. Passing on the source line proves nothing here. If the site can't run, say \"not\n   verified end to end\" and why in the hand-off.\n4. **Review.** Dispatch one `reviewer` subagent (Agent tool, `subagent_type: reviewer`)\n   against the port's diff. Give it the source change as the task, and say what you adapted\n   and why, so it can check the adaptation and not only the code. Fix Critical and Important\n   findings and review again until `PASS`, giving each re-review the round's diff and\n   previous findings, as in `feature-build`'s \"Recurse\" step. If it still fails after three\n   rounds, stop and report the findings.\n5. **Commit.** Keep the source commit's Conventional Commits type and scope, and its message\n   where it still describes the change. Add `Port of \u003Csource PR or SHA> to \u003Ctarget line>.` to\n   the body.\n6. **Open a draft PR.** Ask before pushing. Then open the PR as a draft against the target\n   line's integration branch, with `pr-describe` writing the body, per `git-workflow`. The body\n   links the source PR, and says what was adapted. Draft the matching one-line link for the\n   source PR (\"Ported to \u003Ctarget line> in #\u003Cn>\"). Never merge, however green the checks are.\n\n## Hand off\n\nThe port PR's link, what was verified (build, tests, end-to-end smoke, or \"not verified end to\nend\" and why), the review verdict, what was adapted, and the drafted link for the source PR.\n\n- **If another skill started this one**, return those and stop. That skill decides what runs\n  next.\n- **Otherwise**, post the source PR link on the user's yes, and offer to remove the worktree\n  once the port PR merges.\n\n## Rules\n\n- One target line per run, one worktree per target line. Porting to two lines is two runs.\n- Never merge, and never push to an integration branch directly.\n- Never skip a line's phase rule without the user asking.\n- Never port a change whose source PR is still open. Its review may still change it.\n",{"name":5,"description":7,"argument-hint":24,"user-invocable":25},"\u003Ccommit SHA | PR number | branch> [target line, e.g. v17]",true,"main","a2f9c28bc56802b4e6db01e03972e497b30ad001","plugins\u002Fumbraco-devkit\u002Fskills\u002Fchange-backport",1,"https:\u002F\u002Fgithub.com\u002Fmattbrailsford\u002Fumbraco-devkit","https:\u002F\u002Fgithub.com\u002Fmattbrailsford","https:\u002F\u002Fmattbrailsford.dev","AI Staff Engineer @umbraco ","2026-11-12 18:33:53",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":25},[37,40,43],{"tool":38,"command":39},"npx","npx skills add mattbrailsford\u002Fumbraco-devkit --skill change-backport",{"tool":41,"command":42},"bunx","bunx skills add mattbrailsford\u002Fumbraco-devkit --skill change-backport",{"tool":44,"command":45},"pnpm","pnpm dlx skills add mattbrailsford\u002Fumbraco-devkit --skill change-backport","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmattbrailsford\u002Fumbraco-devkit\u002Fblob\u002Fmain\u002Fplugins\u002Fumbraco-devkit\u002Fskills\u002Fchange-backport\u002FSKILL.md",[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7CYGRPVNP8H9YNHGMZ6CP3C","user-stories","Writes, splits and refines user stories with Given\u002FWhen\u002FThen acceptance criteria in STORIES.md, feeding bdd-specs. Use when turning a feature request or a vague ask into a testable backlog entry.","https:\u002F\u002Fgithub.com\u002Fmattbrailsford\u002Fumbraco-devkit\u002Fblob\u002Fmain\u002Fplugins\u002Fumbraco-devkit\u002Fskills\u002Fuser-stories\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7CYGJB26N83DXKMDEKY2X48","umbraco-security","What Umbraco provides for keeping a package secure, on the server and in the backoffice: Management API authorization and policies, settings that hold secrets, endpoints outside the Management API, sanitizeHTML and escapeHTML, DOMPurify rules for custom elements, and umbHttpClient instead of handling tokens in the browser. Use when writing or reviewing a Management API controller, a secret setting, a custom endpoint, a backoffice template that uses unsafeHTML, or frontend code that calls an API.","https:\u002F\u002Fgithub.com\u002Fmattbrailsford\u002Fumbraco-devkit\u002Fblob\u002Fmain\u002Fplugins\u002Fumbraco-devkit\u002Fskills\u002Fumbraco-security\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7CYGBEZ2Q4AXDDNADWW4Q9H","umbraco-performance","Keeping a package fast on the sites that install it: the published cache over the services layer, tree traversal, caching lookups and clearing them, data type config and converter cache levels, output cache eviction, light hot paths, and backoffice screens that don't over-fetch. Use when writing, changing or reviewing code that runs per request, per save, per indexed item or at startup (property value converters, notification handlers, indexing), code that loops over every content item (a full rebuild, an import, a sync), or a list or search screen. Not for a site's own templates.","https:\u002F\u002Fgithub.com\u002Fmattbrailsford\u002Fumbraco-devkit\u002Fblob\u002Fmain\u002Fplugins\u002Fumbraco-devkit\u002Fskills\u002Fumbraco-performance\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7CYG59CZN1K2KERB0SSDGSY","umbraco-package-conventions","Backend conventions for an Umbraco package: async naming, internal by default, Attempt-based results for routine failures, public-API backwards compatibility, and where extension methods live. Use when naming a method, choosing visibility, shaping a service's result, changing a public signature (including adding a dependency to a public class's constructor), or organizing extension methods. For extension mechanisms, see `umbraco-extensibility`.","https:\u002F\u002Fgithub.com\u002Fmattbrailsford\u002Fumbraco-devkit\u002Fblob\u002Fmain\u002Fplugins\u002Fumbraco-devkit\u002Fskills\u002Fumbraco-package-conventions\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7CYG0J10QH8J2GS825WTTET","umbraco-marketplace","Gets a finished package listed on the Umbraco Marketplace: the NuGet tag, the dependency Marketplace reads version support from, the v14+ compatibility gotcha, and umbraco-marketplace.json. Use when a package is ready to publish, or when reviewing its packaging.","https:\u002F\u002Fgithub.com\u002Fmattbrailsford\u002Fumbraco-devkit\u002Fblob\u002Fmain\u002Fplugins\u002Fumbraco-devkit\u002Fskills\u002Fumbraco-marketplace\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7CYFT7MSYW4GRDSQRDPG020","umbraco-extensibility","Umbraco's extension mechanisms (Composers, collection builders, notification handlers, attribute discovery) and a catalogue of backend CMS extension points: property value converters, Management API endpoints, content finders, health checks, search indexing, package migrations, background jobs, and more. Use when making a feature extensible or choosing which extension point fits. Not for property editor UI, dashboards, sections or trees, which the official Backoffice Skills plugin covers.","https:\u002F\u002Fgithub.com\u002Fmattbrailsford\u002Fumbraco-devkit\u002Fblob\u002Fmain\u002Fplugins\u002Fumbraco-devkit\u002Fskills\u002Fumbraco-extensibility\u002FSKILL.md",[],[]]