[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79BMPEYVBH6T77GSZH8819Y":3,"skill-same:01M79BMPEYVBH6T77GSZH8819Y":65},{"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":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M79BMPEYVBH6T77GSZH8819Y","check-markdown-structure",null,"Compare the structural skeleton of two Markdown documents and report where they stop lining up. Use after producing a translated or rewritten version of a document to confirm that headings, code blocks, tables, quotes, images, lists, and rules still appear in the same order. Reads only and never edits. Takes two file paths, in either language, in either direction.","MacHu-GWU\u002Fshsk_lesson_smith-project","MacHu-GWU","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6800411?v=4","01M79BMG0V767YAMAMTG1ZQ7FY","Sanhe Hu","01M79BMG1XDNB3Q6B6A60FBMEH",0,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcheck-markdown-structure\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: check-markdown-structure\ndescription: Compare the structural skeleton of two Markdown documents and report where they stop lining up. Use after producing a translated or rewritten version of a document to confirm that headings, code blocks, tables, quotes, images, lists, and rules still appear in the same order. Reads only and never edits. Takes two file paths, in either language, in either direction.\nargument-hint: \"--left \u003Ca.md> --right \u003Cb.md> [--inventory] [--json_output]\"\n---\n\n# Check that two Markdown documents still line up\n\n## 1. What this does, and what it will not do\n\nIt reads two Markdown files, lists the block elements each one is built from, lines the two\nsequences up, and prints where they part ways.\n\n**It makes no edits. It proposes none.** Fixing a divergence belongs to whoever wrote the\ndocument, using whatever rewrite skill produced it. Keeping detection separate from repair is\nwhat lets a rewrite step and a check step be composed in any order, and it is the reason this\nskill has no opinions about writing.\n\nIt also does not judge the prose. Whether the English reads well is not a question a script can\nanswer, and pretending otherwise has cost this project more than it ever returned.\n\n---\n\n## 2. When to run it\n\nAfter a document has been rewritten into another language, compare the version you rewrote from\nagainst the version you produced.\n\n```bash\npython3 ${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fcheck-markdown-structure\u002Fscripts\u002Fstructure_report.py \\\n    --left lesson-cn.md --right lesson.md\n```\n\nIf `${CLAUDE_PLUGIN_ROOT}` is not set, the script sits at\n`\u003Cplugin-root>\u002Fskills\u002Fcheck-markdown-structure\u002Fscripts\u002Fstructure_report.py`, where\n`\u003Cplugin-root>` is the directory holding `.claude-plugin\u002Fplugin.json`.\n\n`--left` is the document you rewrote from and `--right` is the one you produced. Add\n`--inventory` to also list each file's elements on its own, and `--json_output` to parse the\nresult instead of reading the table. Exit code 0 means the skeletons agree, 1 means they\ndiverge, 2 is a usage error.\n\n**Do not run it across a restyle in the same language.** Restyling is allowed to add a table,\nsplit a section, or drop a paragraph, so a divergence there carries no information.\n\n**Do not run it across a whole document set.** Consistency between sibling documents depends on\nhow a particular batch was organized, which is a property of your workflow and not of this\nplugin. This skill compares exactly two files.\n\n---\n\n## 3. What it compares, and what it deliberately ignores\n\nElements tracked, in document order: **headings** with their level, **code blocks** with their\nlanguage, **tables**, **blockquotes**, **images**, **lists** with their kind and item count, and\n**horizontal rules**. Front matter is skipped as metadata.\n\n**Matching is by element type and position, never by text.** The two documents are usually in\ndifferent languages, so heading text cannot line up and is not expected to. The excerpt printed\nbeside each element is there for you to recognize it by, not for the comparison.\n\nThree kinds do carry content that should survive a translation untouched, and those are compared\nfor real:\n\n| Kind | What is compared |\n| :--- | :--- |\n| Code block | The body. Comments are stripped before the comparison, since a comment is prose and is supposed to be translated. A block whose comments moved but whose code did not is marked `~` and is not a finding |\n| Table | Row and column count |\n| Image | The path |\n\n---\n\n## 4. Reading the report\n\n```text\n    #  lesson-cn.md                                  lesson.md\n  -----------------------------------------------------------------------------\n   15  h2            5. 你会的其实是一条完整的主线  =  h2       5. What you know is really\n   16  image         在 Licensing 页面查看当前套餐  -\n   17  table 5x3     机器配置 倍率 每月实际可用时长 !  table 4x3  Machine size Multiplier Real\n```\n\n| Mark | Meaning |\n| :--- | :--- |\n| `=` | Same kind in the same place |\n| `-` | Present on the left only |\n| `+` | Present on the right only |\n| `x` | Different kind in the same place |\n| `!` | Same kind, but the content check failed |\n| `~` | Code block whose comments were translated and whose code is unchanged. Not a finding |\n\nA run of `+` or `-` followed by the sequence resyncing means something was inserted or dropped.\nA long tail of `x` means the two documents went out of step earlier and never recovered, so read\nupward to the first divergence rather than treating each line as its own problem.\n\n---\n\n## 5. What to do with a finding\n\nReport it. Name the file, the line, and the element. Then stop.\n\nIf you are being asked to repair as well, that is a separate instruction and a separate step:\nopen the document that is wrong, put the missing element back or take the extra one out, and\nleave every sentence around it alone. A structural repair that rewrites neighboring prose is a\nworse outcome than the divergence it fixed.\n\n**One divergence is not automatically a defect.** A rewriter may have had a real reason, and the\nauthor is the one who decides. Say what diverged and let them rule on it.\n","# Check that two Markdown documents still line up\n\n## 1. What this does, and what it will not do\n\nIt reads two Markdown files, lists the block elements each one is built from, lines the two\nsequences up, and prints where they part ways.\n\n**It makes no edits. It proposes none.** Fixing a divergence belongs to whoever wrote the\ndocument, using whatever rewrite skill produced it. Keeping detection separate from repair is\nwhat lets a rewrite step and a check step be composed in any order, and it is the reason this\nskill has no opinions about writing.\n\nIt also does not judge the prose. Whether the English reads well is not a question a script can\nanswer, and pretending otherwise has cost this project more than it ever returned.\n\n---\n\n## 2. When to run it\n\nAfter a document has been rewritten into another language, compare the version you rewrote from\nagainst the version you produced.\n\n```bash\npython3 ${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fcheck-markdown-structure\u002Fscripts\u002Fstructure_report.py \\\n    --left lesson-cn.md --right lesson.md\n```\n\nIf `${CLAUDE_PLUGIN_ROOT}` is not set, the script sits at\n`\u003Cplugin-root>\u002Fskills\u002Fcheck-markdown-structure\u002Fscripts\u002Fstructure_report.py`, where\n`\u003Cplugin-root>` is the directory holding `.claude-plugin\u002Fplugin.json`.\n\n`--left` is the document you rewrote from and `--right` is the one you produced. Add\n`--inventory` to also list each file's elements on its own, and `--json_output` to parse the\nresult instead of reading the table. Exit code 0 means the skeletons agree, 1 means they\ndiverge, 2 is a usage error.\n\n**Do not run it across a restyle in the same language.** Restyling is allowed to add a table,\nsplit a section, or drop a paragraph, so a divergence there carries no information.\n\n**Do not run it across a whole document set.** Consistency between sibling documents depends on\nhow a particular batch was organized, which is a property of your workflow and not of this\nplugin. This skill compares exactly two files.\n\n---\n\n## 3. What it compares, and what it deliberately ignores\n\nElements tracked, in document order: **headings** with their level, **code blocks** with their\nlanguage, **tables**, **blockquotes**, **images**, **lists** with their kind and item count, and\n**horizontal rules**. Front matter is skipped as metadata.\n\n**Matching is by element type and position, never by text.** The two documents are usually in\ndifferent languages, so heading text cannot line up and is not expected to. The excerpt printed\nbeside each element is there for you to recognize it by, not for the comparison.\n\nThree kinds do carry content that should survive a translation untouched, and those are compared\nfor real:\n\n| Kind | What is compared |\n| :--- | :--- |\n| Code block | The body. Comments are stripped before the comparison, since a comment is prose and is supposed to be translated. A block whose comments moved but whose code did not is marked `~` and is not a finding |\n| Table | Row and column count |\n| Image | The path |\n\n---\n\n## 4. Reading the report\n\n```text\n    #  lesson-cn.md                                  lesson.md\n  -----------------------------------------------------------------------------\n   15  h2            5. 你会的其实是一条完整的主线  =  h2       5. What you know is really\n   16  image         在 Licensing 页面查看当前套餐  -\n   17  table 5x3     机器配置 倍率 每月实际可用时长 !  table 4x3  Machine size Multiplier Real\n```\n\n| Mark | Meaning |\n| :--- | :--- |\n| `=` | Same kind in the same place |\n| `-` | Present on the left only |\n| `+` | Present on the right only |\n| `x` | Different kind in the same place |\n| `!` | Same kind, but the content check failed |\n| `~` | Code block whose comments were translated and whose code is unchanged. Not a finding |\n\nA run of `+` or `-` followed by the sequence resyncing means something was inserted or dropped.\nA long tail of `x` means the two documents went out of step earlier and never recovered, so read\nupward to the first divergence rather than treating each line as its own problem.\n\n---\n\n## 5. What to do with a finding\n\nReport it. Name the file, the line, and the element. Then stop.\n\nIf you are being asked to repair as well, that is a separate instruction and a separate step:\nopen the document that is wrong, put the missing element back or take the extra one out, and\nleave every sentence around it alone. A structural repair that rewrites neighboring prose is a\nworse outcome than the divergence it fixed.\n\n**One divergence is not automatically a defect.** A rewriter may have had a real reason, and the\nauthor is the one who decides. Say what diverged and let them rule on it.\n",{"name":5,"description":7,"argument-hint":24},"--left \u003Ca.md> --right \u003Cb.md> [--inventory] [--json_output]","main","ef0f8eefce29dea12070e85b2da80f4be0b9d4fb",".claude\u002Fskills\u002Fcheck-markdown-structure","https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project","https:\u002F\u002Fshsk-lesson-smith.readthedocs.io\u002F","https:\u002F\u002Fgithub.com\u002FMacHu-GWU","Founder mindset, engineer’s hands. Customers first, product second. Forward-deployed AI architect · ex-AWS · 200+ OSS libs · 4K+ commits\u002Fyr","2026-10-01 01:47:58",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add MacHu-GWU\u002Fshsk_lesson_smith-project --skill check-markdown-structure",{"tool":39,"command":40},"bunx","bunx skills add MacHu-GWU\u002Fshsk_lesson_smith-project --skill check-markdown-structure",{"tool":42,"command":43},"pnpm","pnpm dlx skills add MacHu-GWU\u002Fshsk_lesson_smith-project --skill check-markdown-structure","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcheck-markdown-structure\u002FSKILL.md",true,[47,53,59],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"CHANGELOG.md","REFERENCE","参考文档",1096,"https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcheck-markdown-structure\u002FCHANGELOG.md",{"path":54,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":57,"sourceHtmlUrl":58},"scripts\u002Fstructure_report.py","SCRIPT","脚本",17149,"https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcheck-markdown-structure\u002Fscripts\u002Fstructure_report.py",{"path":60,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":63,"sourceHtmlUrl":64},"VERSION","OTHER","其他",5,"https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcheck-markdown-structure\u002FVERSION",[66,73,80,85,90,96],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M79BVJQ839NXWYW9YG7PSVNF","upskill-quiz-cn","这门课的面试式自测. 一道道问下去, 逼你说清为什么, 而不只是是什么.","https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002Ftests\u002Fgood_upskill_repo\u002F.claude\u002Fskills\u002Fupskill-quiz-cn\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M79BVF959YEX1W6B1AR7AAX0","upskill-learn-cn","这门课的领路人. 要地图, 要拆开某一处, 或者卡住了出不来, 都找它.","https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002Ftests\u002Fgood_upskill_repo\u002F.claude\u002Fskills\u002Fupskill-learn-cn\u002FSKILL.md",[],[],{"skillNo":81,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M79BVDFCA7GYEQ6Q4XV1RWVB","https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002Ftests\u002Fgood_upskill_repo\u002F.agents\u002Fskills\u002Fupskill-quiz-cn\u002FSKILL.md",[],[],{"skillNo":86,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M79BVC28KMZ3APP4N3WQ0QQ2","https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002Ftests\u002Fgood_upskill_repo\u002F.agents\u002Fskills\u002Fupskill-learn-cn\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M79BV8AZ8SSB4R4ZKCNHZW8N","showcase-quiz-cn","https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002Ftests\u002Fgood_showcase_repo\u002F.claude\u002Fskills\u002Fshowcase-quiz-cn\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M79BV4TQSJTJWW9B36K11C7Y","showcase-publish-cn","把这个 repo 变成能放上你自己 GitHub 的作品. 抹掉教学痕迹, 再回头查一遍.","https:\u002F\u002Fgithub.com\u002FMacHu-GWU\u002Fshsk_lesson_smith-project\u002Fblob\u002Fmain\u002Ftests\u002Fgood_showcase_repo\u002F.claude\u002Fskills\u002Fshowcase-publish-cn\u002FSKILL.md",[],[]]