[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7FE7GYS67REKA0CPXBQZK81":3,"skill-same:01M7FE7GYS67REKA0CPXBQZK81":61},{"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":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7FE7GYS67REKA0CPXBQZK81","remove-comments",null,"Deletes the comments in a diff with a fresh subagent, keeping only license headers, outside constraints and public API docstrings, then fixes the code each deleted comment was propping up. Use before review, when implement or implement-spec finish their build, or when review-code flags comments.","Med-Karim-Ben-Boubaker\u002Fkarim-skills","Med-Karim-Ben-Boubaker","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F63352044?v=4","01M7FE4PT628J1M137P2SH4M5M","Karim Ben Boubaker","01M7FE4PV4JZRQT69G3TNBR5D0",1,"MIT","https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fremove-comments\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: remove-comments\ndescription: \"Deletes the comments in a diff with a fresh subagent, keeping only license headers, outside constraints and public API docstrings, then fixes the code each deleted comment was propping up. Use before review, when implement or implement-spec finish their build, or when review-code flags comments.\"\n---\n\n# Remove Comments\n\nThe code says what it does; a comment that has to explain our own code marks a name, a type or a shape to fix. This pass deletes comments and turns what they were covering for into fixes.\n\n## Scope\n\nThe files or diff the caller passes. Otherwise the current diff against the default branch, working tree included.\n\n## Steps\n\n1. **Spawn the reviewer.** Start one subagent with a fresh context. Its prompt is [references\u002Fcomment-reviewer.md](references\u002Fcomment-reviewer.md) verbatim, then the scope. It deletes comments and reports; it never changes application code.\n2. **Judge its report and diff.** Reject:\n   - edits to application code, or to files outside the scope;\n   - deletions of a comment the keep-list protects;\n   - a `MUST FIX` whose reason is wrong, or that flags intended code as a mistake.\n\n   A comment that explained a surprise in our own code stays deleted, with its `MUST FIX`. A kept comment stays only with proof it is about something we can't change. If a deletion or a keep is unclear, read the code it names until it isn't; when it is still unclear, the comment goes. Revert and rerun a rejected report once, naming what was wrong; if the second is wrong too, stop and report it open.\n3. **Fix the flags.** Fix the small ones directly: rename, delete a dead path, drop a parameter, use the real API. When a fix needs a new shape (a type, an extracted function, a moved responsibility), sketch it first, then build the smallest root-cause fix within the scope, as `principle-fix-root-causes` describes. Report fixes that need work outside the scope as open; don't widen the scope.\n4. **Encode claimed constraints.** A comment that said `do not remove`, `keep this order` or `talk to X before changing` claims a rule. Offer the user the cheapest check that enforces it: a type, a runtime assertion, a test or a lint. When they accept, add it and delete the comment; otherwise delete the comment and report the rule as unenforced. When running unattended, report the offer instead of waiting.\n5. **Report** in chat: comments deleted, comments kept and why, `MUST FIX` flags and what fixed each, constraints encoded or left open, reruns, and anything left open.\n","# Remove Comments\n\nThe code says what it does; a comment that has to explain our own code marks a name, a type or a shape to fix. This pass deletes comments and turns what they were covering for into fixes.\n\n## Scope\n\nThe files or diff the caller passes. Otherwise the current diff against the default branch, working tree included.\n\n## Steps\n\n1. **Spawn the reviewer.** Start one subagent with a fresh context. Its prompt is [references\u002Fcomment-reviewer.md](references\u002Fcomment-reviewer.md) verbatim, then the scope. It deletes comments and reports; it never changes application code.\n2. **Judge its report and diff.** Reject:\n   - edits to application code, or to files outside the scope;\n   - deletions of a comment the keep-list protects;\n   - a `MUST FIX` whose reason is wrong, or that flags intended code as a mistake.\n\n   A comment that explained a surprise in our own code stays deleted, with its `MUST FIX`. A kept comment stays only with proof it is about something we can't change. If a deletion or a keep is unclear, read the code it names until it isn't; when it is still unclear, the comment goes. Revert and rerun a rejected report once, naming what was wrong; if the second is wrong too, stop and report it open.\n3. **Fix the flags.** Fix the small ones directly: rename, delete a dead path, drop a parameter, use the real API. When a fix needs a new shape (a type, an extracted function, a moved responsibility), sketch it first, then build the smallest root-cause fix within the scope, as `principle-fix-root-causes` describes. Report fixes that need work outside the scope as open; don't widen the scope.\n4. **Encode claimed constraints.** A comment that said `do not remove`, `keep this order` or `talk to X before changing` claims a rule. Offer the user the cheapest check that enforces it: a type, a runtime assertion, a test or a lint. When they accept, add it and delete the comment; otherwise delete the comment and report the rule as unenforced. When running unattended, report the offer instead of waiting.\n5. **Report** in chat: comments deleted, comments kept and why, `MUST FIX` flags and what fixed each, constraints encoded or left open, reruns, and anything left open.\n",{"name":5,"description":7},"main","03f9278801a451ca8b532ae5be7195296143861a","skills\u002Fremove-comments",0,"https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills","https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker","https:\u002F\u002Fkarimbenboubaker.me\u002F","AI Engineer","2026-11-10 22:54:19",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add Med-Karim-Ben-Boubaker\u002Fkarim-skills --skill remove-comments",{"tool":39,"command":40},"bunx","bunx skills add Med-Karim-Ben-Boubaker\u002Fkarim-skills --skill remove-comments",{"tool":42,"command":43},"pnpm","pnpm dlx skills add Med-Karim-Ben-Boubaker\u002Fkarim-skills --skill remove-comments","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fremove-comments\u002FSKILL.md",true,[47,53,57],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"agents\u002Fopenai.yaml","REFERENCE","参考文档",118,"https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fremove-comments\u002Fagents\u002Fopenai.yaml",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"CREDITS.md",448,"https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fremove-comments\u002FCREDITS.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Fcomment-reviewer.md",2117,"https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fremove-comments\u002Freferences\u002Fcomment-reviewer.md",[62,69,76,83,90,97],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M7FE8Y56P42CZS85V5NWGQ0B","write-walkthrough","Guide you through running a demo yourself that shows a fix or a new feature working: a few numbered steps in the chat, each a command to copy or a click to make, with what you should see.","https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-walkthrough\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7FE8SY1WVS77ZM15VSX9H08","write-spec","Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've already discussed.","https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-spec\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7FE8Q2ZBJ61N6CEVFCVQPHR","write-questionnaire","Turn a decision you can't fully answer into a questionnaire for someone else to fill in.","https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-questionnaire\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"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},"01M7FE8JMMVYP23YHD3KQ43SH4","write-pr","Writes a PR or MR from a fixed template: the tickets it closes, a summary sketch, before and after evidence that proves each acceptance criterion (screenshots for visible changes), and merge danger (one-way or two-way door, blast radius). Use when opening, writing or updating a pull request or merge request.","https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-pr\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M7FE8EEG42Z95804TK2KT89R","write-issue","Files and moves issues on the repo's tracker (GitLab, GitHub or local files): one kind (bug, feature, chore) and one stage each, a title, the kind's template, and what each later stage needs. Use when filing, relabelling, moving or closing an issue, when work should be recorded instead of done now, or to split big work into child tickets.","https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-issue\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M7FE8AJW55TTN9R3KFHBC9T5","write-for-agents","How to write documents an agent reads: context pointers, information hierarchy, completion criteria, leading words and pruning, plus skill frontmatter and invocation mechanics. Use when creating or editing a skill, AGENTS.md, CLAUDE.md, or any doc an agent reaches through a pointer.","https:\u002F\u002Fgithub.com\u002FMed-Karim-Ben-Boubaker\u002Fkarim-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-for-agents\u002FSKILL.md",[],[]]