[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79M9XTJN2WD6PMDTYX9836X":3,"skill-same:01M79M9XTJN2WD6PMDTYX9836X":51},{"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":5,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M79M9XTJN2WD6PMDTYX9836X","makefile-help",null,"Annotate a Makefile with self-documenting help targets. Adds a `help` target as the default and appends inline descriptions to every user-facing target.","managedkaos\u002Fskills","managedkaos","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F4703156?v=4","01M79M9THF29Z6N30G65A9CPB6","Michael","01M79M9TJKVFPZ59TY2WEBA82E",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmanagedkaos\u002Fskills\u002Fblob\u002Fmain\u002Fmakefile-help\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: makefile-help\ndescription: >-\n  Annotate a Makefile with self-documenting help targets. Adds a `help` target\n  as the default and appends inline descriptions to every user-facing target.\nwhen_to_use: >-\n  annotate makefile, makefile help, document makefile, add makefile comments,\n  self-documenting make targets, onboard makefile\n---\n\n# Annotate Makefile with Self-Documenting Help\n\n## Task\n\nRead the Makefile at `$filepath` (if no path given, look for `Makefile` or `GNUmakefile` in the working directory). Add self-documenting help annotations to all user-facing targets.\n\n## The Pattern\n\nEvery user-facing target gets a `## Description` annotation inline on the `:` line:\n\n```makefile\ntarget-name: dependencies ## Short description of what this target does\n\trecipe commands\n```\n\nThe `help` target must be the **first target** in the file (making it the default). It uses this exact recipe:\n\n```makefile\nhelp: ## Display available targets\n\t@awk 'BEGIN {FS = \":.*## \"}; \u002F^[a-zA-Z0-9_-]+:.*## \u002F {printf \"\\033[36m%-28s\\033[0m %s\\n\", $$1, $$2}' $(MAKEFILE_LIST)\n```\n\n## Rules\n\n1. `help` must be the first target so `make` with no arguments shows help.\n2. Annotate every target that a user would invoke directly.\n3. Do NOT annotate internal\u002Fhelper targets prefixed with `_` or `.`.\n4. Descriptions must be:\n   - A single line, no period at the end\n   - Imperative mood (\"Build the binary\" not \"Builds the binary\")\n   - Under 60 characters\n   - Specific enough to distinguish from other targets\n5. Preserve existing behavior — only add\u002Fmodify the `## comment` portion. Never change target names, dependencies, or recipes.\n6. If `help` already exists, verify it uses the correct awk pattern and update if needed.\n7. Keep related targets adjacent. Do not reorder unrelated targets.\n8. If a `.PHONY` declaration exists, add `help` to it.\n9. If an explicit `.DEFAULT_GOAL` is set, do not change it. The `help` target will still be the first target in the file, but the default goal will remain as specified.\n\n## Procedure\n\n1. Read the entire Makefile.\n2. If no `help` target exists, insert it as the first target (after variable declarations, `.PHONY`, or includes at the top).\n3. For each user-facing target, determine its purpose from the recipe and add `## Description` inline.\n4. Write back the updated Makefile using Edit.\n\n## Example\n\nBefore:\n```makefile\nbuild:\n\tgo build -o bin\u002Fapp .\u002Fcmd\u002Fapp\n\ntest:\n\tgo test .\u002F...\n\nlint:\n\tgolangci-lint run\n```\n\nAfter:\n```makefile\nhelp: ## Display available targets\n\t@awk 'BEGIN {FS = \":.*## \"}; \u002F^[a-zA-Z0-9_-]+:.*## \u002F {printf \"\\033[36m%-28s\\033[0m %s\\n\", $$1, $$2}' $(MAKEFILE_LIST)\n\nbuild: ## Build the application binary\n\tgo build -o bin\u002Fapp .\u002Fcmd\u002Fapp\n\ntest: ## Run the test suite\n\tgo test .\u002F...\n\nlint: ## Run the linter\n\tgolangci-lint run\n```\n\n## Validation\n\nAfter updating, confirm:\n- `make` (no args) would print the help table\n- Every public target has a `## Description`\n- No internal targets leak into help output\n- The awk field separator `:.*## ` matches all annotated lines\n","# Annotate Makefile with Self-Documenting Help\n\n## Task\n\nRead the Makefile at `$filepath` (if no path given, look for `Makefile` or `GNUmakefile` in the working directory). Add self-documenting help annotations to all user-facing targets.\n\n## The Pattern\n\nEvery user-facing target gets a `## Description` annotation inline on the `:` line:\n\n```makefile\ntarget-name: dependencies ## Short description of what this target does\n\trecipe commands\n```\n\nThe `help` target must be the **first target** in the file (making it the default). It uses this exact recipe:\n\n```makefile\nhelp: ## Display available targets\n\t@awk 'BEGIN {FS = \":.*## \"}; \u002F^[a-zA-Z0-9_-]+:.*## \u002F {printf \"\\033[36m%-28s\\033[0m %s\\n\", $$1, $$2}' $(MAKEFILE_LIST)\n```\n\n## Rules\n\n1. `help` must be the first target so `make` with no arguments shows help.\n2. Annotate every target that a user would invoke directly.\n3. Do NOT annotate internal\u002Fhelper targets prefixed with `_` or `.`.\n4. Descriptions must be:\n   - A single line, no period at the end\n   - Imperative mood (\"Build the binary\" not \"Builds the binary\")\n   - Under 60 characters\n   - Specific enough to distinguish from other targets\n5. Preserve existing behavior — only add\u002Fmodify the `## comment` portion. Never change target names, dependencies, or recipes.\n6. If `help` already exists, verify it uses the correct awk pattern and update if needed.\n7. Keep related targets adjacent. Do not reorder unrelated targets.\n8. If a `.PHONY` declaration exists, add `help` to it.\n9. If an explicit `.DEFAULT_GOAL` is set, do not change it. The `help` target will still be the first target in the file, but the default goal will remain as specified.\n\n## Procedure\n\n1. Read the entire Makefile.\n2. If no `help` target exists, insert it as the first target (after variable declarations, `.PHONY`, or includes at the top).\n3. For each user-facing target, determine its purpose from the recipe and add `## Description` inline.\n4. Write back the updated Makefile using Edit.\n\n## Example\n\nBefore:\n```makefile\nbuild:\n\tgo build -o bin\u002Fapp .\u002Fcmd\u002Fapp\n\ntest:\n\tgo test .\u002F...\n\nlint:\n\tgolangci-lint run\n```\n\nAfter:\n```makefile\nhelp: ## Display available targets\n\t@awk 'BEGIN {FS = \":.*## \"}; \u002F^[a-zA-Z0-9_-]+:.*## \u002F {printf \"\\033[36m%-28s\\033[0m %s\\n\", $$1, $$2}' $(MAKEFILE_LIST)\n\nbuild: ## Build the application binary\n\tgo build -o bin\u002Fapp .\u002Fcmd\u002Fapp\n\ntest: ## Run the test suite\n\tgo test .\u002F...\n\nlint: ## Run the linter\n\tgolangci-lint run\n```\n\n## Validation\n\nAfter updating, confirm:\n- `make` (no args) would print the help table\n- Every public target has a `## Description`\n- No internal targets leak into help output\n- The awk field separator `:.*## ` matches all annotated lines\n",{"name":5,"description":7,"when_to_use":24},"annotate makefile, makefile help, document makefile, add makefile comments, self-documenting make targets, onboard makefile","main","9321798b2d6763d9ca0312d996d3e7fef31401f9","https:\u002F\u002Fgithub.com\u002Fmanagedkaos\u002Fskills","https:\u002F\u002Fgithub.com\u002Fmanagedkaos","http:\u002F\u002Fmanagedkaos.com\u002F","2026-09-17 06:11:14",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add managedkaos\u002Fskills --skill makefile-help",{"tool":37,"command":38},"bunx","bunx skills add managedkaos\u002Fskills --skill makefile-help",{"tool":40,"command":41},"pnpm","pnpm dlx skills add managedkaos\u002Fskills --skill makefile-help","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmanagedkaos\u002Fskills\u002Fblob\u002Fmain\u002Fmakefile-help\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"README.md","REFERENCE","参考文档",3443,"https:\u002F\u002Fgithub.com\u002Fmanagedkaos\u002Fskills\u002Fblob\u002Fmain\u002Fmakefile-help\u002FREADME.md",[52],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M79M9W7ASBVCYBWK464Y4XH4","hello-skill","A minimal example skill that responds with a greeting.","https:\u002F\u002Fgithub.com\u002Fmanagedkaos\u002Fskills\u002Fblob\u002Fmain\u002Fhello-skill\u002FSKILL.md",[],[]]