[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EJCPRB6P54JYHBGEW8Y86P":3,"skill-same:01M7EJCPRB6P54JYHBGEW8Y86P":43},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M7EJCPRB6P54JYHBGEW8Y86P","dita-conref-push",null,"Audit DITA conref push (conaction) — validate pushbefore\u002Fpushafter\u002Fpushreplace operations, their mark-sibling pairing, and that the push targets resolve. Use when asked to check conref-push operations, debug content that isn't being pushed into a target, or before publishing content that uses conaction.","dogsbay\u002Fdogsbay-xml","dogsbay","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F15303289?v=4","01M7EJCARJ0K8B8ZV0ENKD6ZK2","01M7EJCAS22NW67CK69CDSW2Q5",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdogsbay\u002Fdogsbay-xml\u002Fblob\u002Fmain\u002Fxagent-core\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fdita-conref-push\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: dita-conref-push\ndescription: Audit DITA conref push (conaction) — validate pushbefore\u002Fpushafter\u002Fpushreplace operations, their mark-sibling pairing, and that the push targets resolve. Use when asked to check conref-push operations, debug content that isn't being pushed into a target, or before publishing content that uses conaction.\n---\n\n# DITA conref push (conaction)\n\nConref *push* is the inverse of conref pull: instead of a topic pulling shared content\nin, a source pushes its content **into** a target it references. `@conaction` drives it,\nand DITA-OT resolves it late (at build), so problems are easy to miss. The tool:\n`conref_push_audit` (inventory + pairing + target resolution).\n\n## The pairing rules (what the audit checks)\n\n- **pushbefore \u002F pushafter** — needs a sibling element with `conaction=\"mark\"` that\n  carries the `@conref`\u002F`@conkeyref` identifying *where* to push. A push with no mark\n  sibling pushes nowhere.\n- **mark** — needs a `pushbefore`\u002F`pushafter` sibling; a mark with nothing to push is\n  inert.\n- **pushreplace** — carries its **own** `@conref`\u002F`@conkeyref` to the element it\n  replaces; no separate mark.\n- The push target (`@conref` `file#topic\u002Fid`, or `@conkeyref` `key\u002Fid`) must **resolve**\n  to a real element — broken targets silently drop the push.\n\n## Process\n\n1. **Audit** — `conref_push_audit \u003Croot> --root-map \u003Cmap>` (the map resolves\n   `conkeyref` keys): the inventory of mark\u002Fpushbefore\u002Fpushafter\u002Fpushreplace, broken\n   **pairing**, and **unresolvable targets**.\n2. **Fix pairing** — add the missing `mark` (with the target `@conref`) for an orphan\n   push, or the missing push for an orphan mark; give a `pushreplace` its target.\n3. **Fix targets** — correct the `@conref` path\u002Fid or the `@conkeyref` key so it points\n   at a real element in a real file (the audit names the missing id).\n4. **Verify with the engine** — conref push only materializes at build; after fixing,\n   `validate_deep` (DITA-OT) confirms the pushed content lands where intended.\n\n## Report\n\nThe push operations found, the pairing\u002Ftarget problems and how each was fixed, and a\nnote to deep-validate. Conref push is reuse — for the pull side and warehousing, see\n[[dita-conref-reuse]] and [[dita-conref-audit]].\n","# DITA conref push (conaction)\n\nConref *push* is the inverse of conref pull: instead of a topic pulling shared content\nin, a source pushes its content **into** a target it references. `@conaction` drives it,\nand DITA-OT resolves it late (at build), so problems are easy to miss. The tool:\n`conref_push_audit` (inventory + pairing + target resolution).\n\n## The pairing rules (what the audit checks)\n\n- **pushbefore \u002F pushafter** — needs a sibling element with `conaction=\"mark\"` that\n  carries the `@conref`\u002F`@conkeyref` identifying *where* to push. A push with no mark\n  sibling pushes nowhere.\n- **mark** — needs a `pushbefore`\u002F`pushafter` sibling; a mark with nothing to push is\n  inert.\n- **pushreplace** — carries its **own** `@conref`\u002F`@conkeyref` to the element it\n  replaces; no separate mark.\n- The push target (`@conref` `file#topic\u002Fid`, or `@conkeyref` `key\u002Fid`) must **resolve**\n  to a real element — broken targets silently drop the push.\n\n## Process\n\n1. **Audit** — `conref_push_audit \u003Croot> --root-map \u003Cmap>` (the map resolves\n   `conkeyref` keys): the inventory of mark\u002Fpushbefore\u002Fpushafter\u002Fpushreplace, broken\n   **pairing**, and **unresolvable targets**.\n2. **Fix pairing** — add the missing `mark` (with the target `@conref`) for an orphan\n   push, or the missing push for an orphan mark; give a `pushreplace` its target.\n3. **Fix targets** — correct the `@conref` path\u002Fid or the `@conkeyref` key so it points\n   at a real element in a real file (the audit names the missing id).\n4. **Verify with the engine** — conref push only materializes at build; after fixing,\n   `validate_deep` (DITA-OT) confirms the pushed content lands where intended.\n\n## Report\n\nThe push operations found, the pairing\u002Ftarget problems and how each was fixed, and a\nnote to deep-validate. Conref push is reuse — for the pull side and warehousing, see\n[[dita-conref-reuse]] and [[dita-conref-audit]].\n",{"name":5,"description":7},"main","9d490f436eab257280b114519ea447bad5626d74","xagent-core\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fdita-conref-push","https:\u002F\u002Fgithub.com\u002Fdogsbay\u002Fdogsbay-xml","https:\u002F\u002Fgithub.com\u002Fdogsbay","2026-10-20 06:18:01",{"source":8,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add dogsbay\u002Fdogsbay-xml --skill dita-conref-push",{"tool":35,"command":36},"bunx","bunx skills add dogsbay\u002Fdogsbay-xml --skill dita-conref-push",{"tool":38,"command":39},"pnpm","pnpm dlx skills add dogsbay\u002Fdogsbay-xml --skill dita-conref-push","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdogsbay\u002Fdogsbay-xml\u002Fblob\u002Fmain\u002Fxagent-core\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fdita-conref-push\u002FSKILL.md",true,[],[44,52,59,65,72,79],{"skillNo":45,"name":46,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":48,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":18},"01M7EJF0ZNWMH5EGRNHMGM1BH7","valid-skill","A valid test skill for unit testing.","MIT","https:\u002F\u002Fgithub.com\u002Fdogsbay\u002Fdogsbay-xml\u002Fblob\u002Fmain\u002Fxagent-core\u002Fsrc\u002Ftest\u002Fresources\u002Ffixtures\u002Fskills\u002Fvalid-skill\u002FSKILL.md",[],[],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":18},"01M7EJF017TT1WAB2F6QM5Y89W","wrong-name","Name does not match directory.","https:\u002F\u002Fgithub.com\u002Fdogsbay\u002Fdogsbay-xml\u002Fblob\u002Fmain\u002Fxagent-core\u002Fsrc\u002Ftest\u002Fresources\u002Ffixtures\u002Fskills\u002Fname-mismatch\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":18},"01M7EJEZ301QVMP9V9R7JSY33Y","missing-description","https:\u002F\u002Fgithub.com\u002Fdogsbay\u002Fdogsbay-xml\u002Fblob\u002Fmain\u002Fxagent-core\u002Fsrc\u002Ftest\u002Fresources\u002Ffixtures\u002Fskills\u002Fmissing-description\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M7EJEWK86WC0CTQZ1T9RGZTJ","hidden-skill","A skill hidden from model invocation.","https:\u002F\u002Fgithub.com\u002Fdogsbay\u002Fdogsbay-xml\u002Fblob\u002Fmain\u002Fxagent-core\u002Fsrc\u002Ftest\u002Fresources\u002Ffixtures\u002Fskills\u002Fhidden-skill\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":18},"01M7EJEQTVC29QF1E3K1KGSTRK","dita-subject-schemes","Author or repair a DITA subjectScheme that governs conditional-processing attribute values (@platform, @audience, @product, @props, @otherprops), then validate content against it. Use when introducing controlled values, governing conditional content, or when validate_conditions reports controlled-value violations.","https:\u002F\u002Fgithub.com\u002Fdogsbay\u002Fdogsbay-xml\u002Fblob\u002Fmain\u002Fxagent-core\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fdita-subject-schemes\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EJEKED7TREFSJB2J5ZW3A6","dita-shortdesc","Write SEO-friendly DITA shortdescs and abstracts — a standalone one-sentence summary that doubles as the link preview and the HTML meta description. Use when asked to add or improve a topic's description\u002Fabstract, write shortdescs, fill missing ones, or make descriptions SEO-friendly.","https:\u002F\u002Fgithub.com\u002Fdogsbay\u002Fdogsbay-xml\u002Fblob\u002Fmain\u002Fxagent-core\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fdita-shortdesc\u002FSKILL.md",[],[]]