[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6EGG4H27YPE4X35EG0QWDYR":3,"skill-same:01M6EGG4H27YPE4X35EG0QWDYR":78},{"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":23,"publishedAt":39,"linkOnly":40,"markdownContent":41,"markdownBody":42,"frontMatter":43,"refName":45,"commitSha":46,"skillDirectory":47,"forksCount":48,"repositoryHtmlUrl":49,"repositoryHomepageUrl":6,"ownerHtmlUrl":50,"ownerBlogUrl":51,"ownerDescription":52,"updatedAt":53,"install":54,"resources":67},"01M6EGG4H27YPE4X35EG0QWDYR","ln-613-code-comments-auditor",null,"Checks WHY-not-WHAT, density (15-20%), forbidden content, docstrings quality, actuality, legacy cleanup. Returns findings with severity, location, and recommendations.","levalencia\u002Fagent-god-mode","levalencia","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6962857?v=4","01M6EB0FZZ4BPQPC4HET4QY6NM","Luis Valencia ","01M6EB0G4HWHPWW0H9X7QKSAHP",3,"MIT","https:\u002F\u002Fgithub.com\u002Flevalencia\u002Fagent-god-mode\u002Fblob\u002Fmain\u002Forganized-skills\u002Fln-613-code-comments-auditor\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38],"code","code comments","ln 613 code comments auditor","cleanup","content","severity","why","Bash","quality","returns","grep","read","Legacy","location","recommendations","2026-11-10 10:12:30",false,"---\nname: ln-613-code-comments-auditor\ndescription: Checks WHY-not-WHAT, density (15-20%), forbidden content, docstrings quality, actuality, legacy cleanup. Returns findings with severity, location, and recommendations.\nallowed-tools: Read, Grep, Glob, Bash\nlicense: MIT\n---\n\n> **Paths:** File paths (`shared\u002F`, `references\u002F`, `..\u002Fln-*`) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root.\n\n# Code Comments Auditor (L3 Worker)\n\nSpecialized worker auditing code comments and docstrings quality.\n\n## Purpose & Scope\n\n- **Worker in ln-610 coordinator pipeline** - invoked by ln-610-docs-auditor\n- Audit code comments for **quality and compliance** across 6 categories\n- Universal for any tech stack (auto-detect comment syntax)\n- Return structured findings to coordinator with severity, location, recommendations\n- Calculate compliance score (X\u002F10) for Code Comments category\n\n## Inputs (from Coordinator)\n\n**MANDATORY READ:** Load `shared\u002Freferences\u002Faudit_worker_core_contract.md`.\n\nReceives `contextStore` with: `tech_stack`, `project_root`, `output_dir`.\n\n## Workflow\n\n1) **Parse Context:** Extract tech stack, project root, output_dir from contextStore\n2) **Scan:** Find all source files (use `tech_stack` for detection)\n3) **Extract:** Parse inline comments + docstrings\u002FJSDoc\n4) **Audit:** Run 6 category checks (see Audit Categories below)\n5) **Collect Findings:** Record each violation with severity, location (file:line), effort estimate (S\u002FM\u002FL), recommendation\n6) **Calculate Score:** Count violations by severity, calculate compliance score (X\u002F10)\n7) **Write Report:** Build full markdown report per `shared\u002Ftemplates\u002Faudit_worker_report_template.md`, write to `{output_dir}\u002F613-code-comments.md` in single Write call\n8) **Return Summary:** Return minimal summary to coordinator (see Output Format)\n\n## Audit Categories\n\n| # | Category | What to Check |\n|---|----------|---------------|\n| 1 | **WHY not WHAT** | Comments explain rationale, not obvious code behavior; no restating code |\n| 2 | **Density (15-20%)** | Comment-to-code ratio within range; not over\u002Funder-commented |\n| 3 | **No Forbidden Content** | No dates\u002Fauthors; no historical notes; no code examples in comments |\n| 4 | **Docstrings Quality** | Match function signatures; parameters documented; return types accurate |\n| 5 | **Actuality** | Comments match code behavior; no stale references; examples runnable |\n| 6 | **Legacy Cleanup** | No TODO without context; no commented-out code; no deprecated notes |\n\n## Scoring Algorithm\n\n**MANDATORY READ:** Load `shared\u002Freferences\u002Faudit_worker_core_contract.md` and `shared\u002Freferences\u002Faudit_scoring.md`.\n\n## Output Format\n\n**MANDATORY READ:** Load `shared\u002Freferences\u002Faudit_worker_core_contract.md` and `shared\u002Ftemplates\u002Faudit_worker_report_template.md`.\n\nWrite report to `{output_dir}\u002F613-code-comments.md` with `category: \"Code Comments\"` and checks: why_not_what, density, forbidden_content, docstrings_quality, actuality, legacy_cleanup.\n\nReturn summary to coordinator:\n```\nReport written: docs\u002Fproject\u002F.audit\u002Fln-610\u002F{YYYY-MM-DD}\u002F613-code-comments.md\nScore: X.X\u002F10 | Issues: N (C:N H:N M:N L:N)\n```\n\n**Severity mapping:**\n\n| Issue Type | Severity |\n|------------|----------|\n| Author names, dates in comments | CRITICAL |\n| Commented-out code blocks | HIGH |\n| Stale\u002Foutdated comments | HIGH |\n| Obvious WHAT comments | MEDIUM |\n| Density deviation >5% | MEDIUM |\n| Minor density deviation | LOW |\n\n## Critical Rules\n\n**MANDATORY READ:** Load `shared\u002Freferences\u002Faudit_worker_core_contract.md`.\n\n- **Do not auto-fix:** Report violations only; coordinator aggregates for user\n- **Fix code, not rules:** NEVER modify rules files (*_rules.md, *_standards.md) to make violations pass\n- **Code is truth:** When comment contradicts code, flag comment for update\n- **WHY > WHAT:** Comments explaining obvious behavior should be removed\n- **Universal:** Works with any language; detect comment syntax automatically\n- **Location precision:** Always include `file:line` for programmatic navigation\n\n## Definition of Done\n\n**MANDATORY READ:** Load `shared\u002Freferences\u002Faudit_worker_core_contract.md`.\n\n- contextStore parsed successfully (including output_dir)\n- All source files scanned (tech stack from contextStore)\n- All 6 categories audited\n- Findings collected with severity, location, effort, recommendation\n- Score calculated using penalty algorithm\n- Report written to `{output_dir}\u002F613-code-comments.md` (atomic single Write call)\n- Summary returned to coordinator\n\n## Reference Files\n\n- Comment rules and patterns: [references\u002Fcomments_rules.md](references\u002Fcomments_rules.md)\n\n---\n**Version:** 4.0.0\n**Last Updated:** 2026-03-01\n","> **Paths:** File paths (`shared\u002F`, `references\u002F`, `..\u002Fln-*`) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root.\n\n# Code Comments Auditor (L3 Worker)\n\nSpecialized worker auditing code comments and docstrings quality.\n\n## Purpose & Scope\n\n- **Worker in ln-610 coordinator pipeline** - invoked by ln-610-docs-auditor\n- Audit code comments for **quality and compliance** across 6 categories\n- Universal for any tech stack (auto-detect comment syntax)\n- Return structured findings to coordinator with severity, location, recommendations\n- Calculate compliance score (X\u002F10) for Code Comments category\n\n## Inputs (from Coordinator)\n\n**MANDATORY READ:** Load `shared\u002Freferences\u002Faudit_worker_core_contract.md`.\n\nReceives `contextStore` with: `tech_stack`, `project_root`, `output_dir`.\n\n## Workflow\n\n1) **Parse Context:** Extract tech stack, project root, output_dir from contextStore\n2) **Scan:** Find all source files (use `tech_stack` for detection)\n3) **Extract:** Parse inline comments + docstrings\u002FJSDoc\n4) **Audit:** Run 6 category checks (see Audit Categories below)\n5) **Collect Findings:** Record each violation with severity, location (file:line), effort estimate (S\u002FM\u002FL), recommendation\n6) **Calculate Score:** Count violations by severity, calculate compliance score (X\u002F10)\n7) **Write Report:** Build full markdown report per `shared\u002Ftemplates\u002Faudit_worker_report_template.md`, write to `{output_dir}\u002F613-code-comments.md` in single Write call\n8) **Return Summary:** Return minimal summary to coordinator (see Output Format)\n\n## Audit Categories\n\n| # | Category | What to Check |\n|---|----------|---------------|\n| 1 | **WHY not WHAT** | Comments explain rationale, not obvious code behavior; no restating code |\n| 2 | **Density (15-20%)** | Comment-to-code ratio within range; not over\u002Funder-commented |\n| 3 | **No Forbidden Content** | No dates\u002Fauthors; no historical notes; no code examples in comments |\n| 4 | **Docstrings Quality** | Match function signatures; parameters documented; return types accurate |\n| 5 | **Actuality** | Comments match code behavior; no stale references; examples runnable |\n| 6 | **Legacy Cleanup** | No TODO without context; no commented-out code; no deprecated notes |\n\n## Scoring Algorithm\n\n**MANDATORY READ:** Load `shared\u002Freferences\u002Faudit_worker_core_contract.md` and `shared\u002Freferences\u002Faudit_scoring.md`.\n\n## Output Format\n\n**MANDATORY READ:** Load `shared\u002Freferences\u002Faudit_worker_core_contract.md` and `shared\u002Ftemplates\u002Faudit_worker_report_template.md`.\n\nWrite report to `{output_dir}\u002F613-code-comments.md` with `category: \"Code Comments\"` and checks: why_not_what, density, forbidden_content, docstrings_quality, actuality, legacy_cleanup.\n\nReturn summary to coordinator:\n```\nReport written: docs\u002Fproject\u002F.audit\u002Fln-610\u002F{YYYY-MM-DD}\u002F613-code-comments.md\nScore: X.X\u002F10 | Issues: N (C:N H:N M:N L:N)\n```\n\n**Severity mapping:**\n\n| Issue Type | Severity |\n|------------|----------|\n| Author names, dates in comments | CRITICAL |\n| Commented-out code blocks | HIGH |\n| Stale\u002Foutdated comments | HIGH |\n| Obvious WHAT comments | MEDIUM |\n| Density deviation >5% | MEDIUM |\n| Minor density deviation | LOW |\n\n## Critical Rules\n\n**MANDATORY READ:** Load `shared\u002Freferences\u002Faudit_worker_core_contract.md`.\n\n- **Do not auto-fix:** Report violations only; coordinator aggregates for user\n- **Fix code, not rules:** NEVER modify rules files (*_rules.md, *_standards.md) to make violations pass\n- **Code is truth:** When comment contradicts code, flag comment for update\n- **WHY > WHAT:** Comments explaining obvious behavior should be removed\n- **Universal:** Works with any language; detect comment syntax automatically\n- **Location precision:** Always include `file:line` for programmatic navigation\n\n## Definition of Done\n\n**MANDATORY READ:** Load `shared\u002Freferences\u002Faudit_worker_core_contract.md`.\n\n- contextStore parsed successfully (including output_dir)\n- All source files scanned (tech stack from contextStore)\n- All 6 categories audited\n- Findings collected with severity, location, effort, recommendation\n- Score calculated using penalty algorithm\n- Report written to `{output_dir}\u002F613-code-comments.md` (atomic single Write call)\n- Summary returned to coordinator\n\n## Reference Files\n\n- Comment rules and patterns: [references\u002Fcomments_rules.md](references\u002Fcomments_rules.md)\n\n---\n**Version:** 4.0.0\n**Last Updated:** 2026-03-01\n",{"name":5,"license":15,"description":7,"allowed-tools":44},"Read, Grep, Glob, Bash","main","fa638b97a18ff6d9f26cf0eaf3dfa123531bcc87","organized-skills\u002Fln-613-code-comments-auditor",1,"https:\u002F\u002Fgithub.com\u002Flevalencia\u002Fagent-god-mode","https:\u002F\u002Fgithub.com\u002Flevalencia","https:\u002F\u002Fmedium.com\u002F@luisevalencia","Microsoft MVP - Artificial Intelligence\r\nMachine Learning Enthusiast\r\n","2026-05-02 06:55:36",{"source":8,"skillName":5,"commands":55,"prompt":65,"zipAvailable":66},[56,59,62],{"tool":57,"command":58},"npx","npx skills add levalencia\u002Fagent-god-mode --skill ln-613-code-comments-auditor",{"tool":60,"command":61},"bunx","bunx skills add levalencia\u002Fagent-god-mode --skill ln-613-code-comments-auditor",{"tool":63,"command":64},"pnpm","pnpm dlx skills add levalencia\u002Fagent-god-mode --skill ln-613-code-comments-auditor","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flevalencia\u002Fagent-god-mode\u002Fblob\u002Fmain\u002Forganized-skills\u002Fln-613-code-comments-auditor\u002FSKILL.md",true,[68,74],{"path":69,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":72,"sourceHtmlUrl":73},"DESIGN.md","REFERENCE","参考文档",1534,"https:\u002F\u002Fgithub.com\u002FTorchiaHub\u002FSkills\u002Fblob\u002Fmaster\u002F01-Inbox\u002Fdownloads\u002Fbergside-design-skills\u002F20260516T145411Z\u002Fsource\u002Fskills\u002Felegant\u002FDESIGN.md",{"path":75,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":76,"sourceHtmlUrl":77},"references\u002Fcomments_rules.md",6123,"https:\u002F\u002Fgithub.com\u002Flevalencia\u002Fagent-god-mode\u002Fblob\u002Fmain\u002Forganized-skills\u002Fln-613-code-comments-auditor\u002Freferences\u002Fcomments_rules.md",[79,101,135,162,188,215],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":39},"01M6EM8ES5M9J4S8N78NJST0YC","zarr-python","Chunked N-D arrays for cloud storage. Compressed arrays, parallel I\u002FO, S3\u002FGCS integration, NumPy\u002FDask\u002FXarray compatible, for large-scale scientific computing pipelines.","https:\u002F\u002Fgithub.com\u002Flevalencia\u002Fagent-god-mode\u002Fblob\u002Fmain\u002Forganized-skills\u002Fzarr-python\u002FSKILL.md",[],[86,87,88,89,90,91,92,93,94,95,96,97,98,99,100],"python","zarr python","storage","integration","s3","gcs","cloud","dask","parallel","pipelines","arrays","numpy","scientific computing","scale","scientific",{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":116,"publishedAt":39},"01M6EM8AR6ZFKZ9YVW8TTG850Z","zabbix","Zabbix monitoring system automation via API and Python. Use when: (1) Managing hosts, templates, items, triggers, or host groups, (2) Automating monitoring configuration, (3) Sending data via Zabbix trapper\u002Fsender, (4) Querying historical data or events, (5) Bulk operations on Zabbix objects, (6) Maintenance window management, (7) User\u002Fpermission management","https:\u002F\u002Fgithub.com\u002Flevalencia\u002Fagent-god-mode\u002Fblob\u002Fmain\u002Forganized-skills\u002Fzabbix-api-skill\u002FSKILL.md",[107,112,115],{"categoryNo":108,"categoryName":109,"taxonomyType":110,"taxonomyTypeDesc":111},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":113,"categoryName":114,"taxonomyType":110,"taxonomyTypeDesc":111},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[103,86,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134],"automation","window management","monitoring","data","templates","api","system","operations","use","maintenance","objects","permission","bulk operations","triggers","host","events","via","bulk",{"skillNo":136,"name":137,"nameZh":6,"description":138,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":139,"categories":140,"keywords":141,"publishedAt":39},"01M6EM6Q9JG846ECQY9A210A26","x-twitter-growth","X\u002FTwitter growth engine for building audience, crafting viral content, and analyzing engagement. Use when the user wants to grow on X\u002FTwitter, write tweets or threads, analyze their X profile, research competitors on X, plan a posting strategy, or optimize engagement. Complements social-content (generic multi-platform) with X-specific depth: algorithm mechanics, thread engineering, reply strategy, profile optimization, and competitive intelligence via web search.","https:\u002F\u002Fgithub.com\u002Flevalencia\u002Fagent-god-mode\u002Fblob\u002Fmain\u002Forganized-skills\u002Fx-twitter-growth\u002FSKILL.md",[],[142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161],"twitter","x twitter growth","growth","competitive intelligence","search","analyzing","plan","marketing","web search","competitors","analyze","write","optimize","social","intelligence","viral","growth engine","mechanics","grow","competitive",{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":166,"categories":167,"keywords":168,"publishedAt":39},"01M6EM3FQNPYNKPC4CV9TCVNGD","what-if-oracle","Run structured What-If scenario analysis with multi-branch possibility exploration. Use this skill when the user asks speculative questions like \"what if...\", \"what would happen if...\", \"what are the possibilities\", \"explore scenarios\", \"scenario analysis\", \"possibility space\", \"what could go wrong\", \"best case \u002F worst case\", \"risk analysis\", \"contingency planning\", \"strategic options\", or any question about uncertain futures. Also trigger when the user faces a fork-in-the-road decision, wants to stress-test an idea, or needs to think through consequences before committing.","https:\u002F\u002Fgithub.com\u002Flevalencia\u002Fagent-god-mode\u002Fblob\u002Fmain\u002Forganized-skills\u002Fwhat-if-oracle\u002FSKILL.md",[],[169,170,171,172,173,174,175,176,177,178,179,180,125,181,182,183,184,185,186,187],"oracle","what if oracle","test","planning","ux","futures","risk","analysis","explore","decision","branch","question","exploration","options","stress-test","strategies","trigger","case","multi",{"skillNo":189,"name":190,"nameZh":6,"description":191,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":192,"categories":193,"keywords":197,"publishedAt":39},"01M6EM08C06RGDYCJ86HAPK0FF","vercel-react-best-practices","React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React\u002FNext.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.","https:\u002F\u002Fgithub.com\u002Flevalencia\u002Fagent-god-mode\u002Fblob\u002Fmain\u002Forganized-skills\u002Fvercel-react-best-practices\u002FSKILL.md",[194],{"categoryNo":195,"categoryName":196,"taxonomyType":110,"taxonomyTypeDesc":111},"01JBSEEDCAT000000000000009","前端开发",[198,199,200,201,202,203,204,205,206,207,208,24,209,120,210,211,212,213,214,130],"react","vercel react best practices","best practices","react best practices","vercel","writing","performance","components","react components","guidelines","tasks","Optimization","Next.js","refactoring","performance optimization","next","pages",{"skillNo":216,"name":217,"nameZh":6,"description":218,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":219,"categories":220,"keywords":231,"publishedAt":39},"01M6EM00S13326QM08DTM94J6Z","venue-templates","Access comprehensive LaTeX templates, formatting requirements, and submission guidelines for major scientific publication venues (Nature, Science, PLOS, IEEE, ACM), academic conferences (NeurIPS, ICML, CVPR, CHI), research posters, and grant proposals (NSF, NIH, DOE, DARPA). This skill should be used when preparing manuscripts for journal submission, conference papers, research posters, or grant proposals and need venue-specific formatting requirements and templates.","https:\u002F\u002Fgithub.com\u002Flevalencia\u002Fagent-god-mode\u002Fblob\u002Fmain\u002Forganized-skills\u002Fvenue-templates\u002FSKILL.md",[221,224,227,228],{"categoryNo":222,"categoryName":223,"taxonomyType":110,"taxonomyTypeDesc":111},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":225,"categoryName":226,"taxonomyType":110,"taxonomyTypeDesc":111},"01JBSEEDCAT000000000000021","资料检索与研究",{"categoryNo":113,"categoryName":114,"taxonomyType":110,"taxonomyTypeDesc":111},{"categoryNo":229,"categoryName":230,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000036","内容创作者",[121,232,233,207,234,235,236,237,31,238,35,153,239,240,241,242,243,244,100,245],"venue templates","research","NeurIPS","ICML","LaTeX","science","access","edit","proposals","Academic","requirements","formatting","journal","chi"]