[{"data":1,"prerenderedAt":561},["ShallowReactive",2],{"navigation_docs_en":3,"dtpr-schemas-index":287,"-en-plugin-skills-comprehension-audit":295,"-en-plugin-skills-comprehension-audit-surround":556},[4,22,26,30,102,152,174,196,226,278,283],{"title":5,"path":6,"stem":7,"children":8},"Getting started","/en/getting-started","en/1.getting-started/0.index",[9,10,14,18],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13},"MCP quickstart","/en/getting-started/mcp-quickstart","en/1.getting-started/1.mcp-quickstart",{"title":15,"path":16,"stem":17},"REST quickstart","/en/getting-started/rest-quickstart","en/1.getting-started/2.rest-quickstart",{"title":19,"path":20,"stem":21},"UI quickstart","/en/getting-started/ui-quickstart","en/1.getting-started/3.ui-quickstart",{"title":23,"path":24,"stem":25},"Attribution","/en/attribution","en/10.attribution",{"title":27,"path":28,"stem":29},"Cite DTPR for AI","/en/cite","en/11.cite",{"title":31,"path":32,"stem":33,"children":34},"MCP server","/en/mcp","en/2.mcp/0.index",[35,36,40,44,48,98],{"title":31,"path":32,"stem":33},{"title":37,"path":38,"stem":39},"Connecting","/en/mcp/connection","en/2.mcp/1.connection",{"title":41,"path":42,"stem":43},"Envelope","/en/mcp/envelope","en/2.mcp/2.envelope",{"title":45,"path":46,"stem":47},"Resources","/en/mcp/resources","en/2.mcp/3.resources",{"title":49,"path":50,"stem":51,"children":52},"Tools","/en/mcp/tools","en/2.mcp/4.tools/0.index",[53,54,58,62,66,70,74,78,82,86,90,94],{"title":49,"path":50,"stem":51},{"title":55,"path":56,"stem":57},"list_schema_versions","/en/mcp/tools/list-schema-versions","en/2.mcp/4.tools/1.list-schema-versions",{"title":59,"path":60,"stem":61},"MCP tool: resolve_datachain","/en/mcp/tools/resolve-datachain","en/2.mcp/4.tools/10.resolve-datachain",{"title":63,"path":64,"stem":65},"MCP tool: validate_resolved","/en/mcp/tools/validate-resolved","en/2.mcp/4.tools/11.validate-resolved",{"title":67,"path":68,"stem":69},"get_schema","/en/mcp/tools/get-schema","en/2.mcp/4.tools/2.get-schema",{"title":71,"path":72,"stem":73},"list_categories","/en/mcp/tools/list-categories","en/2.mcp/4.tools/3.list-categories",{"title":75,"path":76,"stem":77},"list_elements","/en/mcp/tools/list-elements","en/2.mcp/4.tools/4.list-elements",{"title":79,"path":80,"stem":81},"get_element","/en/mcp/tools/get-element","en/2.mcp/4.tools/5.get-element",{"title":83,"path":84,"stem":85},"get_elements","/en/mcp/tools/get-elements","en/2.mcp/4.tools/6.get-elements",{"title":87,"path":88,"stem":89},"validate_datachain","/en/mcp/tools/validate-datachain","en/2.mcp/4.tools/7.validate-datachain",{"title":91,"path":92,"stem":93},"render_datachain","/en/mcp/tools/render-datachain","en/2.mcp/4.tools/8.render-datachain",{"title":95,"path":96,"stem":97},"get_icon_url","/en/mcp/tools/get-icon-url","en/2.mcp/4.tools/9.get-icon-url",{"title":99,"path":100,"stem":101},"Prompts","/en/mcp/prompts","en/2.mcp/5.prompts",{"title":103,"path":104,"stem":105,"children":106},"REST API (v2)","/en/rest","en/3.rest/0.index",[107,108,112,116,120,124,128,132,136,140,144,148],{"title":103,"path":104,"stem":105},{"title":109,"path":110,"stem":111},"GET /schemas","/en/rest/schemas","en/3.rest/1.schemas",{"title":113,"path":114,"stem":115},"POST /schemas/:version/resolve","/en/rest/resolve","en/3.rest/10.resolve",{"title":117,"path":118,"stem":119},"POST /schemas/:version/validate_resolved","/en/rest/validate-resolved","en/3.rest/11.validate-resolved",{"title":121,"path":122,"stem":123},"GET /schemas/:version/manifest","/en/rest/manifest","en/3.rest/2.manifest",{"title":125,"path":126,"stem":127},"GET /schemas/:version/categories","/en/rest/categories","en/3.rest/3.categories",{"title":129,"path":130,"stem":131},"GET /schemas/:version/elements","/en/rest/elements-list","en/3.rest/4.elements-list",{"title":133,"path":134,"stem":135},"GET /schemas/:version/elements/:element_id","/en/rest/element-detail","en/3.rest/5.element-detail",{"title":137,"path":138,"stem":139},"POST /schemas/:version/validate","/en/rest/validate","en/3.rest/6.validate",{"title":141,"path":142,"stem":143},"Icon routes","/en/rest/icons","en/3.rest/7.icons",{"title":145,"path":146,"stem":147},"Pagination & fields","/en/rest/pagination-and-fields","en/3.rest/8.pagination-and-fields",{"title":149,"path":150,"stem":151},"Errors","/en/rest/errors","en/3.rest/9.errors",{"title":153,"path":154,"stem":155,"children":156},"Icon composition","/en/icons","en/4.icons/0.index",[157,158,162,166,170],{"title":153,"path":154,"stem":155},{"title":159,"path":160,"stem":161},"Shapes","/en/icons/shapes","en/4.icons/1.shapes",{"title":163,"path":164,"stem":165},"Symbols","/en/icons/symbols","en/4.icons/2.symbols",{"title":167,"path":168,"stem":169},"Composed variants","/en/icons/composed-variants","en/4.icons/3.composed-variants",{"title":171,"path":172,"stem":173},"URLs","/en/icons/urls","en/4.icons/4.urls",{"title":175,"path":176,"stem":177,"children":178},"@dtpr/ui","/en/ui","en/5.ui/0.index",[179,180,184,188,192],{"title":175,"path":176,"stem":177},{"title":181,"path":182,"stem":183},"@dtpr/ui/core","/en/ui/core","en/5.ui/1.core",{"title":185,"path":186,"stem":187},"@dtpr/ui/vue","/en/ui/vue","en/5.ui/2.vue",{"title":189,"path":190,"stem":191},"@dtpr/ui/html","/en/ui/html","en/5.ui/3.html",{"title":193,"path":194,"stem":195},"Theming","/en/ui/theming","en/5.ui/4.theming",{"title":197,"path":198,"stem":199,"children":200},"Concepts","/en/concepts","en/6.concepts/0.index",[201,202,206,210,214,218,222],{"title":197,"path":198,"stem":199},{"title":203,"path":204,"stem":205},"Datachains","/en/concepts/datachains","en/6.concepts/1.datachains",{"title":207,"path":208,"stem":209},"Elements & categories","/en/concepts/elements-categories","en/6.concepts/2.elements-categories",{"title":211,"path":212,"stem":213},"Versions & releases","/en/concepts/versions-and-releases","en/6.concepts/3.versions-and-releases",{"title":215,"path":216,"stem":217},"Content hash","/en/concepts/content-hash","en/6.concepts/4.content-hash",{"title":219,"path":220,"stem":221},"Shape contract","/en/concepts/shape-contract","en/6.concepts/5.shape-contract",{"title":223,"path":224,"stem":225},"Subchains","/en/concepts/subchains","en/6.concepts/6.subchains",{"title":227,"path":228,"stem":229,"children":230},"Claude plugin","/en/plugin","en/7.plugin/0.index",[231,232,236,270,274],{"title":227,"path":228,"stem":229},{"title":233,"path":234,"stem":235},"Install","/en/plugin/install","en/7.plugin/1.install",{"title":237,"path":238,"stem":239,"children":240},"Skills","/en/plugin/skills","en/7.plugin/2.skills/0.index",[241,242,246,250,254,258,262,266],{"title":237,"path":238,"stem":239},{"title":243,"path":244,"stem":245},"dtpr-describe-system","/en/plugin/skills/describe-system","en/7.plugin/2.skills/1.describe-system",{"title":247,"path":248,"stem":249},"dtpr-datachain-structure","/en/plugin/skills/datachain-structure","en/7.plugin/2.skills/2.datachain-structure",{"title":251,"path":252,"stem":253},"dtpr-category-audit","/en/plugin/skills/category-audit","en/7.plugin/2.skills/3.category-audit",{"title":255,"path":256,"stem":257},"dtpr-element-design","/en/plugin/skills/element-design","en/7.plugin/2.skills/4.element-design",{"title":259,"path":260,"stem":261},"dtpr-symbol-design","/en/plugin/skills/symbol-design","en/7.plugin/2.skills/5.symbol-design",{"title":263,"path":264,"stem":265},"dtpr-translate","/en/plugin/skills/translate","en/7.plugin/2.skills/6.translate",{"title":267,"path":268,"stem":269},"dtpr-comprehension-audit","/en/plugin/skills/comprehension-audit","en/7.plugin/2.skills/7.comprehension-audit",{"title":271,"path":272,"stem":273},"Research corpus","/en/plugin/research-corpus","en/7.plugin/3.research-corpus",{"title":275,"path":276,"stem":277},"Comprehension rubric","/en/plugin/comprehension-rubric","en/7.plugin/4.comprehension-rubric",{"title":49,"path":279,"stem":280,"children":281},"/en/tools","en/8.tools/0.index",[282],{"title":49,"path":279,"stem":280},{"title":284,"path":285,"stem":286},"Changelog","/en/changelog","en/9.changelog",{"ok":288,"versions":289},true,[290],{"id":291,"status":292,"created_at":293,"content_hash":294},"ai@2026-05-06-beta","beta","2026-05-06T20:23:42.963Z","sha256-2d208111b0c597ff2b38cb1c24168799b0a5ff9290203ebf46c4f7c16a0fcb24",{"id":296,"title":267,"body":297,"description":550,"extension":551,"links":552,"meta":553,"navigation":288,"path":268,"seo":554,"stem":269,"__hash__":555},"docs_en/en/7.plugin/2.skills/7.comprehension-audit.md",{"type":298,"value":299,"toc":540},"minimark",[300,315,346,351,374,378,381,385,391,428,445,466,486,492,496,513,517,523,527],[301,302,303,304,309,310,314],"p",{},"The standalone comprehension-tier skill. Grades DTPR content against the ",[305,306,308],"a",{"href":307},"/plugin/comprehension-rubric","comprehension rubric"," and returns a structured findings block plus a one-paragraph summary. ",[311,312,313],"strong",{},"Grading only"," — it does not modify schema content, draft elements, or change category structure.",[301,316,317,318,322,323,328,329,328,334,339,340,345],{},"The four authoring skills that emit ",[319,320,321],"code",{},"schema:new"," proposals (",[305,324,326],{"href":325},"/plugin/skills/datachain-structure",[319,327,247],{},", ",[305,330,332],{"href":331},"/plugin/skills/category-audit",[319,333,251],{},[305,335,337],{"href":336},"/plugin/skills/element-design",[319,338,255],{},", and ",[305,341,343],{"href":342},"/plugin/skills/translate",[319,344,263],{},") inline a first-pass Comprehension check in their output. Use this skill for a deeper second pass, a re-grade after the rubric evolves, or a one-off grading without schema work.",[347,348,350],"h2",{"id":349},"when-to-fire","When to fire",[352,353,354,358,361,364,367],"ul",{},[355,356,357],"li",{},"The user asks to grade, audit, or check a DTPR element, category, datachain-instance, or pasted content for public comprehension.",[355,359,360],{},"The user uses \"comprehension audit\", \"is this clear\", \"how readable is X\", or \"does this land for a non-expert\".",[355,362,363],{},"A schema-tier skill's inline Comprehension check needs a deeper standalone second pass.",[355,365,366],{},"The user pastes YAML, JSON, or markdown and asks whether it would be understood by a non-technical person encountering an AI system — in an app, on a website, in a vehicle, on a kiosk or sign, or any other surface where DTPR content might appear.",[355,368,369,370,373],{},"The user wants to re-grade after the rubric's ",[319,371,372],{},"rubric_version"," has changed.",[347,375,377],{"id":376},"trigger-phrases","Trigger phrases",[301,379,380],{},"\"grade this element\", \"is this category clear to the public\", \"comprehension audit\", \"check this datachain for public understanding\", \"how readable is X\", \"does this land for a non-expert\".",[347,382,384],{"id":383},"workflow","Workflow",[301,386,387,390],{},[311,388,389],{},"Phase 0 — Identify the target."," Classifies the input as an element id, category id, pasted element YAML, datachain-instance JSON, arbitrary markdown, or a mix. Asks a structured clarification question if ambiguous.",[301,392,393,396,397,328,402,407,408,328,411,328,416,421,422,427],{},[311,394,395],{},"Phase 1 — Load the target content."," Uses ",[305,398,400],{"href":399},"/mcp/tools/get-element",[319,401,79],{},[305,403,405],{"href":404},"/mcp/tools/list-elements",[319,406,75],{}," with ",[319,409,410],{},"query",[305,412,414],{"href":413},"/mcp/tools/list-categories",[319,415,71],{},[305,417,419],{"href":418},"/mcp/tools/get-schema",[319,420,67],{},", or ",[305,423,425],{"href":424},"/mcp/tools/get-elements",[319,426,83],{}," as the input type requires. Pasted content is graded directly without an MCP read.",[301,429,430,433,434,437,438,441,442,444],{},[311,431,432],{},"Phase 2 — Read the rubric and template."," Reads ",[319,435,436],{},"references/comprehension-rubric.md"," and ",[319,439,440],{},"references/comprehension-block-template.md"," at runtime. Captures the ",[319,443,372],{}," from the rubric's frontmatter.",[301,446,447,450,451,455,456,328,459,421,462,465],{},[311,448,449],{},"Phase 3 — Corpus lookup."," Reads the ",[305,452,454],{"href":453},"/plugin/research-corpus","research corpus"," with tags like ",[319,457,458],{},"category:\u003Cid>",[319,460,461],{},"element:\u003Cid>",[319,463,464],{},"concept:\u003Cslug>",". Writes a corpus entry only when the finding is a non-obvious insight worth compounding.",[301,467,468,471,472,475,476,475,479,475,482,485],{},[311,469,470],{},"Phase 4 — Apply the rubric item by item."," One verdict per item (",[319,473,474],{},"pass"," / ",[319,477,478],{},"fail",[319,480,481],{},"partial",[319,483,484],{},"n/a",") with a one-line reason that names the specific phrase, element, or pattern that drove the verdict.",[301,487,488,491],{},[311,489,490],{},"Phase 5 — Emit findings."," The inline block (exact template shape) plus a one-paragraph summary that names the top fix(es) and routes the user to a sibling skill when a gap needs schema-level fixing.",[347,493,495],{"id":494},"output","Output",[497,498,499,510],"ol",{},[355,500,501,502,505,506,509],{},"The ",[311,503,504],{},"Comprehension check"," block (verdicts + reasons + ",[319,507,508],{},"Rubric version:"," trailer).",[355,511,512],{},"A one-paragraph summary that names the top one or two fixes and any sibling-skill handoff.",[347,514,516],{"id":515},"non-goals","Non-goals",[301,518,519,520,522],{},"Does not modify schema content — edits happen in the schema-tier skills and are committed by humans after running ",[319,521,321],{},". Does not replace the inline Comprehension block that the schema-tier skills emit as part of their proposals. Does not translate or localize content — locale coverage is graded as a rubric item but actual translation is out of scope.",[347,524,526],{"id":525},"source","Source",[301,528,529,532,533,539],{},[319,530,531],{},"plugin/dtpr/skills/dtpr-comprehension-audit/SKILL.md"," in the ",[305,534,538],{"href":535,"rel":536},"https://github.com/Helpful-Places/dtpr/blob/main/plugin/dtpr/skills/dtpr-comprehension-audit/SKILL.md",[537],"nofollow","repository",".",{"title":541,"searchDepth":542,"depth":542,"links":543},"",2,[544,545,546,547,548,549],{"id":349,"depth":542,"text":350},{"id":376,"depth":542,"text":377},{"id":383,"depth":542,"text":384},{"id":494,"depth":542,"text":495},{"id":515,"depth":542,"text":516},{"id":525,"depth":542,"text":526},"Grade any DTPR content (element, category, datachain-instance, pasted YAML, arbitrary markdown) against the public-comprehension rubric.","md",null,{},{"title":267,"description":550},"dHPblnEerQh-RA-7SKlWYkfRCmk5RiBOw58uKkVplio",[557,559],{"title":263,"path":264,"stem":265,"description":558,"children":-1},"Fill in non-English locale rows on a DTPR element, category, datachain-type name, or pasted English fragment — against the active schema manifest's locale allow-list, never a hardcoded list.",{"title":271,"path":272,"stem":273,"description":560,"children":-1},"A file-based, author-seeded knowledge base that compounds across DTPR authoring sessions.",1779049700716]