[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ABQJGH6HAWFMKWB927GFZX":3,"skill-same:01M7ABQJGH6HAWFMKWB927GFZX":48},{"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":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7ABQJGH6HAWFMKWB927GFZX","commenting-standards",null,"Comment writing, formatting, and wrapping rules for all TypeScript code in agenteq.","sunchayn\u002Fagenteq","sunchayn","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F14861869?v=4","01M7ABQ196WGTZ00ZD0A3GMK7D","Mazen Touati","01M7ABQ19XRTXXN62T4K41RTY1",7,"MIT","https:\u002F\u002Fgithub.com\u002Fsunchayn\u002Fagenteq\u002Fblob\u002Fbase\u002F.ai\u002Fskills\u002Fcommenting-standards\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: commenting-standards\ndescription: Comment writing, formatting, and wrapping rules for all TypeScript code in agenteq.\n---\n\n# Commenting Standards\n\nApplies to every comment in this codebase.\n\n## 1. Core principle\n\nComment why, not what. Skip a comment that only restates the next line.\n\n- Do comment: non-obvious decisions, workarounds, reasoning behind choosing one approach over another.\n- Do not comment: obvious code, step-by-step narration.\n- Do not reference a ticket, issue, or user request. A comment must stand alone for a reader with no such context.\n- Do not reference a previous version of the code or how this version differs. Tells: \"instead\", \"now\", \"no longer\", \"used to\", \"previously\", or a clause defending an absence (\"with no X of its own\"). After a refactor, check each touched comment makes sense to someone who never saw the old file. If it only parses as a contrast with removed code, cut that clause or the comment, and keep only the plain remaining fact. Contrast belongs in a commit message or PR description.\n\n## 2. Language\n\n- No metaphors, idioms, or narrative framing. Plain language tied to concrete technical facts.\n- Name variables and data structures directly.\n- No colon or semicolon joining two independent clauses. Use two sentences.\n- Wrap only at a period or comma, never mid-sentence.\n- Use the existing technical term, not a paraphrase. Write \"what tag HEAD is pointing at\", not \"the tag the branch is sitting on\".\n\n## 3. Doc blocks and inline comments\n\n- Class or function doc block: always expanded multi-line `\u002F** ... *\u002F`, never single-line, even when short.\n- Doc block stays conceptual: what the function achieves, its contract. No variable names, no internal control flow steps. Those go in an inline comment at the line they explain.\n- Doc block prose: max 4 lines. Shorten or use a list.\n- Inline `\u002F\u002F` comment: max 3 lines. Shorten, or move the explanation to the doc block.\n- Last line of a multi-line comment, block or inline: at least 4 words. Rebalance wrapping instead of leaving a short trailing fragment.\n\n## 4. Current gap\n\nMany files lack inline why-comments on non-obvious branches and decisions (why this order, early return, fallback). That is not the target state. Backfill why-comments in any file you touch. Do not copy the sparse state.\n\n## 5. Related Skills\n\n- General TypeScript conventions: [write-typescript-code](..\u002Fwrite-typescript-code\u002FSKILL.md)\n","# Commenting Standards\n\nApplies to every comment in this codebase.\n\n## 1. Core principle\n\nComment why, not what. Skip a comment that only restates the next line.\n\n- Do comment: non-obvious decisions, workarounds, reasoning behind choosing one approach over another.\n- Do not comment: obvious code, step-by-step narration.\n- Do not reference a ticket, issue, or user request. A comment must stand alone for a reader with no such context.\n- Do not reference a previous version of the code or how this version differs. Tells: \"instead\", \"now\", \"no longer\", \"used to\", \"previously\", or a clause defending an absence (\"with no X of its own\"). After a refactor, check each touched comment makes sense to someone who never saw the old file. If it only parses as a contrast with removed code, cut that clause or the comment, and keep only the plain remaining fact. Contrast belongs in a commit message or PR description.\n\n## 2. Language\n\n- No metaphors, idioms, or narrative framing. Plain language tied to concrete technical facts.\n- Name variables and data structures directly.\n- No colon or semicolon joining two independent clauses. Use two sentences.\n- Wrap only at a period or comma, never mid-sentence.\n- Use the existing technical term, not a paraphrase. Write \"what tag HEAD is pointing at\", not \"the tag the branch is sitting on\".\n\n## 3. Doc blocks and inline comments\n\n- Class or function doc block: always expanded multi-line `\u002F** ... *\u002F`, never single-line, even when short.\n- Doc block stays conceptual: what the function achieves, its contract. No variable names, no internal control flow steps. Those go in an inline comment at the line they explain.\n- Doc block prose: max 4 lines. Shorten or use a list.\n- Inline `\u002F\u002F` comment: max 3 lines. Shorten, or move the explanation to the doc block.\n- Last line of a multi-line comment, block or inline: at least 4 words. Rebalance wrapping instead of leaving a short trailing fragment.\n\n## 4. Current gap\n\nMany files lack inline why-comments on non-obvious branches and decisions (why this order, early return, fallback). That is not the target state. Backfill why-comments in any file you touch. Do not copy the sparse state.\n\n## 5. Related Skills\n\n- General TypeScript conventions: [write-typescript-code](..\u002Fwrite-typescript-code\u002FSKILL.md)\n",{"name":5,"description":7},"base","b99f2a00504bfd13da8cedf096c6f121ca2aeb8f",".ai\u002Fskills\u002Fcommenting-standards",0,"https:\u002F\u002Fgithub.com\u002Fsunchayn\u002Fagenteq","https:\u002F\u002Fsunchayn.dev\u002Fblog\u002Fyou-only-need-one-source-of-truth-for-all-your-ai-coding-agents","https:\u002F\u002Fgithub.com\u002Fsunchayn","https:\u002F\u002Fsunchayn.dev\u002F","Ordering a pizzacode 🍕","2026-10-29 22:00:19",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add sunchayn\u002Fagenteq --skill commenting-standards",{"tool":40,"command":41},"bunx","bunx skills add sunchayn\u002Fagenteq --skill commenting-standards",{"tool":43,"command":44},"pnpm","pnpm dlx skills add sunchayn\u002Fagenteq --skill commenting-standards","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsunchayn\u002Fagenteq\u002Fblob\u002Fbase\u002F.ai\u002Fskills\u002Fcommenting-standards\u002FSKILL.md",true,[],[49,56,63,68,75,80],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7ABS3P7DDXGQ8B85WEX4JA0","writing-commit-messages","Conventions for writing commit messages in this repo.","https:\u002F\u002Fgithub.com\u002Fsunchayn\u002Fagenteq\u002Fblob\u002Fbase\u002Fexamples\u002Frefactor-demo\u002F.cursor\u002Fskills\u002Fwriting-commit-messages\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7ABS1BQG4B0JAPNMMP5XC4R","review-checklist","Checklist to run through before approving a pull request.","https:\u002F\u002Fgithub.com\u002Fsunchayn\u002Fagenteq\u002Fblob\u002Fbase\u002Fexamples\u002Frefactor-demo\u002F.cursor\u002Fskills\u002Freview-checklist\u002FSKILL.md",[],[],{"skillNo":64,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7ABRYG5V8NDB6R2X5ZRTX7Q","https:\u002F\u002Fgithub.com\u002Fsunchayn\u002Fagenteq\u002Fblob\u002Fbase\u002Fexamples\u002Frefactor-demo\u002F.claude\u002Fskills\u002Fwriting-commit-messages\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7ABRW3B3CBEYTH4H82FF6Z2","laravel-pint","Formats PHP code with Laravel Pint before a commit.","https:\u002F\u002Fgithub.com\u002Fsunchayn\u002Fagenteq\u002Fblob\u002Fbase\u002Fexamples\u002Flaravel-boost\u002F.cursor\u002Fskills\u002Flaravel-pint\u002FSKILL.md",[],[],{"skillNo":76,"name":70,"nameZh":6,"description":71,"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},"01M7ABRSA7C1XCTWZHQFE1B8DS","https:\u002F\u002Fgithub.com\u002Fsunchayn\u002Fagenteq\u002Fblob\u002Fbase\u002Fexamples\u002Flaravel-boost\u002F.claude\u002Fskills\u002Flaravel-pint\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7ABRQ17XESZVBGHT1NYK4NF","example-skill","Example skill synced by agenteq","https:\u002F\u002Fgithub.com\u002Fsunchayn\u002Fagenteq\u002Fblob\u002Fbase\u002Fexamples\u002Fbasic\u002F.ai\u002Fskills\u002Fexample-skill\u002FSKILL.md",[],[]]