[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EJCZAXFFF06V92SZ6YHSG3":3,"skill-same:01M7EJCZAXFFF06V92SZ6YHSG3":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},"01M7EJCZAXFFF06V92SZ6YHSG3","dita-deliverables",null,"Work with DITA-OT deliverables — the project's defined outputs (root map + DITAVAL filter + transtype + params). Use when asked to validate or build specific outputs, add\u002Fchange a deliverable, understand a project's publication set, or deep-validate beyond static checks.","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-deliverables\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: dita-deliverables\ndescription: Work with DITA-OT deliverables — the project's defined outputs (root map + DITAVAL filter + transtype + params). Use when asked to validate or build specific outputs, add\u002Fchange a deliverable, understand a project's publication set, or deep-validate beyond static checks.\n---\n\n# DITA deliverables and publishing\n\nA **deliverable** is one publishable output, declared in a DITA-OT **project file**\n(`project.{json,xml,yaml}` — the standard name; never rename it): a root map, an\noptional DITAVAL filter, a transtype, an output dir, and publication params. Tools:\n`get_project`, `validate_deliverables`, `validate_deep`, `build_deliverables`.\n\n## Key facts\n\n- **The project file is the source of truth**, and DITA teams own it — edit it\n  field-preservingly (don't reformat or invent a new format). One project usually\n  ships several deliverables (e.g. full guide; a beginner guide filtered for mac and\n  for windows; a PDF).\n- **DITAVAL = conditional filtering.** A deliverable's `.ditaval` decides which\n  `@platform`\u002F`@audience`\u002F`@props`-tagged content is kept. A \"mac\" build and a\n  \"windows\" build are the *same* topics, filtered differently — validate and build\n  each, don't assume one covers the others. (Govern the allowed condition values with\n  [[dita-subject-schemes]].)\n- **Publication params have three forms** — `value` (literal, passed as-is), `href`\n  (resolved to a URI relative to the project file), `path` (resolved to an absolute\n  filesystem path, e.g. `args.cssroot`). A relative path put in `value` won't\n  resolve — choose `href`\u002F`path` for resource params.\n\n## Process\n\n1. **Understand the set** — `get_project` lists the deliverables (root map, ditaval,\n   transtype, params, source file). To see what each one actually publishes, and how\n   two outputs differ, read `deliverables[].ships` from `project_graph`; it also\n   reports keys that resolve in some deliverables and not others\n   ([[dita-project-graph]]).\n2. **Static validate per output** — `validate_deliverables` validates each\n   deliverable's publication set (unfiltered: DITAVAL is not applied) and reports\n   each invalid file once with the deliverables it breaks; report which *outputs* an\n   error affects.\n3. **Deep validate when needed** — `validate_deep` runs DITA-OT preprocessing to\n   catch what static checks can't: broken keyref\u002Fconref **after** key resolution and\n   filtering, map\u002Ftopic resolution. Requires DITA-OT. Do this before declaring a\n   deliverable publish-ready.\n4. **Build** — `build_deliverables` produces the outputs (applying each ditaval +\n   params). Build one, or all.\n\n## Report\n\nThe deliverables and which outputs are affected by each finding, the deep-validation\nresult, and what was built. To restructure the maps a deliverable points at, use\n[[dita-map-editing]].\n","# DITA deliverables and publishing\n\nA **deliverable** is one publishable output, declared in a DITA-OT **project file**\n(`project.{json,xml,yaml}` — the standard name; never rename it): a root map, an\noptional DITAVAL filter, a transtype, an output dir, and publication params. Tools:\n`get_project`, `validate_deliverables`, `validate_deep`, `build_deliverables`.\n\n## Key facts\n\n- **The project file is the source of truth**, and DITA teams own it — edit it\n  field-preservingly (don't reformat or invent a new format). One project usually\n  ships several deliverables (e.g. full guide; a beginner guide filtered for mac and\n  for windows; a PDF).\n- **DITAVAL = conditional filtering.** A deliverable's `.ditaval` decides which\n  `@platform`\u002F`@audience`\u002F`@props`-tagged content is kept. A \"mac\" build and a\n  \"windows\" build are the *same* topics, filtered differently — validate and build\n  each, don't assume one covers the others. (Govern the allowed condition values with\n  [[dita-subject-schemes]].)\n- **Publication params have three forms** — `value` (literal, passed as-is), `href`\n  (resolved to a URI relative to the project file), `path` (resolved to an absolute\n  filesystem path, e.g. `args.cssroot`). A relative path put in `value` won't\n  resolve — choose `href`\u002F`path` for resource params.\n\n## Process\n\n1. **Understand the set** — `get_project` lists the deliverables (root map, ditaval,\n   transtype, params, source file). To see what each one actually publishes, and how\n   two outputs differ, read `deliverables[].ships` from `project_graph`; it also\n   reports keys that resolve in some deliverables and not others\n   ([[dita-project-graph]]).\n2. **Static validate per output** — `validate_deliverables` validates each\n   deliverable's publication set (unfiltered: DITAVAL is not applied) and reports\n   each invalid file once with the deliverables it breaks; report which *outputs* an\n   error affects.\n3. **Deep validate when needed** — `validate_deep` runs DITA-OT preprocessing to\n   catch what static checks can't: broken keyref\u002Fconref **after** key resolution and\n   filtering, map\u002Ftopic resolution. Requires DITA-OT. Do this before declaring a\n   deliverable publish-ready.\n4. **Build** — `build_deliverables` produces the outputs (applying each ditaval +\n   params). Build one, or all.\n\n## Report\n\nThe deliverables and which outputs are affected by each finding, the deep-validation\nresult, and what was built. To restructure the maps a deliverable points at, use\n[[dita-map-editing]].\n",{"name":5,"description":7},"main","9d490f436eab257280b114519ea447bad5626d74","xagent-core\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fdita-deliverables","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-deliverables",{"tool":35,"command":36},"bunx","bunx skills add dogsbay\u002Fdogsbay-xml --skill dita-deliverables",{"tool":38,"command":39},"pnpm","pnpm dlx skills add dogsbay\u002Fdogsbay-xml --skill dita-deliverables","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdogsbay\u002Fdogsbay-xml\u002Fblob\u002Fmain\u002Fxagent-core\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fdita-deliverables\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",[],[]]