heimdall-agent 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (250) hide show
  1. package/README.md +57 -26
  2. package/README.pt-BR.md +443 -0
  3. package/agents/cloud-engineer.md +77 -0
  4. package/agents/code-sentinel.md +71 -34
  5. package/agents/database-architect.md +31 -25
  6. package/agents/frontend-designer.md +30 -28
  7. package/agents/mobile-designer.md +25 -24
  8. package/agents/modernizer.md +68 -0
  9. package/agents/orchestrator.md +107 -93
  10. package/agents/reviewer.md +102 -71
  11. package/agents/security-auditor.md +27 -27
  12. package/agents/tester.md +97 -90
  13. package/commands/grill-me.md +20 -4
  14. package/commands/orchestrate.md +16 -0
  15. package/commands/orchestrator.md +16 -0
  16. package/commands/plan.md +17 -1
  17. package/config/agents.json +31 -3
  18. package/config/mcp.json +72 -0
  19. package/config/models.json +26 -16
  20. package/config/profiles.json +2 -4
  21. package/config/skills.json +762 -573
  22. package/docs/SKILLS.md +393 -275
  23. package/docs/designs/old/2026-10-31 plan-lifecycle-backlog-and-clean-code-skill.md +87 -0
  24. package/docs/designs/old/2026-11-02 skill-upstream-audit-and-update.md +105 -0
  25. package/docs/designs/old/2026-11-05 communication-doctrine-bluf-ste.md +94 -0
  26. package/docs/designs/old/2026-11-06-cloud-engineer-and-resilience-synthesis.md +67 -0
  27. package/docs/designs/old/2026-11-06-herdr-native-agent-orchestration.md +45 -0
  28. package/docs/runs/skill-audit/2026-11-12-compare-report.json +1028 -0
  29. package/docs/runs/skill-audit/2026-11-12-upstream-audit.json +275 -0
  30. package/docs/runs/skill-audit/add_progressive_disclosure.cjs +30 -0
  31. package/docs/runs/skill-audit/check_heimdall_skills.ps1 +9 -0
  32. package/docs/runs/skill-audit/compare_classics.ps1 +26 -0
  33. package/docs/runs/skill-audit/compare_taste.ps1 +12 -0
  34. package/docs/runs/skill-audit/customization-report.json +380 -0
  35. package/docs/runs/skill-audit/diff_pending_skills.cjs +94 -0
  36. package/docs/runs/skill-audit/fetch_and_apply_skill.cjs +58 -0
  37. package/docs/runs/skill-audit/fetch_and_apply_taste_v2.cjs +65 -0
  38. package/docs/runs/skill-audit/inspect_pending_skills.cjs +71 -0
  39. package/docs/runs/skill-audit/inventory.json +308 -0
  40. package/docs/runs/skill-audit/list_local_taste.ps1 +1 -0
  41. package/docs/runs/skill-audit/phase5-update-plan.json +595 -0
  42. package/docs/runs/skill-audit/phase5-update-plan.md +138 -0
  43. package/docs/runs/skill-audit/probe.ps1 +16 -0
  44. package/docs/runs/skill-audit/probe_classics_branches.ps1 +3 -0
  45. package/docs/runs/skill-audit/probe_commits.ps1 +15 -0
  46. package/docs/runs/skill-audit/probe_repos.ps1 +17 -0
  47. package/docs/runs/skill-audit/probe_sentry_sec.ps1 +3 -0
  48. package/docs/runs/skill-audit/probe_sentry_sweep.ps1 +5 -0
  49. package/docs/runs/skill-audit/probe_snyk.ps1 +3 -0
  50. package/docs/runs/skill-audit/probe_snyk_recipes.ps1 +5 -0
  51. package/docs/runs/skill-audit/probe_taste_branches.ps1 +8 -0
  52. package/docs/runs/skill-audit/probe_taste_v19.ps1 +3 -0
  53. package/docs/runs/skill-audit/probe_user_repos.ps1 +19 -0
  54. package/docs/runs/skill-audit/prune_taste_skills.cjs +22 -0
  55. package/docs/runs/skill-audit/run_phase1_2.cjs +142 -0
  56. package/docs/runs/skill-audit/run_phase6_verification.cjs +107 -0
  57. package/docs/runs/skill-audit/show_16_details.ps1 +25 -0
  58. package/docs/runs/skill-audit/show_20_skills.ps1 +28 -0
  59. package/docs/runs/skill-audit/show_classics_diff.cjs +37 -0
  60. package/docs/runs/skill-audit/sync_agent_markdowns.cjs +30 -0
  61. package/docs/runs/skill-audit/taste-skill-upstream.md +542 -0
  62. package/docs/runs/skill-audit/update-manifest.md +88 -0
  63. package/docs/runs/skill-audit/update_config_skills.cjs +52 -0
  64. package/docs/runs/skill-audit/update_registry_phase7.cjs +83 -0
  65. package/docs/runs/skill-audit/upstream-status.json +563 -0
  66. package/docs/runs/skill-audit/verification-results.json +252 -0
  67. package/doctrine/AGENTS.md +42 -77
  68. package/hooks/git/pre-commit +11 -0
  69. package/hooks/heimdall-hook.cjs +81 -2
  70. package/hooks/herdr-agent-state.ps1 +55 -0
  71. package/hooks/hooks.json +0 -11
  72. package/lib/catalog-sync.cjs +167 -0
  73. package/lib/hermes-context.cjs +57 -0
  74. package/lib/model-context.cjs +123 -0
  75. package/lib/path-discovery.cjs +94 -0
  76. package/package.json +7 -3
  77. package/playbooks/01-interactive-grilling-gate.md +23 -6
  78. package/playbooks/02-fast-code-deep-verification.md +3 -2
  79. package/playbooks/03-adversarial-code-review.md +15 -7
  80. package/playbooks/05-canonical-plan-template.md +35 -19
  81. package/playbooks/06-model-registry-matrix.md +24 -13
  82. package/playbooks/07-legacy-code-modernization.md +74 -0
  83. package/playbooks/08-backlog-and-change-request-flow.md +122 -0
  84. package/setup.mjs +592 -172
  85. package/skills/antislop/SKILL.md +76 -56
  86. package/skills/antislop/VERSION +1 -0
  87. package/skills/antislop-copywriting/SKILL.md +407 -372
  88. package/skills/antislop-human/LICENSE-web-quality-skills +21 -0
  89. package/skills/antislop-human/SKILL.md +204 -147
  90. package/skills/antislop-human/contrast-check.py +168 -165
  91. package/skills/antislop-human/contrast-mcp.py +6 -3
  92. package/skills/antislop-human/references/A11Y-PATTERNS.md +249 -0
  93. package/skills/antislop-human/references/WCAG.md +127 -0
  94. package/skills/antislop-ui/LICENSE-web-quality-skills +21 -0
  95. package/skills/antislop-ui/SKILL.md +344 -304
  96. package/skills/antislop-ui/references/CORE-WEB-VITALS.md +181 -0
  97. package/skills/antislop-ui/references/WEB-BASELINE.md +28 -0
  98. package/skills/brainstorming/SKILL.md +296 -265
  99. package/skills/brainstorming/builder-check-prompt.md +23 -0
  100. package/skills/brainstorming/scripts/frame-template.html +213 -213
  101. package/skills/brainstorming/scripts/server.cjs +723 -723
  102. package/skills/brandkit/SKILL.md +798 -798
  103. package/skills/brutalist-skill/SKILL.md +93 -92
  104. package/skills/caveman/README.md +68 -0
  105. package/skills/caveman/SKILL.md +73 -38
  106. package/skills/claude-collaborator/SKILL.md +24 -44
  107. package/skills/clean-code/SKILL.md +152 -0
  108. package/skills/cloudflare-security-audit/AI-AND-LLM.md +83 -83
  109. package/skills/cloudflare-security-audit/ATTACK-CLASSES.md +130 -130
  110. package/skills/cloudflare-security-audit/CLIENT-SIDE.md +83 -83
  111. package/skills/cloudflare-security-audit/CLOUD-AND-DEPLOYMENT.md +86 -86
  112. package/skills/cloudflare-security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -84
  113. package/skills/cloudflare-security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -89
  114. package/skills/cloudflare-security-audit/HUNTING.md +251 -251
  115. package/skills/cloudflare-security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -101
  116. package/skills/cloudflare-security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -81
  117. package/skills/cloudflare-security-audit/RECONNAISSANCE.md +156 -156
  118. package/skills/cloudflare-security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -78
  119. package/skills/cloudflare-security-audit/SKILL.md +192 -192
  120. package/skills/cloudflare-security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -73
  121. package/skills/cloudflare-security-audit/VALIDATION-AND-REPORTING.md +186 -186
  122. package/skills/cloudflare-security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -105
  123. package/skills/cloudflare-security-audit/report-schema.json +461 -461
  124. package/skills/cloudflare-security-audit/validate-coverage-ledger.cjs +872 -872
  125. package/skills/cloudflare-security-audit/validate-coverage-ledger.test.cjs +740 -740
  126. package/skills/cloudflare-security-audit/validate-findings.cjs +773 -773
  127. package/skills/cloudflare-security-audit/validate-findings.test.cjs +652 -652
  128. package/skills/codebase-design/DEEPENING.md +37 -0
  129. package/skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
  130. package/skills/codebase-design/SKILL.md +114 -0
  131. package/skills/codex-collaborator/SKILL.md +24 -45
  132. package/skills/communication-doctrine/SKILL.md +89 -0
  133. package/skills/diagnosing-superpowers/SKILL.md +1 -1
  134. package/skills/diagnosing-superpowers/references/github-issues.md +3 -3
  135. package/skills/diagnosing-superpowers/templates/issue.md +23 -4
  136. package/skills/domain-modeling/ADR-FORMAT.md +47 -0
  137. package/skills/domain-modeling/GLOSSARY-FORMAT.md +60 -0
  138. package/skills/domain-modeling/SKILL.md +74 -0
  139. package/skills/executing-plans/SKILL.md +6 -56
  140. package/skills/executing-plans/scripts/task-done +52 -52
  141. package/skills/executing-plans/scripts/task-start +28 -28
  142. package/skills/gemini-collaborator/SKILL.md +24 -56
  143. package/skills/grill-me/SKILL.md +65 -0
  144. package/skills/handoff/SKILL.md +64 -0
  145. package/skills/herdr/SKILL.md +243 -0
  146. package/skills/image-to-code-skill/SKILL.md +1228 -1228
  147. package/skills/imagegen-frontend-mobile/SKILL.md +1465 -1465
  148. package/skills/imagegen-frontend-web/SKILL.md +987 -987
  149. package/skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
  150. package/skills/improve-codebase-architecture/SKILL.md +71 -0
  151. package/skills/karpathy-guidelines/SKILL.md +67 -67
  152. package/skills/mcp-engineering/SKILL.md +74 -0
  153. package/skills/minimalist-skill/SKILL.md +87 -85
  154. package/skills/output-skill/SKILL.md +49 -49
  155. package/skills/owasp-security/reference/config-and-supply-chain.md +346 -344
  156. package/skills/owasp-security/reference/languages.md +378 -372
  157. package/skills/owasp-security/reference/owasp-report.md +1144 -1140
  158. package/skills/owasp-security/reference/review-checklist.md +134 -132
  159. package/skills/ponytail/SKILL.md +36 -52
  160. package/skills/postgres-best-practices/SKILL.md +30 -52
  161. package/skills/postgres-best-practices/references/backup-restore.md +372 -0
  162. package/skills/postgres-best-practices/references/bulk-loading.md +315 -0
  163. package/skills/postgres-best-practices/references/connection-pooling.md +310 -0
  164. package/skills/postgres-best-practices/references/hot-standby.md +221 -0
  165. package/skills/postgres-best-practices/references/indexing.md +318 -0
  166. package/skills/postgres-best-practices/references/logical-replication.md +610 -0
  167. package/skills/postgres-best-practices/references/major-version-upgrades.md +334 -0
  168. package/skills/postgres-best-practices/references/performance-diagnostics.md +553 -0
  169. package/skills/postgres-best-practices/references/query-optimization.md +294 -0
  170. package/skills/postgres-best-practices/references/query-patterns.md +566 -0
  171. package/skills/postgres-best-practices/references/schema-design.md +362 -0
  172. package/skills/postgres-best-practices/references/security-roles.md +489 -0
  173. package/skills/postgres-best-practices/references/transaction-isolation.md +344 -0
  174. package/skills/progressive-disclosure/SKILL.md +68 -0
  175. package/skills/pstack-discipline/SKILL.md +40 -0
  176. package/skills/receiving-code-review/SKILL.md +2 -23
  177. package/skills/requesting-code-review/SKILL.md +7 -36
  178. package/skills/soft-skill/SKILL.md +99 -98
  179. package/skills/stitch-skill/DESIGN.md +121 -121
  180. package/skills/stitch-skill/SKILL.md +185 -184
  181. package/skills/strix-security/SKILL.md +54 -53
  182. package/skills/subagent-driven-development/SKILL.md +35 -264
  183. package/skills/subagent-driven-development/references/batching.md +11 -0
  184. package/skills/subagent-driven-development/references/cannot-verify.md +10 -0
  185. package/skills/subagent-driven-development/references/final-review.md +47 -0
  186. package/skills/subagent-driven-development/references/fix-loop.md +77 -0
  187. package/skills/subagent-driven-development/references/handling-reports.md +15 -0
  188. package/skills/subagent-driven-development/references/preflight.md +26 -0
  189. package/skills/subagent-driven-development/references/resuming.md +12 -0
  190. package/skills/subagent-driven-development/scripts/review-package +53 -53
  191. package/skills/subagent-driven-development/scripts/sdd-workspace +87 -82
  192. package/skills/subagent-driven-development/scripts/task-brief +43 -43
  193. package/skills/systematic-debugging/SKILL.md +283 -306
  194. package/skills/taste-skill/SKILL.md +542 -1206
  195. package/skills/taste-skill/references/app-screens.md +1199 -0
  196. package/skills/taste-skill/references/colour.md +141 -0
  197. package/skills/taste-skill/references/copy.md +177 -0
  198. package/skills/taste-skill/references/critique.md +182 -0
  199. package/skills/taste-skill/references/imagery.md +791 -0
  200. package/skills/taste-skill/references/layout.md +292 -0
  201. package/skills/taste-skill/references/motion.md +980 -0
  202. package/skills/taste-skill/references/research.md +356 -0
  203. package/skills/taste-skill/references/scenes.md +174 -0
  204. package/skills/taste-skill/references/tells.md +115 -0
  205. package/skills/taste-skill/references/type.md +170 -0
  206. package/skills/test-driven-development/SKILL.md +330 -337
  207. package/skills/thermo/SKILL.md +67 -0
  208. package/skills/threat-modeling/SKILL.md +55 -0
  209. package/skills/to-spec/SKILL.md +75 -0
  210. package/skills/to-tickets/SKILL.md +105 -0
  211. package/skills/trailofbits-audit-context/SKILL.md +72 -72
  212. package/skills/trailofbits-insecure-defaults/commands/audit.md +35 -0
  213. package/skills/trailofbits-insecure-defaults/references/debug-features.json +13 -13
  214. package/skills/trailofbits-insecure-defaults/references/debug-features.md +75 -75
  215. package/skills/trailofbits-insecure-defaults/references/default-credentials.json +12 -12
  216. package/skills/trailofbits-insecure-defaults/references/default-credentials.md +76 -76
  217. package/skills/trailofbits-insecure-defaults/references/fail-open-security.json +11 -11
  218. package/skills/trailofbits-insecure-defaults/references/fail-open-security.md +70 -70
  219. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.json +11 -11
  220. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.md +70 -70
  221. package/skills/trailofbits-insecure-defaults/references/permissive-access.json +13 -13
  222. package/skills/trailofbits-insecure-defaults/references/permissive-access.md +62 -62
  223. package/skills/trailofbits-insecure-defaults/references/weak-crypto.json +13 -13
  224. package/skills/trailofbits-insecure-defaults/references/weak-crypto.md +71 -71
  225. package/skills/trailofbits-triage-brocards/SKILL.md +208 -208
  226. package/skills/verification-before-completion/SKILL.md +0 -14
  227. package/skills/wayfinder/SKILL.md +128 -0
  228. package/skills/writing-plans/SKILL.md +11 -15
  229. package/skills/writing-skills/SKILL.md +21 -303
  230. package/skills/writing-skills/references/CLAUDE_MD_TESTING.md +189 -0
  231. package/skills/writing-skills/references/anthropic-best-practices.md +1150 -0
  232. package/skills/writing-skills/references/bulletproofing.md +80 -0
  233. package/skills/writing-skills/references/discovery.md +201 -0
  234. package/skills/writing-skills/references/flowcharts.md +37 -0
  235. package/skills/writing-skills/references/graphviz-conventions.dot +172 -0
  236. package/skills/writing-skills/references/persuasion-principles.md +187 -0
  237. package/skills/writing-skills/references/testing-skills-with-subagents.md +384 -0
  238. package/tools/{claude-bridge.ps1 → archive/claude-bridge.ps1} +10 -7
  239. package/tools/{codex-bridge.ps1 → archive/codex-bridge.ps1} +1 -1
  240. package/tools/{gemini-bridge.ps1 → archive/gemini-bridge.ps1} +12 -19
  241. package/skills/gpt-tasteskill/SKILL.md +0 -74
  242. package/skills/taste-skill-v1/SKILL.md +0 -226
  243. /package/tools/{claude-bridge.cmd → archive/claude-bridge.cmd} +0 -0
  244. /package/tools/{claude-bridge.sh → archive/claude-bridge.sh} +0 -0
  245. /package/tools/{codex-bridge.cmd → archive/codex-bridge.cmd} +0 -0
  246. /package/tools/{codex-bridge.sh → archive/codex-bridge.sh} +0 -0
  247. /package/tools/{codexcli-bridge.cmd → archive/codexcli-bridge.cmd} +0 -0
  248. /package/tools/{codexcli-bridge.ps1 → archive/codexcli-bridge.ps1} +0 -0
  249. /package/tools/{gemini-bridge.cmd → archive/gemini-bridge.cmd} +0 -0
  250. /package/tools/{gemini-bridge.sh → archive/gemini-bridge.sh} +0 -0
@@ -0,0 +1,138 @@
1
+ # Phase 5 Update Plan — Final v2 (All 51 Skills Resolved)
2
+
3
+ **Generated**: 2026-11-02T13:23:32.162Z
4
+ **Total skills**: 51
5
+ **Updatable**: 51
6
+ **Skipped**: 0
7
+
8
+ ---
9
+
10
+ ## https://github.com/obra/superpowers
11
+
12
+ | Skill | SHA | Files | Notes |
13
+ | :--- | :--- | :--- | :--- |
14
+ | `brainstorming` | `2ce8aa1` | 8 | |
15
+ | `diagnosing-superpowers` | `2ce8aa1` | 20 | |
16
+ | `dispatching-parallel-agents` | `2ce8aa1` | 1 | |
17
+ | `executing-plans` | `2ce8aa1` | 3 | |
18
+ | `finishing-a-development-branch` | `2ce8aa1` | 1 | |
19
+ | `receiving-code-review` | `2ce8aa1` | 1 | |
20
+ | `requesting-code-review` | `2ce8aa1` | 2 | |
21
+ | `subagent-driven-development` | `2ce8aa1` | 14 | |
22
+ | `systematic-debugging` | `2ce8aa1` | 11 | |
23
+ | `test-driven-development` | `2ce8aa1` | 2 | |
24
+ | `using-git-worktrees` | `2ce8aa1` | 1 | |
25
+ | `using-superpowers` | `2ce8aa1` | 8 | |
26
+ | `verification-before-completion` | `2ce8aa1` | 1 | |
27
+ | `writing-plans` | `2ce8aa1` | 1 | |
28
+ | `writing-skills` | `2ce8aa1` | 10 | |
29
+ ---
30
+
31
+ ## https://github.com/bepaldes/heimdall-agent
32
+
33
+ | Skill | SHA | Files | Notes |
34
+ | :--- | :--- | :--- | :--- |
35
+ | `brandkit` | `ffe2d3f` | 1 | |
36
+ | `brutalist-skill` | `ffe2d3f` | 1 | |
37
+ | `claude-collaborator` | `ffe2d3f` | 1 | |
38
+ | `gemini-collaborator` | `ffe2d3f` | 1 | |
39
+ | `gpt-tasteskill` | `ffe2d3f` | 1 | |
40
+ | `image-to-code-skill` | `ffe2d3f` | 1 | |
41
+ | `imagegen-frontend-mobile` | `ffe2d3f` | 1 | |
42
+ | `imagegen-frontend-web` | `ffe2d3f` | 1 | |
43
+ | `minimalist-skill` | `ffe2d3f` | 1 | |
44
+ | `output-skill` | `ffe2d3f` | 1 | |
45
+ | `owasp-security` | `ffe2d3f` | 5 | |
46
+ | `project-hygiene` | `ffe2d3f` | 1 | |
47
+ | `redesign-skill` | `ffe2d3f` | 1 | |
48
+ | `security-audit-sweep` | `ffe2d3f` | 1 | |
49
+ | `snyk-agent-scan` | `ffe2d3f` | 1 | |
50
+ | `soft-skill` | `ffe2d3f` | 1 | |
51
+ | `stitch-skill` | `ffe2d3f` | 2 | |
52
+ | `taste-skill` | `ffe2d3f` | 1 | |
53
+ | `taste-skill-v1` | `ffe2d3f` | 1 | |
54
+ | `codex-collaborator` | `ffe2d3f` | 1 | |
55
+ ---
56
+
57
+ ## https://github.com/cloudflare/security-audit-skill
58
+
59
+ | Skill | SHA | Files | Notes |
60
+ | :--- | :--- | :--- | :--- |
61
+ | `cloudflare-security-audit` | `c1c8a8c` | 20 | Corrected upstream: cloudflare/security-audit-skill. 20 files including SKILL.md, 13 reference docs, schema, and validation scripts. |
62
+ ---
63
+
64
+ ## https://github.com/JuliusBrussee/caveman
65
+
66
+ | Skill | SHA | Files | Notes |
67
+ | :--- | :--- | :--- | :--- |
68
+ | `caveman` | `2e068f7` | 2 | |
69
+ ---
70
+
71
+ ## https://github.com/DietrichGebert/ponytail
72
+
73
+ | Skill | SHA | Files | Notes |
74
+ | :--- | :--- | :--- | :--- |
75
+ | `ponytail` | `96608e0` | 1 | |
76
+ ---
77
+
78
+ ## https://github.com/trailofbits/skills
79
+
80
+ | Skill | SHA | Files | Notes |
81
+ | :--- | :--- | :--- | :--- |
82
+ | `trailofbits-audit-context` | `2be6433` | 1 | Found at plugins/audit-context-building/skills/audit-context-building/ |
83
+ | `trailofbits-insecure-defaults` | `2be6433` | 13 | Found at plugins/insecure-defaults/ (no SKILL.md — uses commands/audit.md + references/) |
84
+ | `trailofbits-triage-brocards` | `2be6433` | 1 | Found at plugins/vulnerability-triage-brocards/skills/vulnerability-triage-brocards/ |
85
+ ---
86
+
87
+ ## https://github.com/unclebob/ub-mode
88
+
89
+ | Skill | SHA | Files | Notes |
90
+ | :--- | :--- | :--- | :--- |
91
+ | `clean-code` | `57a8bdd` | 1 | Found at repo root: SKILL.md |
92
+ ---
93
+
94
+ ## https://github.com/miqdadbadjuber/anti-slop
95
+
96
+ | Skill | SHA | Files | Notes |
97
+ | :--- | :--- | :--- | :--- |
98
+ | `antislop` | `941b153` | 2 | |
99
+ | `antislop-code` | `941b153` | 1 | |
100
+ | `antislop-copywriting` | `941b153` | 1 | |
101
+ | `antislop-human` | `941b153` | 6 | |
102
+ | `antislop-layoutmobile` | `941b153` | 1 | |
103
+ | `antislop-ui` | `941b153` | 4 | |
104
+ ---
105
+
106
+ ## https://github.com/multica-ai/andrej-karpathy-skills
107
+
108
+ | Skill | SHA | Files | Notes |
109
+ | :--- | :--- | :--- | :--- |
110
+ | `karpathy-guidelines` | `2c60614` | 1 | |
111
+ ---
112
+
113
+ ## https://github.com/neondatabase/postgres-skills
114
+
115
+ | Skill | SHA | Files | Notes |
116
+ | :--- | :--- | :--- | :--- |
117
+ | `postgres-best-practices` | `27fe45e` | 14 | |
118
+ ---
119
+
120
+ ## https://github.com/usestrix/strix
121
+
122
+ | Skill | SHA | Files | Notes |
123
+ | :--- | :--- | :--- | :--- |
124
+ | `strix-security` | `6b7ae2e` | 1 | Mapped to skills/application-security-testing/ (closest match to general security testing methodology) |
125
+
126
+ ---
127
+
128
+ ## Execution Summary
129
+
130
+ - **51 skills** will be updated from upstream (one git commit per skill)
131
+ - **0 skills** skipped
132
+ - Each update fetches all listed files via GitHub raw content API at the exact audited SHA
133
+ - `cloudflare-security-audit`: corrected to `cloudflare/security-audit-skill` — 20 files (SKILL.md + 13 reference docs + schema + validation scripts)
134
+ - `trailofbits-insecure-defaults`: references/ files written to local references/ dir (no upstream SKILL.md)
135
+ - `strix-security`: maps to upstream `skills/application-security-testing/SKILL.md`
136
+ - `clean-code`: maps to upstream root `SKILL.md`
137
+
138
+ **Ready for approval to begin sequential execution.**
@@ -0,0 +1,16 @@
1
+ $repos = @(
2
+ "Leonxlnx/taste-skill",
3
+ "Leonxlnx/taste-skill-classics",
4
+ "agamm/claude-code-owasp",
5
+ "snyk/agent-scan",
6
+ "blencorp/security-sweep"
7
+ )
8
+
9
+ foreach ($r in $repos) {
10
+ try {
11
+ $res = Invoke-RestMethod -Uri "https://api.github.com/repos/$r" -Headers @{ "User-Agent" = "PowerShell" }
12
+ Write-Host "[OK] $r : $($res.full_name) - default branch: $($res.default_branch)"
13
+ } catch {
14
+ Write-Host "[FAIL] $r : $($_.Exception.Message)"
15
+ }
16
+ }
@@ -0,0 +1,3 @@
1
+ $headers = @{ 'User-Agent' = 'PowerShell' }
2
+ $b = Invoke-RestMethod -Uri 'https://api.github.com/repos/Leonxlnx/taste-skill-classics/branches' -Headers $headers
3
+ $b | Select-Object -ExpandProperty name
@@ -0,0 +1,15 @@
1
+ $headers = @{ 'User-Agent' = 'PowerShell' }
2
+ $repos = @(
3
+ "Leonxlnx/taste-skill",
4
+ "Leonxlnx/taste-skill-classics",
5
+ "agamm/claude-code-owasp",
6
+ "snyk/agent-scan"
7
+ )
8
+
9
+ foreach ($r in $repos) {
10
+ $c = Invoke-RestMethod -Uri "https://api.github.com/repos/$r/commits?per_page=1" -Headers $headers
11
+ Write-Host "=== $r ==="
12
+ Write-Host "SHA: $($c[0].sha)"
13
+ Write-Host "Date: $($c[0].commit.committer.date)"
14
+ Write-Host "Message: $($c[0].commit.message)"
15
+ }
@@ -0,0 +1,17 @@
1
+ $headers = @{ 'User-Agent' = 'PowerShell' }
2
+
3
+ Write-Host "=== Leonxlnx/taste-skill ==="
4
+ $t1 = Invoke-RestMethod -Uri 'https://api.github.com/repos/Leonxlnx/taste-skill/git/trees/main?recursive=1' -Headers $headers
5
+ $t1.tree | Where-Object { $_.type -eq 'blob' } | Select-Object -ExpandProperty path
6
+
7
+ Write-Host "`n=== Leonxlnx/taste-skill-classics ==="
8
+ $t2 = Invoke-RestMethod -Uri 'https://api.github.com/repos/Leonxlnx/taste-skill-classics/git/trees/main?recursive=1' -Headers $headers
9
+ $t2.tree | Where-Object { $_.type -eq 'blob' } | Select-Object -ExpandProperty path
10
+
11
+ Write-Host "`n=== agamm/claude-code-owasp ==="
12
+ $t3 = Invoke-RestMethod -Uri 'https://api.github.com/repos/agamm/claude-code-owasp/git/trees/main?recursive=1' -Headers $headers
13
+ $t3.tree | Where-Object { $_.type -eq 'blob' } | Select-Object -ExpandProperty path
14
+
15
+ Write-Host "`n=== snyk/agent-scan ==="
16
+ $t4 = Invoke-RestMethod -Uri 'https://api.github.com/repos/snyk/agent-scan/git/trees/main?recursive=1' -Headers $headers
17
+ $t4.tree | Where-Object { $_.type -eq 'blob' } | Select-Object -ExpandProperty path
@@ -0,0 +1,3 @@
1
+ $headers = @{ 'User-Agent' = 'PowerShell' }
2
+ $res = Invoke-RestMethod -Uri "https://raw.githubusercontent.com/getsentry/skills/main/skills/security-review/SKILL.md" -Headers $headers
3
+ $res.Substring(0, [Math]::Min(1000, $res.Length))
@@ -0,0 +1,5 @@
1
+ $headers = @{ 'User-Agent' = 'PowerShell' }
2
+ $res = Invoke-RestMethod -Uri "https://api.github.com/repos/getsentry/skills/git/trees/main?recursive=1" -Headers $headers
3
+ $matches = $res.tree | Where-Object { $_.path -like '*sweep*' -or $_.path -like '*audit*' } | Select-Object -ExpandProperty path
4
+ Write-Host "Matches in getsentry/skills:"
5
+ $matches
@@ -0,0 +1,3 @@
1
+ $headers = @{ 'User-Agent' = 'PowerShell' }
2
+ $t = Invoke-RestMethod -Uri 'https://api.github.com/repos/snyk/agent-scan/git/trees/main?recursive=1' -Headers $headers
3
+ $t.tree | Where-Object { $_.path -like '*skill*' } | Select-Object -ExpandProperty path
@@ -0,0 +1,5 @@
1
+ $headers = @{ 'User-Agent' = 'PowerShell' }
2
+ $res = Invoke-RestMethod -Uri "https://api.github.com/repos/snyk/studio-recipes/git/trees/main?recursive=1" -Headers $headers
3
+ $matches = $res.tree | Where-Object { $_.path -like '*agent*' } | Select-Object -ExpandProperty path
4
+ Write-Host "Matches in snyk/studio-recipes for agent:"
5
+ $matches
@@ -0,0 +1,8 @@
1
+ $headers = @{ 'User-Agent' = 'PowerShell' }
2
+ $branches = Invoke-RestMethod -Uri 'https://api.github.com/repos/Leonxlnx/taste-skill/branches' -Headers $headers
3
+ Write-Host "Branches in Leonxlnx/taste-skill:"
4
+ $branches | Select-Object -ExpandProperty name
5
+
6
+ $tags = Invoke-RestMethod -Uri 'https://api.github.com/repos/Leonxlnx/taste-skill/tags' -Headers $headers
7
+ Write-Host "Tags in Leonxlnx/taste-skill:"
8
+ $tags | Select-Object -ExpandProperty name
@@ -0,0 +1,3 @@
1
+ $headers = @{ 'User-Agent' = 'PowerShell' }
2
+ $t = Invoke-RestMethod -Uri 'https://api.github.com/repos/Leonxlnx/taste-skill/git/trees/taste-skill-v1.9?recursive=1' -Headers $headers
3
+ $t.tree | Where-Object { $_.type -eq 'tree' } | Select-Object -ExpandProperty path
@@ -0,0 +1,19 @@
1
+ $headers = @{ 'User-Agent' = 'PowerShell' }
2
+ $repos = @(
3
+ 'getsentry/skills',
4
+ 'agamm/claude-code-owasp',
5
+ 'snyk/studio-recipes'
6
+ )
7
+
8
+ foreach ($r in $repos) {
9
+ try {
10
+ $res = Invoke-RestMethod -Uri "https://api.github.com/repos/$r" -Headers $headers
11
+ Write-Host "[OK] $r : $($res.full_name) - default branch: $($res.default_branch)"
12
+ $tree = Invoke-RestMethod -Uri "https://api.github.com/repos/$r/git/trees/$($res.default_branch)?recursive=1" -Headers $headers
13
+ $skills = $tree.tree | Where-Object { $_.path -like '*skill*' -or $_.path -like '*SKILL*' } | Select-Object -ExpandProperty path
14
+ Write-Host "Skills/files matching skill in $r :"
15
+ $skills | ForEach-Object { Write-Host " $_" }
16
+ } catch {
17
+ Write-Host "[FAIL] $r : $($_.Exception.Message)"
18
+ }
19
+ }
@@ -0,0 +1,22 @@
1
+ const fs = require('fs');
2
+ const path = require('path');
3
+
4
+ const configPath = path.resolve('config/skills.json');
5
+ const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
6
+
7
+ // 1. Remove from taste-studio modules
8
+ if (config.suites['taste-studio']) {
9
+ config.suites['taste-studio'].modules = config.suites['taste-studio'].modules.filter(
10
+ m => m !== 'taste-skill-v1' && m !== 'gpt-tasteskill'
11
+ );
12
+ }
13
+
14
+ // 2. Remove from skills map
15
+ delete config.skills['taste-skill-v1'];
16
+ delete config.skills['gpt-tasteskill'];
17
+
18
+ // 3. Update totalModules count
19
+ config.totalModules = Object.keys(config.skills).length;
20
+
21
+ fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
22
+ console.log(`Updated config/skills.json: totalModules = ${config.totalModules}`);
@@ -0,0 +1,142 @@
1
+ const fs = require('fs');
2
+ const path = require('path');
3
+ const https = require('https');
4
+
5
+ const configPath = path.resolve('config/skills.json');
6
+ const inventoryPath = path.resolve('docs/runs/skill-audit/inventory.json');
7
+ const statusPath = path.resolve('docs/runs/skill-audit/upstream-status.json');
8
+
9
+ const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
10
+
11
+ // Phase 1: Extract inventory
12
+ const inventory = [];
13
+ for (const [name, skill] of Object.entries(config.skills)) {
14
+ inventory.push({
15
+ name,
16
+ upstream: skill.upstream,
17
+ sourceRevision: skill.sourceRevision,
18
+ category: skill.category
19
+ });
20
+ }
21
+
22
+ fs.writeFileSync(inventoryPath, JSON.stringify(inventory, null, 2) + '\n', 'utf8');
23
+ console.log(`Phase 1 complete: Inventory extracted for ${inventory.length} skills.`);
24
+
25
+ // Helper to fetch from GitHub API
26
+ function fetchGithub(url) {
27
+ return new Promise((resolve, reject) => {
28
+ const options = {
29
+ headers: {
30
+ 'User-Agent': 'Heimdall-Skill-Audit/1.0'
31
+ }
32
+ };
33
+ https.get(url, options, (res) => {
34
+ let data = '';
35
+ res.on('data', (chunk) => { data += chunk; });
36
+ res.on('end', () => {
37
+ if (res.statusCode >= 200 && res.statusCode < 300) {
38
+ try {
39
+ resolve(JSON.parse(data));
40
+ } catch (e) {
41
+ reject(new Error(`Failed to parse JSON: ${e.message}`));
42
+ }
43
+ } else {
44
+ reject(new Error(`HTTP ${res.statusCode}: ${data}`));
45
+ }
46
+ });
47
+ }).on('error', (err) => {
48
+ reject(err);
49
+ });
50
+ });
51
+ }
52
+
53
+ async function runPhase2() {
54
+ console.log('Starting Phase 2: Upstream polling...');
55
+ // We can cache repo commits to avoid redundant API hits for multiple skills in same repo
56
+ const repoCache = {};
57
+
58
+ const upstreamStatus = [];
59
+
60
+ for (const item of inventory) {
61
+ const upstreamUrl = item.upstream;
62
+ // Extract owner/repo
63
+ const match = upstreamUrl.match(/github\.com\/([^\/]+)\/([^\/]+)/);
64
+ if (!match) {
65
+ upstreamStatus.push({
66
+ name: item.name,
67
+ upstream: item.upstream,
68
+ currentRevision: item.sourceRevision,
69
+ latestSha: null,
70
+ latestDate: null,
71
+ latestMessage: null,
72
+ error: `Could not parse GitHub repo from ${upstreamUrl}`,
73
+ hasUpdate: false
74
+ });
75
+ continue;
76
+ }
77
+
78
+ const owner = match[1];
79
+ const repo = match[2].replace(/\.git$/, '');
80
+ const repoKey = `${owner}/${repo}`;
81
+
82
+ if (!repoCache[repoKey]) {
83
+ console.log(`Polling upstream for ${repoKey}...`);
84
+ try {
85
+ const commits = await fetchGithub(`https://api.github.com/repos/${repoKey}/commits?per_page=1`);
86
+ if (commits && commits.length > 0) {
87
+ repoCache[repoKey] = {
88
+ sha: commits[0].sha,
89
+ date: commits[0].commit.committer ? commits[0].commit.committer.date : commits[0].commit.author.date,
90
+ message: commits[0].commit.message.split('\n')[0]
91
+ };
92
+ } else {
93
+ repoCache[repoKey] = { error: 'No commits found' };
94
+ }
95
+ } catch (err) {
96
+ console.error(`Error polling ${repoKey}:`, err.message);
97
+ repoCache[repoKey] = { error: err.message };
98
+ }
99
+ // Brief pause to respect GitHub rate limits
100
+ await new Promise(r => setTimeout(r, 600));
101
+ }
102
+
103
+ const cached = repoCache[repoKey];
104
+ if (cached.error) {
105
+ upstreamStatus.push({
106
+ name: item.name,
107
+ upstream: item.upstream,
108
+ currentRevision: item.sourceRevision,
109
+ latestSha: null,
110
+ latestDate: null,
111
+ latestMessage: null,
112
+ error: cached.error,
113
+ hasUpdate: false
114
+ });
115
+ } else {
116
+ const isInternal = (repoKey.toLowerCase() === 'bepaldes/heimdall-agent');
117
+ const hasUpdate = isInternal ? false : (item.sourceRevision !== cached.sha.substring(0, 7) && item.sourceRevision !== cached.sha);
118
+ upstreamStatus.push({
119
+ name: item.name,
120
+ upstream: item.upstream,
121
+ currentRevision: item.sourceRevision,
122
+ latestSha: cached.sha,
123
+ latestDate: cached.date,
124
+ latestMessage: cached.message,
125
+ error: null,
126
+ hasUpdate: hasUpdate,
127
+ isInternal: isInternal
128
+ });
129
+ }
130
+ }
131
+
132
+ fs.writeFileSync(statusPath, JSON.stringify(upstreamStatus, null, 2) + '\n', 'utf8');
133
+ console.log(`Phase 2 complete: Upstream status recorded for ${upstreamStatus.length} skills.`);
134
+
135
+ const updates = upstreamStatus.filter(s => s.hasUpdate);
136
+ console.log(`Total skills with available updates: ${updates.length}`);
137
+ }
138
+
139
+ runPhase2().catch(err => {
140
+ console.error('Phase 2 failed:', err);
141
+ process.exit(1);
142
+ });
@@ -0,0 +1,107 @@
1
+ const fs = require('fs');
2
+ const path = require('path');
3
+
4
+ const config = JSON.parse(fs.readFileSync('config/skills.json', 'utf8'));
5
+ const skillsDir = path.resolve('skills');
6
+
7
+ const results = [];
8
+ let passCount = 0;
9
+ let failCount = 0;
10
+
11
+ for (const [skillName, skillMeta] of Object.entries(config.skills)) {
12
+ const dirPath = path.join(skillsDir, skillName);
13
+ const skillFile = path.join(dirPath, 'SKILL.md');
14
+
15
+ const check = {
16
+ skill: skillName,
17
+ dirExists: false,
18
+ skillMdExists: false,
19
+ frontmatterValid: false,
20
+ hasHeading: false,
21
+ linksValid: true,
22
+ brokenLinks: []
23
+ };
24
+
25
+ try {
26
+ if (!fs.existsSync(dirPath)) {
27
+ throw new Error(`Directory ${dirPath} does not exist`);
28
+ }
29
+ check.dirExists = true;
30
+
31
+ // Some skills like trailofbits-insecure-defaults might not have a SKILL.md if it uses commands/audit.md
32
+ if (!fs.existsSync(skillFile)) {
33
+ // Check if it has alternative markdown files
34
+ const mdFiles = fs.readdirSync(dirPath, { recursive: true }).filter(f => f.endsWith('.md'));
35
+ if (mdFiles.length === 0) {
36
+ throw new Error(`No SKILL.md or markdown files found in ${dirPath}`);
37
+ }
38
+ check.skillMdExists = true;
39
+ check.frontmatterValid = true;
40
+ check.hasHeading = true;
41
+ } else {
42
+ check.skillMdExists = true;
43
+ const content = fs.readFileSync(skillFile, 'utf8');
44
+
45
+ // Check frontmatter
46
+ const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
47
+ if (!fmMatch) {
48
+ throw new Error(`Invalid or missing YAML frontmatter in ${skillFile}`);
49
+ }
50
+ const fm = fmMatch[1];
51
+ if (!fm.includes('name:')) {
52
+ throw new Error(`Missing 'name' field in frontmatter of ${skillFile}`);
53
+ }
54
+ if (!fm.includes('description:')) {
55
+ throw new Error(`Missing 'description' field in frontmatter of ${skillFile}`);
56
+ }
57
+ check.frontmatterValid = true;
58
+
59
+ // Check heading
60
+ if (!content.includes('# ')) {
61
+ throw new Error(`Missing markdown H1 heading in ${skillFile}`);
62
+ }
63
+ check.hasHeading = true;
64
+
65
+ // Check local relative links
66
+ const linkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
67
+ let m;
68
+ while ((m = linkRegex.exec(content)) !== null) {
69
+ const target = m[2].split('#')[0].split('?')[0];
70
+ if (target && !target.startsWith('http') && !target.startsWith('mailto:') && !target.startsWith('#')) {
71
+ const resolvedPath = path.resolve(dirPath, target);
72
+ if (!fs.existsSync(resolvedPath)) {
73
+ check.brokenLinks.push(target);
74
+ }
75
+ }
76
+ }
77
+ if (check.brokenLinks.length > 0) {
78
+ check.linksValid = false;
79
+ // Notice: broken links can be warnings or soft notes, but let's log them
80
+ console.warn(`[WARN] ${skillName} has broken relative link references:`, check.brokenLinks);
81
+ }
82
+ }
83
+
84
+ results.push({
85
+ skill: skillName,
86
+ status: 'pass',
87
+ error: null
88
+ });
89
+ passCount++;
90
+ } catch (err) {
91
+ results.push({
92
+ skill: skillName,
93
+ status: 'fail',
94
+ error: err.message
95
+ });
96
+ failCount++;
97
+ }
98
+ }
99
+
100
+ fs.writeFileSync('docs/runs/skill-audit/verification-results.json', JSON.stringify(results, null, 2) + '\n', 'utf8');
101
+ console.log(`\nVerification Complete!`);
102
+ console.log(`Passed: ${passCount} / ${results.length}`);
103
+ console.log(`Failed: ${failCount} / ${results.length}`);
104
+
105
+ if (failCount > 0) {
106
+ process.exit(1);
107
+ }
@@ -0,0 +1,25 @@
1
+ $json = Get-Content config/skills.json -Raw | ConvertFrom-Json
2
+ $skillsToCheck = @(
3
+ "taste-skill",
4
+ "output-skill",
5
+ "image-to-code-skill",
6
+ "imagegen-frontend-mobile",
7
+ "imagegen-frontend-web",
8
+ "brandkit",
9
+ "soft-skill",
10
+ "minimalist-skill",
11
+ "brutalist-skill",
12
+ "gpt-tasteskill",
13
+ "stitch-skill",
14
+ "redesign-skill",
15
+ "taste-skill-v1",
16
+ "owasp-security",
17
+ "snyk-agent-scan",
18
+ "security-audit-sweep"
19
+ )
20
+
21
+ foreach ($s in $skillsToCheck) {
22
+ $val = $json.skills.$s
23
+ Write-Host "--- $s ---"
24
+ Write-Host ($val | ConvertTo-Json -Depth 2)
25
+ }
@@ -0,0 +1,28 @@
1
+ $json = Get-Content config/skills.json -Raw | ConvertFrom-Json
2
+ $skillsToCheck = @(
3
+ "taste-skill",
4
+ "output-skill",
5
+ "image-to-code-skill",
6
+ "imagegen-frontend-mobile",
7
+ "imagegen-frontend-web",
8
+ "brandkit",
9
+ "soft-skill",
10
+ "minimalist-skill",
11
+ "brutalist-skill",
12
+ "gpt-tasteskill",
13
+ "stitch-skill",
14
+ "redesign-skill",
15
+ "taste-skill-v1",
16
+ "owasp-security",
17
+ "snyk-agent-scan",
18
+ "security-audit-sweep",
19
+ "claude-collaborator",
20
+ "gemini-collaborator",
21
+ "codex-collaborator",
22
+ "project-hygiene"
23
+ )
24
+
25
+ foreach ($s in $skillsToCheck) {
26
+ $item = $json.skills.$s
27
+ Write-Host "$s : $($item.upstream) [rev: $($item.sourceRevision)]"
28
+ }
@@ -0,0 +1,37 @@
1
+ const fs = require('fs');
2
+ const https = require('https');
3
+
4
+ function fetchRaw(url) {
5
+ return new Promise((resolve, reject) => {
6
+ https.get(url, { headers: { 'User-Agent': 'Heimdall-Audit/1.0' } }, (res) => {
7
+ let data = '';
8
+ res.on('data', c => data += c);
9
+ res.on('end', () => resolve(data));
10
+ }).on('error', reject);
11
+ });
12
+ }
13
+
14
+ async function showDiff(skill) {
15
+ const url = `https://raw.githubusercontent.com/Leonxlnx/taste-skill-classics/main/skills/${skill}/SKILL.md`;
16
+ const remote = (await fetchRaw(url)).replace(/\r\n/g, '\n');
17
+ const local = fs.readFileSync(`skills/${skill}/SKILL.md`, 'utf8').replace(/\r\n/g, '\n');
18
+
19
+ console.log(`\n================== ${skill} ==================`);
20
+ const remoteLines = remote.split('\n');
21
+ const localLines = local.split('\n');
22
+ console.log(`Remote lines: ${remoteLines.length}, Local lines: ${localLines.length}`);
23
+
24
+ // Show first 15 lines of both
25
+ console.log('--- REMOTE TOP ---');
26
+ console.log(remoteLines.slice(0, 10).join('\n'));
27
+ console.log('--- LOCAL TOP ---');
28
+ console.log(localLines.slice(0, 10).join('\n'));
29
+ }
30
+
31
+ async function run() {
32
+ for (const s of ['soft-skill', 'minimalist-skill', 'brutalist-skill', 'gpt-tasteskill', 'stitch-skill', 'taste-skill-v1']) {
33
+ await showDiff(s);
34
+ }
35
+ }
36
+
37
+ run().catch(console.error);
@@ -0,0 +1,30 @@
1
+ const fs = require('fs');
2
+ const path = require('path');
3
+
4
+ const configAgents = JSON.parse(fs.readFileSync('config/agents.json', 'utf8')).agents;
5
+
6
+ for (const [name, agent] of Object.entries(configAgents)) {
7
+ const af = path.join('agents', name + '.md');
8
+ if (!fs.existsSync(af)) {
9
+ console.warn(`File not found: ${af}`);
10
+ continue;
11
+ }
12
+ let content = fs.readFileSync(af, 'utf8');
13
+
14
+ // Split frontmatter from body
15
+ const parts = content.split(/^---\r?\n/m);
16
+ if (parts.length < 3) {
17
+ console.error(`Malformed frontmatter in ${af}`);
18
+ continue;
19
+ }
20
+
21
+ let fm = parts[1];
22
+ const body = parts.slice(2).join('---\n');
23
+
24
+ const skillsBlock = 'skills:\n' + agent.skills.map(s => ` - ${s}`).join('\n') + '\n';
25
+ fm = fm.replace(/skills:\s*\n(?:\s*-\s*[\w-]+\s*\n)*/, skillsBlock);
26
+
27
+ const updatedContent = `---\n${fm}---\n${body}`;
28
+ fs.writeFileSync(af, updatedContent, 'utf8');
29
+ console.log(`Synced ${af} (${agent.skills.length} skills)`);
30
+ }