[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CP14D212M9521ABJ7CHR2S":3,"skill-same:01M7CP14D212M9521ABJ7CHR2S":49},{"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":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7CP14D212M9521ABJ7CHR2S","no-comments",null,"Code comments judged against a keep list. Use when adding or changing code comments, or when asked to remove comments.","syanga\u002Fastack","syanga","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F42523849?v=4","01M7CNYD2SW40HXC8R8CTVJPGE","Alan Yang","01M7CNYD3D0B0EYPA4AGXC1VC8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fno-comments\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fno-comments\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: no-comments\ndescription: Code comments judged against a keep list. Use when adding or changing code comments, or when asked to remove comments.\n---\n\n# Delete the comments\n\nDuring other work, check only the comment text you write against the [keep list](#keep-list). Leave every existing comment the request does not name as it is, even one this skill would delete or your new comment makes redundant. Mention such a comment in your reply instead. When the user asks to remove comments, or a workflow tells you to apply this skill, run the whole procedure below.\n\nDelete every comment in scope that is not on the keep list. Flag the code that needed a comment to be understood, then fix what the flags name. A flag is one line in the report naming a symbol that needed a comment. Every flag names code inside the scope and tells the truth.\n\n## Scope\n\nUse the files or diff the caller names. With no caller scope, use the current diff against the base branch, `main` by default, including the working tree.\n\n## Keep list\n\nOnly these comments survive. Each of the first four survives only with proof that it concerns something outside this repository or a contract this repository publishes. The last two need the lookups they describe:\n\n- A legal or license header.\n- Behaviour forced by an external dependency, platform, vendor, or protocol we cannot change. Behaviour a reader would not expect from the names and types in our own code does not qualify. Delete that comment and flag the symbol.\n- A doc comment that defines a public API contract.\n- An issue or RFC link that explains a constraint the code cannot express.\n- `\u002F\u002F prettier-ignore`, and a lint or type suppression whose rule is faulty, pedantic, or style-only. Look up the rule for every `eslint-disable`, `@ts-ignore`, `@ts-expect-error`, and similar suppression in scope, including the ones you did not write. If the rule catches real bugs or protects correctness or safety and the next entry does not keep the suppression, delete it and flag the symbol.\n- A suppression that the repository's agent rule table, in `AGENTS.md` or else `CLAUDE.md`, records as an approved exception for that file and rule, with an approver and an expiry date that has not passed.\n\nWhen unsure whether a keep-list entry applies, delete the comment.\n\n## Delete these\n\nDelete the whole comment rather than shortening it.\n\n- Narration, banners, commented-out code, and workaround justifications. In a test or verify script the assertion message documents the step.\n- A claim comment, such as `IMPORTANT`, `too risky`, or `fine for now`, and any long justification. A claim is not proof. Read the nearby code, run `git log -L \u003Cstart>,\u003Cend>:\u003Cfile>` on the lines, and read the PR that introduced the comment. The history decides whether the claim is still true on a live path. A claim that is still true and matches a keep-list entry stays. Anything else goes.\n- A constraint comment, such as `do not remove`, `do not change wording`, or `talk to X before changing`. First apply the keep-list test above. When the constraint concerns something we can change, offer the cheapest in-scope type, runtime check, test, or lint, local or CI, that encodes it, and wait for the user's approval. Unattended, treat it as not approved. If approved, encode the constraint, then delete the comment. Otherwise delete the comment, report the constraint open, and sketch the encoding.\n\n## Fix what the flags name\n\nDelete the dead path, drop the unused parameter, or call the real API. When two or more flags need the same fix, sketch the new structure once, over the flagged code and its surroundings, before writing code. Make the smallest root-cause fix in scope and remove every named workaround. [`fix-root-causes.md`](..\u002Fprinciples\u002Ffix-root-causes.md) and [`redesign-from-first-principles.md`](..\u002Fprinciples\u002Fredesign-from-first-principles.md) guide the intent. Both stay inside the scope. Neither allows fixes in other files. An out-of-scope root cause gets the smallest in-scope fix and a note.\n\n## Report\n\nReport these:\n\n- the files touched\n- the number of comments deleted\n- each comment kept, with its keep-list entry\n- each flag, in one line\n- each fix made, and each flag left open with its note\n- the sketch, if there was one\n- the encodings offered and made\n- the constraints left open\n- other open work\n\nDone when every comment in scope is deleted or matched to a keep-list entry, every flag is fixed or reported open, and the report carries each item above.\n","# Delete the comments\n\nDuring other work, check only the comment text you write against the [keep list](#keep-list). Leave every existing comment the request does not name as it is, even one this skill would delete or your new comment makes redundant. Mention such a comment in your reply instead. When the user asks to remove comments, or a workflow tells you to apply this skill, run the whole procedure below.\n\nDelete every comment in scope that is not on the keep list. Flag the code that needed a comment to be understood, then fix what the flags name. A flag is one line in the report naming a symbol that needed a comment. Every flag names code inside the scope and tells the truth.\n\n## Scope\n\nUse the files or diff the caller names. With no caller scope, use the current diff against the base branch, `main` by default, including the working tree.\n\n## Keep list\n\nOnly these comments survive. Each of the first four survives only with proof that it concerns something outside this repository or a contract this repository publishes. The last two need the lookups they describe:\n\n- A legal or license header.\n- Behaviour forced by an external dependency, platform, vendor, or protocol we cannot change. Behaviour a reader would not expect from the names and types in our own code does not qualify. Delete that comment and flag the symbol.\n- A doc comment that defines a public API contract.\n- An issue or RFC link that explains a constraint the code cannot express.\n- `\u002F\u002F prettier-ignore`, and a lint or type suppression whose rule is faulty, pedantic, or style-only. Look up the rule for every `eslint-disable`, `@ts-ignore`, `@ts-expect-error`, and similar suppression in scope, including the ones you did not write. If the rule catches real bugs or protects correctness or safety and the next entry does not keep the suppression, delete it and flag the symbol.\n- A suppression that the repository's agent rule table, in `AGENTS.md` or else `CLAUDE.md`, records as an approved exception for that file and rule, with an approver and an expiry date that has not passed.\n\nWhen unsure whether a keep-list entry applies, delete the comment.\n\n## Delete these\n\nDelete the whole comment rather than shortening it.\n\n- Narration, banners, commented-out code, and workaround justifications. In a test or verify script the assertion message documents the step.\n- A claim comment, such as `IMPORTANT`, `too risky`, or `fine for now`, and any long justification. A claim is not proof. Read the nearby code, run `git log -L \u003Cstart>,\u003Cend>:\u003Cfile>` on the lines, and read the PR that introduced the comment. The history decides whether the claim is still true on a live path. A claim that is still true and matches a keep-list entry stays. Anything else goes.\n- A constraint comment, such as `do not remove`, `do not change wording`, or `talk to X before changing`. First apply the keep-list test above. When the constraint concerns something we can change, offer the cheapest in-scope type, runtime check, test, or lint, local or CI, that encodes it, and wait for the user's approval. Unattended, treat it as not approved. If approved, encode the constraint, then delete the comment. Otherwise delete the comment, report the constraint open, and sketch the encoding.\n\n## Fix what the flags name\n\nDelete the dead path, drop the unused parameter, or call the real API. When two or more flags need the same fix, sketch the new structure once, over the flagged code and its surroundings, before writing code. Make the smallest root-cause fix in scope and remove every named workaround. [`fix-root-causes.md`](..\u002Fprinciples\u002Ffix-root-causes.md) and [`redesign-from-first-principles.md`](..\u002Fprinciples\u002Fredesign-from-first-principles.md) guide the intent. Both stay inside the scope. Neither allows fixes in other files. An out-of-scope root cause gets the smallest in-scope fix and a note.\n\n## Report\n\nReport these:\n\n- the files touched\n- the number of comments deleted\n- each comment kept, with its keep-list entry\n- each flag, in one line\n- each fix made, and each flag left open with its note\n- the sketch, if there was one\n- the encodings offered and made\n- the constraints left open\n- other open work\n\nDone when every comment in scope is deleted or matched to a keep-list entry, every flag is fixed or reported open, and the report carries each item above.\n",{"name":5,"description":7},"main","ec1ea5dc71f382a2a09360a736d31b7294e5ecc2","skills\u002Fno-comments","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack","https:\u002F\u002Fgithub.com\u002Fsyanga","2026-11-14 17:01:29",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add syanga\u002Fastack --skill no-comments",{"tool":37,"command":38},"bunx","bunx skills add syanga\u002Fastack --skill no-comments",{"tool":40,"command":41},"pnpm","pnpm dlx skills add syanga\u002Fastack --skill no-comments","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fno-comments\u002FSKILL.md",true,[45],{"path":46,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":16},"LICENSE","许可证",1067,[50,57,65,73,81,89],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":20},"01M7CP39S6D7662SFCC9K286T7","replace-with-skill-name","Replace with when this skill should be reached.","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Ftemplates\u002Fskill\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":61,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":20},"01M7CP37YN62Z7VR6P2J7918ZA","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-for-agents\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":69,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":20},"01M7CP353RP2S1M1ZMHFZ0F610","worktree-cleanup","Worktree cleanup. Use for cleanup, resource audits, close this lane, or close out.","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fworktree-cleanup\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fworktree-cleanup\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":77,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":20},"01M7CP32DSVPRTBAFHF1P6NZ1X","wizard","Generate an interactive Bash wizard that walks a human through steps only they can perform. Use when provisioning, credential setup, or a one-off migration needs such steps.","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fwizard\u002FLICENSE-mattpocock","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fwizard\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":85,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":20},"01M7CP2YE3WABQE9MNY8RQD6MX","why","Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds. Returns a cited read on decisions and tradeoffs.","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fwhy\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fwhy\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":20},"01M7CP2VP8JA1HYDE8TJX2Y494","wayfinder","Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fwayfinder\u002FLICENSE-mattpocock","https:\u002F\u002Fgithub.com\u002Fsyanga\u002Fastack\u002Fblob\u002Fmain\u002Fskills\u002Fwayfinder\u002FSKILL.md",[],[]]