heimdall-agent 1.0.0 → 1.1.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 (231) hide show
  1. package/README.md +57 -26
  2. package/README.pt-BR.md +429 -0
  3. package/agents/cloud-engineer.md +77 -0
  4. package/agents/code-sentinel.md +66 -35
  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 +66 -0
  9. package/agents/orchestrator.md +94 -93
  10. package/agents/reviewer.md +100 -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 +21 -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 +210 -100
  22. package/docs/SKILLS.md +341 -245
  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/add_progressive_disclosure.cjs +30 -0
  29. package/docs/runs/skill-audit/check_heimdall_skills.ps1 +9 -0
  30. package/docs/runs/skill-audit/compare_classics.ps1 +26 -0
  31. package/docs/runs/skill-audit/compare_taste.ps1 +12 -0
  32. package/docs/runs/skill-audit/customization-report.json +380 -0
  33. package/docs/runs/skill-audit/diff_pending_skills.cjs +94 -0
  34. package/docs/runs/skill-audit/fetch_and_apply_skill.cjs +58 -0
  35. package/docs/runs/skill-audit/fetch_and_apply_taste_v2.cjs +65 -0
  36. package/docs/runs/skill-audit/inspect_pending_skills.cjs +71 -0
  37. package/docs/runs/skill-audit/inventory.json +308 -0
  38. package/docs/runs/skill-audit/list_local_taste.ps1 +1 -0
  39. package/docs/runs/skill-audit/phase5-update-plan.json +595 -0
  40. package/docs/runs/skill-audit/phase5-update-plan.md +138 -0
  41. package/docs/runs/skill-audit/probe.ps1 +16 -0
  42. package/docs/runs/skill-audit/probe_classics_branches.ps1 +3 -0
  43. package/docs/runs/skill-audit/probe_commits.ps1 +15 -0
  44. package/docs/runs/skill-audit/probe_repos.ps1 +17 -0
  45. package/docs/runs/skill-audit/probe_sentry_sec.ps1 +3 -0
  46. package/docs/runs/skill-audit/probe_sentry_sweep.ps1 +5 -0
  47. package/docs/runs/skill-audit/probe_snyk.ps1 +3 -0
  48. package/docs/runs/skill-audit/probe_snyk_recipes.ps1 +5 -0
  49. package/docs/runs/skill-audit/probe_taste_branches.ps1 +8 -0
  50. package/docs/runs/skill-audit/probe_taste_v19.ps1 +3 -0
  51. package/docs/runs/skill-audit/probe_user_repos.ps1 +19 -0
  52. package/docs/runs/skill-audit/prune_taste_skills.cjs +22 -0
  53. package/docs/runs/skill-audit/run_phase1_2.cjs +142 -0
  54. package/docs/runs/skill-audit/run_phase6_verification.cjs +107 -0
  55. package/docs/runs/skill-audit/show_16_details.ps1 +25 -0
  56. package/docs/runs/skill-audit/show_20_skills.ps1 +28 -0
  57. package/docs/runs/skill-audit/show_classics_diff.cjs +37 -0
  58. package/docs/runs/skill-audit/sync_agent_markdowns.cjs +30 -0
  59. package/docs/runs/skill-audit/taste-skill-upstream.md +542 -0
  60. package/docs/runs/skill-audit/update-manifest.md +88 -0
  61. package/docs/runs/skill-audit/update_config_skills.cjs +52 -0
  62. package/docs/runs/skill-audit/update_registry_phase7.cjs +83 -0
  63. package/docs/runs/skill-audit/upstream-status.json +563 -0
  64. package/docs/runs/skill-audit/verification-results.json +252 -0
  65. package/doctrine/AGENTS.md +39 -77
  66. package/hooks/git/pre-commit +11 -0
  67. package/hooks/heimdall-hook.cjs +81 -2
  68. package/hooks/herdr-agent-state.ps1 +55 -0
  69. package/hooks/hooks.json +0 -11
  70. package/lib/catalog-sync.cjs +162 -0
  71. package/lib/hermes-context.cjs +57 -0
  72. package/lib/model-context.cjs +123 -0
  73. package/lib/path-discovery.cjs +94 -0
  74. package/package.json +7 -3
  75. package/playbooks/01-interactive-grilling-gate.md +14 -1
  76. package/playbooks/02-fast-code-deep-verification.md +3 -2
  77. package/playbooks/03-adversarial-code-review.md +3 -3
  78. package/playbooks/05-canonical-plan-template.md +32 -18
  79. package/playbooks/06-model-registry-matrix.md +24 -13
  80. package/playbooks/07-legacy-code-modernization.md +74 -0
  81. package/playbooks/08-backlog-and-change-request-flow.md +122 -0
  82. package/setup.mjs +592 -172
  83. package/skills/antislop/SKILL.md +76 -56
  84. package/skills/antislop/VERSION +1 -0
  85. package/skills/antislop-copywriting/SKILL.md +372 -372
  86. package/skills/antislop-human/LICENSE-web-quality-skills +21 -0
  87. package/skills/antislop-human/SKILL.md +204 -147
  88. package/skills/antislop-human/contrast-check.py +168 -165
  89. package/skills/antislop-human/contrast-mcp.py +6 -3
  90. package/skills/antislop-human/references/A11Y-PATTERNS.md +249 -0
  91. package/skills/antislop-human/references/WCAG.md +127 -0
  92. package/skills/antislop-ui/LICENSE-web-quality-skills +21 -0
  93. package/skills/antislop-ui/SKILL.md +344 -304
  94. package/skills/antislop-ui/references/CORE-WEB-VITALS.md +181 -0
  95. package/skills/antislop-ui/references/WEB-BASELINE.md +28 -0
  96. package/skills/brainstorming/SKILL.md +274 -265
  97. package/skills/brainstorming/builder-check-prompt.md +23 -0
  98. package/skills/brainstorming/scripts/frame-template.html +213 -213
  99. package/skills/brainstorming/scripts/server.cjs +723 -723
  100. package/skills/brandkit/SKILL.md +798 -798
  101. package/skills/brutalist-skill/SKILL.md +93 -92
  102. package/skills/caveman/README.md +68 -0
  103. package/skills/caveman/SKILL.md +73 -38
  104. package/skills/claude-collaborator/SKILL.md +24 -44
  105. package/skills/clean-code/SKILL.md +152 -0
  106. package/skills/cloudflare-security-audit/AI-AND-LLM.md +83 -83
  107. package/skills/cloudflare-security-audit/ATTACK-CLASSES.md +130 -130
  108. package/skills/cloudflare-security-audit/CLIENT-SIDE.md +83 -83
  109. package/skills/cloudflare-security-audit/CLOUD-AND-DEPLOYMENT.md +86 -86
  110. package/skills/cloudflare-security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -84
  111. package/skills/cloudflare-security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -89
  112. package/skills/cloudflare-security-audit/HUNTING.md +251 -251
  113. package/skills/cloudflare-security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -101
  114. package/skills/cloudflare-security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -81
  115. package/skills/cloudflare-security-audit/RECONNAISSANCE.md +156 -156
  116. package/skills/cloudflare-security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -78
  117. package/skills/cloudflare-security-audit/SKILL.md +192 -192
  118. package/skills/cloudflare-security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -73
  119. package/skills/cloudflare-security-audit/VALIDATION-AND-REPORTING.md +186 -186
  120. package/skills/cloudflare-security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -105
  121. package/skills/cloudflare-security-audit/report-schema.json +461 -461
  122. package/skills/cloudflare-security-audit/validate-coverage-ledger.cjs +872 -872
  123. package/skills/cloudflare-security-audit/validate-coverage-ledger.test.cjs +740 -740
  124. package/skills/cloudflare-security-audit/validate-findings.cjs +773 -773
  125. package/skills/cloudflare-security-audit/validate-findings.test.cjs +652 -652
  126. package/skills/codex-collaborator/SKILL.md +24 -45
  127. package/skills/communication-doctrine/SKILL.md +89 -0
  128. package/skills/diagnosing-superpowers/SKILL.md +1 -1
  129. package/skills/diagnosing-superpowers/references/github-issues.md +3 -3
  130. package/skills/diagnosing-superpowers/templates/issue.md +23 -4
  131. package/skills/executing-plans/SKILL.md +0 -52
  132. package/skills/executing-plans/scripts/task-done +52 -52
  133. package/skills/executing-plans/scripts/task-start +28 -28
  134. package/skills/gemini-collaborator/SKILL.md +24 -56
  135. package/skills/herdr/SKILL.md +243 -0
  136. package/skills/image-to-code-skill/SKILL.md +1228 -1228
  137. package/skills/imagegen-frontend-mobile/SKILL.md +1465 -1465
  138. package/skills/imagegen-frontend-web/SKILL.md +987 -987
  139. package/skills/karpathy-guidelines/SKILL.md +67 -67
  140. package/skills/mcp-engineering/SKILL.md +74 -0
  141. package/skills/minimalist-skill/SKILL.md +87 -85
  142. package/skills/output-skill/SKILL.md +49 -49
  143. package/skills/ponytail/SKILL.md +36 -52
  144. package/skills/postgres-best-practices/SKILL.md +30 -52
  145. package/skills/postgres-best-practices/references/backup-restore.md +372 -0
  146. package/skills/postgres-best-practices/references/bulk-loading.md +315 -0
  147. package/skills/postgres-best-practices/references/connection-pooling.md +310 -0
  148. package/skills/postgres-best-practices/references/hot-standby.md +221 -0
  149. package/skills/postgres-best-practices/references/indexing.md +318 -0
  150. package/skills/postgres-best-practices/references/logical-replication.md +610 -0
  151. package/skills/postgres-best-practices/references/major-version-upgrades.md +334 -0
  152. package/skills/postgres-best-practices/references/performance-diagnostics.md +553 -0
  153. package/skills/postgres-best-practices/references/query-optimization.md +294 -0
  154. package/skills/postgres-best-practices/references/query-patterns.md +566 -0
  155. package/skills/postgres-best-practices/references/schema-design.md +362 -0
  156. package/skills/postgres-best-practices/references/security-roles.md +489 -0
  157. package/skills/postgres-best-practices/references/transaction-isolation.md +344 -0
  158. package/skills/progressive-disclosure/SKILL.md +68 -0
  159. package/skills/pstack-discipline/SKILL.md +40 -0
  160. package/skills/receiving-code-review/SKILL.md +2 -23
  161. package/skills/requesting-code-review/SKILL.md +7 -36
  162. package/skills/soft-skill/SKILL.md +99 -98
  163. package/skills/stitch-skill/DESIGN.md +121 -121
  164. package/skills/stitch-skill/SKILL.md +185 -184
  165. package/skills/strix-security/SKILL.md +54 -53
  166. package/skills/subagent-driven-development/SKILL.md +28 -260
  167. package/skills/subagent-driven-development/references/batching.md +11 -0
  168. package/skills/subagent-driven-development/references/cannot-verify.md +10 -0
  169. package/skills/subagent-driven-development/references/final-review.md +47 -0
  170. package/skills/subagent-driven-development/references/fix-loop.md +77 -0
  171. package/skills/subagent-driven-development/references/handling-reports.md +15 -0
  172. package/skills/subagent-driven-development/references/preflight.md +26 -0
  173. package/skills/subagent-driven-development/references/resuming.md +12 -0
  174. package/skills/subagent-driven-development/scripts/review-package +53 -53
  175. package/skills/subagent-driven-development/scripts/sdd-workspace +87 -82
  176. package/skills/subagent-driven-development/scripts/task-brief +43 -43
  177. package/skills/systematic-debugging/SKILL.md +283 -306
  178. package/skills/taste-skill/SKILL.md +542 -1206
  179. package/skills/taste-skill/references/app-screens.md +1199 -0
  180. package/skills/taste-skill/references/colour.md +141 -0
  181. package/skills/taste-skill/references/copy.md +177 -0
  182. package/skills/taste-skill/references/critique.md +182 -0
  183. package/skills/taste-skill/references/imagery.md +791 -0
  184. package/skills/taste-skill/references/layout.md +292 -0
  185. package/skills/taste-skill/references/motion.md +980 -0
  186. package/skills/taste-skill/references/research.md +356 -0
  187. package/skills/taste-skill/references/scenes.md +174 -0
  188. package/skills/taste-skill/references/tells.md +115 -0
  189. package/skills/taste-skill/references/type.md +170 -0
  190. package/skills/test-driven-development/SKILL.md +330 -337
  191. package/skills/thermo/SKILL.md +67 -0
  192. package/skills/threat-modeling/SKILL.md +55 -0
  193. package/skills/trailofbits-audit-context/SKILL.md +72 -72
  194. package/skills/trailofbits-insecure-defaults/commands/audit.md +35 -0
  195. package/skills/trailofbits-insecure-defaults/references/debug-features.json +13 -13
  196. package/skills/trailofbits-insecure-defaults/references/debug-features.md +75 -75
  197. package/skills/trailofbits-insecure-defaults/references/default-credentials.json +12 -12
  198. package/skills/trailofbits-insecure-defaults/references/default-credentials.md +76 -76
  199. package/skills/trailofbits-insecure-defaults/references/fail-open-security.json +11 -11
  200. package/skills/trailofbits-insecure-defaults/references/fail-open-security.md +70 -70
  201. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.json +11 -11
  202. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.md +70 -70
  203. package/skills/trailofbits-insecure-defaults/references/permissive-access.json +13 -13
  204. package/skills/trailofbits-insecure-defaults/references/permissive-access.md +62 -62
  205. package/skills/trailofbits-insecure-defaults/references/weak-crypto.json +13 -13
  206. package/skills/trailofbits-insecure-defaults/references/weak-crypto.md +71 -71
  207. package/skills/trailofbits-triage-brocards/SKILL.md +208 -208
  208. package/skills/verification-before-completion/SKILL.md +0 -14
  209. package/skills/writing-plans/SKILL.md +11 -15
  210. package/skills/writing-skills/SKILL.md +21 -303
  211. package/skills/writing-skills/references/CLAUDE_MD_TESTING.md +189 -0
  212. package/skills/writing-skills/references/anthropic-best-practices.md +1150 -0
  213. package/skills/writing-skills/references/bulletproofing.md +80 -0
  214. package/skills/writing-skills/references/discovery.md +201 -0
  215. package/skills/writing-skills/references/flowcharts.md +37 -0
  216. package/skills/writing-skills/references/graphviz-conventions.dot +172 -0
  217. package/skills/writing-skills/references/persuasion-principles.md +187 -0
  218. package/skills/writing-skills/references/testing-skills-with-subagents.md +384 -0
  219. package/tools/{claude-bridge.ps1 → archive/claude-bridge.ps1} +10 -7
  220. package/tools/{codex-bridge.ps1 → archive/codex-bridge.ps1} +1 -1
  221. package/tools/{gemini-bridge.ps1 → archive/gemini-bridge.ps1} +12 -19
  222. package/skills/gpt-tasteskill/SKILL.md +0 -74
  223. package/skills/taste-skill-v1/SKILL.md +0 -226
  224. /package/tools/{claude-bridge.cmd → archive/claude-bridge.cmd} +0 -0
  225. /package/tools/{claude-bridge.sh → archive/claude-bridge.sh} +0 -0
  226. /package/tools/{codex-bridge.cmd → archive/codex-bridge.cmd} +0 -0
  227. /package/tools/{codex-bridge.sh → archive/codex-bridge.sh} +0 -0
  228. /package/tools/{codexcli-bridge.cmd → archive/codexcli-bridge.cmd} +0 -0
  229. /package/tools/{codexcli-bridge.ps1 → archive/codexcli-bridge.ps1} +0 -0
  230. /package/tools/{gemini-bridge.cmd → archive/gemini-bridge.cmd} +0 -0
  231. /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
+ }