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
package/docs/SKILLS.md CHANGED
@@ -1,282 +1,378 @@
1
- # Heimdall Canonical Skills & Suites Directory
2
-
3
- This directory serves as the comprehensive reference manual for Heimdall's **15 Primary Toolkits & Suites (50 modular capabilities)**.
4
-
5
- > **Architecture & Execution**: Each skill module is an isolated directory containing a YAML-frontmattered `SKILL.md`. AI agent harnesses (Google Antigravity, Claude Code, OpenAI Codex CLI) parse frontmatter on startup and dynamically activate instructions via progressive disclosure.
6
-
7
- ## Upstream Provenance & Update Governance Directive
8
-
9
- > *"Update the selected skill or plugin through its supported mechanism. Review changed instructions/references and repeat a bounded review after material updates. Record source revision, reviewed range, actual tests and remaining validation in the private report."*
10
-
11
- To inspect provenance or verify updates via the CLI:
12
- ```powershell
13
- heimdall update-skill <name>
14
- # or inspect all skills
15
- heimdall update-skill all
16
- ```
17
-
18
- <a id="toc"></a>
19
- ## Primary Suites & Toolkits Index
20
-
21
- ### Core Multi-Skill Suites
22
- - [📦 Superpowers Software Engineering Suite (15 modules)](#superpowers)
23
- - [📦 Taste Design & Aesthetic Studio (12 modules)](#taste-studio)
24
- - [📦 Anti-Slop Quality & Token Efficiency Suite (6 modules)](#antislop)
25
- - [📦 Tri-Directional Cross-Model Bridges (3 modules)](#cross-model-bridges)
26
- - [📦 Trail of Bits High-Assurance AppSec Suite (3 modules)](#trailofbits-appsec)
27
-
28
- ### Standalone Power Toolkits
29
- - [⚡ Ponytail Code Restraint](#ponytail)
30
- - [⚡ Karpathy Simplicity Guidelines](#karpathy-guidelines)
31
- - [⚡ Strix Differential Security Probing](#strix-security)
32
- - [⚡ Security Audit Sweep Sentinel](#security-audit-sweep)
33
- - [⚡ OWASP Top 10 Web Defense](#owasp-security)
34
- - [⚡ Cloudflare Edge & WAF Security](#cloudflare-security-audit)
35
- - [⚡ Snyk Dependency & Vulnerability Scan](#snyk-agent-scan)
36
- - [⚡ Supabase Postgres Best Practices](#postgres-best-practices)
37
- - [⚡ Project & Workspace Hygiene Sentinel](#project-hygiene)
38
- - [⚡ Structured Analysis & Output Formatting](#output-skill)
39
- - [⚡ Caveman Chat Token Brevity Protocol](#caveman)
40
-
41
- ---
42
-
43
- ## Core Multi-Skill Suites
44
-
45
- <a id="superpowers"></a>
46
- ### 📦 Superpowers Software Engineering Suite (15 modules)
47
-
48
- - **Upstream Source**: [https://github.com/obra/superpowers](https://github.com/obra/superpowers)
49
- - **Suite Type**: Multi-Skill Suite
50
-
51
- #### Included Modules:
52
-
53
- * **`brainstorming`**: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation." ([Contract File](../skills/brainstorming/SKILL.md))
54
- * **`writing-plans`**: Use when you have a spec or requirements for a multi-step task, before touching code ([Contract File](../skills/writing-plans/SKILL.md))
55
- * **`executing-plans`**: Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available ([Contract File](../skills/executing-plans/SKILL.md))
56
- * **`subagent-driven-development`**: Use when executing implementation plans with independent tasks in the current session ([Contract File](../skills/subagent-driven-development/SKILL.md))
57
- * **`dispatching-parallel-agents`**: Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies ([Contract File](../skills/dispatching-parallel-agents/SKILL.md))
58
- * **`test-driven-development`**: Use when implementing any feature or bugfix, before writing implementation code ([Contract File](../skills/test-driven-development/SKILL.md))
59
- * **`systematic-debugging`**: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes ([Contract File](../skills/systematic-debugging/SKILL.md))
60
- * **`verification-before-completion`**: Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always ([Contract File](../skills/verification-before-completion/SKILL.md))
61
- * **`finishing-a-development-branch`**: Use when implementation is complete, all tests pass, and you need to decide how to integrate the work ([Contract File](../skills/finishing-a-development-branch/SKILL.md))
62
- * **`using-git-worktrees`**: Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback ([Contract File](../skills/using-git-worktrees/SKILL.md))
63
- * **`requesting-code-review`**: Use when completing tasks, implementing major features, or before merging to verify work meets requirements ([Contract File](../skills/requesting-code-review/SKILL.md))
64
- * **`receiving-code-review`**: Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation ([Contract File](../skills/receiving-code-review/SKILL.md))
65
- * **`using-superpowers`**: Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions ([Contract File](../skills/using-superpowers/SKILL.md))
66
- * **`diagnosing-superpowers`**: Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. ([Contract File](../skills/diagnosing-superpowers/SKILL.md))
67
- * **`writing-skills`**: Use when creating new skills, editing existing skills, or verifying skills work before deployment ([Contract File](../skills/writing-skills/SKILL.md))
68
-
69
- [↑ Back to top](#toc)
70
-
71
- ---
72
-
73
- <a id="taste-studio"></a>
74
- ### 📦 Taste Design & Aesthetic Studio (12 modules)
75
-
76
- - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
77
- - **Suite Type**: Multi-Skill Suite
78
-
79
- #### Included Modules:
80
-
81
- * **`taste-skill`**: Frontend craft, anti-slop, and high-taste design skill for UI adjustments, interactive interfaces, new features, components, redesigns, landing pages, and web apps. The agent infers the right design direction, eliminates generic AI defaults, enforces design tokens and design systems, and ships polished, intentional interfaces. ([Contract File](../skills/taste-skill/SKILL.md))
82
- * **`taste-skill-v1`**: The original v1 taste-skill, preserved for projects depending on its exact behavior. The current default is `design-taste-frontend` (v2 experimental), which is a substantial rewrite. Use this v1 install name only if you need exact backward compatibility. ([Contract File](../skills/taste-skill-v1/SKILL.md))
83
- * **`gpt-tasteskill`**: Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing. ([Contract File](../skills/gpt-tasteskill/SKILL.md))
84
- * **`brandkit`**: Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts. ([Contract File](../skills/brandkit/SKILL.md))
85
- * **`minimalist-skill`**: Clean editorial-style interfaces. Warm monochrome palette, typographic contrast, flat bento grids, muted pastels. No gradients, no heavy shadows. ([Contract File](../skills/minimalist-skill/SKILL.md))
86
- * **`brutalist-skill`**: Raw mechanical interfaces fusing Swiss typographic print with military terminal aesthetics. Rigid grids, extreme type scale contrast, utilitarian color, analog degradation effects. For data-heavy dashboards, portfolios, or editorial sites that need to feel like declassified blueprints. ([Contract File](../skills/brutalist-skill/SKILL.md))
87
- * **`soft-skill`**: Teaches the AI to design like a high-end agency. Defines the exact fonts, spacing, shadows, card structures, and animations that make a website feel expensive. Blocks all the common defaults that make AI designs look cheap or generic. ([Contract File](../skills/soft-skill/SKILL.md))
88
- * **`redesign-skill`**: Upgrades existing websites and apps to premium quality. Audits current design, identifies generic AI patterns, and applies high-end design standards without breaking functionality. Works with any CSS framework or vanilla CSS. ([Contract File](../skills/redesign-skill/SKILL.md))
89
- * **`image-to-code-skill`**: Elite website image-to-code skill for Codex. For visually important web tasks, it must first generate the design image(s) itself, deeply analyze them, then implement the website to match them as closely as possible. In Codex, it must prefer large, readable, section-specific images instead of tiny compressed boards, generate fresh standalone images for sections or detail views instead of cropping old ones, avoid lazy under-generation, avoid cards-inside-cards-inside-cards UI, and keep the hero clean, spacious, readable, and visible on a small laptop. ([Contract File](../skills/image-to-code-skill/SKILL.md))
90
- * **`stitch-skill`**: Semantic Design System Skill for Google Stitch. Generates agent-friendly DESIGN.md files that enforce premium, anti-generic UI standards — strict typography, calibrated color, asymmetric layouts, perpetual micro-motion, and hardware-accelerated performance. ([Contract File](../skills/stitch-skill/SKILL.md))
91
- * **`imagegen-frontend-web`**: Elite frontend image-direction skill for generating premium, conversion-aware website design references. CRITICAL OUTPUT RULE — generate ONE separate horizontal image FOR EVERY section. A landing page with 8 sections produces 8 images. Never compress multiple sections into one image. Enforces composition variety (not always left-text / right-image), background-image freedom, varied CTAs, varied hero scales (giant / mid / mini minimalist), narrative concept spine, second-read moments, and a single consistent palette across all images. Optimized for landing pages, marketing sites, and product comps that developers or coding models can accurately recreate. ([Contract File](../skills/imagegen-frontend-web/SKILL.md))
92
- * **`imagegen-frontend-mobile`**: Elite mobile app image-generation skill for creating premium, app-native screen concepts and flows. Designed for iOS, Android, and cross-platform mobile products. Prioritizes clean hierarchy, comfortably readable text, strong multi-screen consistency, controlled color palettes, non-generic creative direction, textured surfaces, image-led composition, tasteful custom iconography, and clean phone mockup framing. By default, screens should be shown inside a subtle premium iPhone or similar phone mockup with a visible frame, while the main focus stays on the app content itself. This skill generates images only. It does not write code. ([Contract File](../skills/imagegen-frontend-mobile/SKILL.md))
93
-
94
- [↑ Back to top](#toc)
95
-
96
- ---
97
-
98
- <a id="antislop"></a>
99
- ### 📦 Anti-Slop Quality & Token Efficiency Suite (6 modules)
100
-
101
- - **Upstream Source**: [https://github.com/obra/antislop](https://github.com/obra/antislop)
102
- - **Suite Type**: Multi-Skill Suite
103
-
104
- #### Included Modules:
105
-
106
- * **`antislop`**: "Anti Slop: Rules for AI Coding Agents. The core filter. Load always to stop generic AI slop." ([Contract File](../skills/antislop/SKILL.md))
107
- * **`antislop-code`**: "Code comment hygiene for AI coding agents: remove generic AI-slop comments, keep the valuable ones, never touch the code." ([Contract File](../skills/antislop-code/SKILL.md))
108
- * **`antislop-copywriting`**: "Copy and text skill for antislop. Use when writing or editing prose: headlines, tone, CTAs, and anti-AI-writing patterns. Load with the core." ([Contract File](../skills/antislop-copywriting/SKILL.md))
109
- * **`antislop-ui`**: "UI and visual skill for antislop. Use when building or editing any interface: color, layout, components, motion. Load with the core." ([Contract File](../skills/antislop-ui/SKILL.md))
110
- * **`antislop-human`**: "Human and accessibility skill for antislop. Contrast, keyboard, focus, and states for real people. Includes the contrast checker." ([Contract File](../skills/antislop-human/SKILL.md))
111
- * **`antislop-layoutmobile`**: "Mobile layout skill for antislop. Use for layouts that reflow across screen sizes, phone to desktop: grids, overflow, tap targets. Load with the core." ([Contract File](../skills/antislop-layoutmobile/SKILL.md))
112
-
113
- [↑ Back to top](#toc)
114
-
115
- ---
116
-
117
- <a id="cross-model-bridges"></a>
118
- ### 📦 Tri-Directional Cross-Model Bridges (3 modules)
119
-
120
- - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
121
- - **Suite Type**: Multi-Skill Suite
122
-
123
- #### Included Modules:
124
-
125
- * **`claude-collaborator`**: Coordinate with Claude Code CLI (claude.exe) to cross-validate changes, request second-opinion reviews on git diffs, or validate test runs. ([Contract File](../skills/claude-collaborator/SKILL.md))
126
- * **`gemini-collaborator`**: Coordinate with Google Antigravity / Gemini CLI (agy.exe) to cross-validate changes, request second opinions on architecture/diffs, or execute adversarial code reviews. ([Contract File](../skills/gemini-collaborator/SKILL.md))
127
- * **`codex-collaborator`**: Coordinate with OpenAI Codex CLI (codex.exe) to cross-validate changes, request second-opinion reviews on git diffs, or validate test runs. ([Contract File](../skills/codex-collaborator/SKILL.md))
128
-
129
- [↑ Back to top](#toc)
130
-
131
- ---
132
-
133
- <a id="trailofbits-appsec"></a>
134
- ### 📦 Trail of Bits High-Assurance AppSec Suite (3 modules)
135
-
136
- - **Upstream Source**: [https://github.com/trailofbits/skills](https://github.com/trailofbits/skills)
137
- - **Suite Type**: Multi-Skill Suite
138
-
139
- #### Included Modules:
140
-
141
- * **`trailofbits-audit-context`**: Understand a codebase before looking for bugs in it - what each function assumes, what it guarantees, and what it depends on elsewhere. Use when starting an audit, threat model, or architecture review on unfamiliar code, and before any vulnerability-hunting pass. ([Contract File](../skills/trailofbits-audit-context/SKILL.md))
142
- * **`trailofbits-insecure-defaults`**: Audits codebases for insecure defaults, fail-open patterns, fallback credentials, permissive access control, debug endpoints, and weak cryptography using Trail of Bits vulnerability patterns. Use when reviewing configuration, authentication, encryption, authorization bypasses, or security controls. ([Contract File](../skills/trailofbits-insecure-defaults/SKILL.md))
143
- * **`trailofbits-triage-brocards`**: Systematically evaluates incoming vulnerability reports against 7 principled brocards to accept, dismiss, or request clarification before committing engineering resources. ([Contract File](../skills/trailofbits-triage-brocards/SKILL.md))
1
+ # Heimdall Canonical Skills & Suites Directory
2
+
3
+ This directory serves as the comprehensive reference manual for Heimdall's **24 Primary Toolkits & Suites (56 modular capabilities)**.
4
+
5
+ > **Architecture & Execution**: Each skill module is an isolated directory containing a YAML-frontmattered `SKILL.md`. AI agent harnesses (Google Antigravity, Claude Code, OpenAI Codex CLI) parse frontmatter on startup and dynamically activate instructions via progressive disclosure.
6
+
7
+ ## Upstream Provenance & Update Governance Directive
8
+
9
+ > *"Update the selected skill or plugin through its supported mechanism. Review changed instructions/references and repeat a bounded review after material updates. Record source revision, reviewed range, actual tests and remaining validation in the private report."*
10
+
11
+ To inspect provenance or verify updates via the CLI:
12
+ ```powershell
13
+ heimdall update-skill <name>
14
+ # or inspect all skills
15
+ heimdall update-skill all
16
+ ```
17
+
18
+ <a id="toc"></a>
19
+ ## Primary Suites & Toolkits Index
20
+
21
+ ### Core Multi-Skill Suites
22
+ - [📦 Superpowers Software Engineering Suite (15 modules)](#superpowers)
23
+ - [📦 Taste Design & Aesthetic Studio (10 modules)](#taste-studio)
24
+ - [📦 Anti-Slop Quality & Token Efficiency Suite (6 modules)](#antislop)
25
+ - [📦 Tri-Directional Cross-Model Bridges (3 modules)](#cross-model-bridges)
26
+ - [📦 Trail of Bits High-Assurance AppSec Suite (3 modules)](#trailofbits-appsec)
27
+
28
+ ### Standalone Power Toolkits
29
+ - [⚡ Ponytail Code Restraint](#ponytail)
30
+ - [⚡ Karpathy Simplicity Guidelines](#karpathy-guidelines)
31
+ - [⚡ Strix Differential Security Probing](#strix-security)
32
+ - [⚡ Security Audit Sweep Sentinel](#security-audit-sweep)
33
+ - [⚡ OWASP Top 10 Web Defense](#owasp-security)
34
+ - [⚡ Cloudflare Edge & WAF Security](#cloudflare-security-audit)
35
+ - [⚡ Snyk Dependency & Vulnerability Scan](#snyk-agent-scan)
36
+ - [⚡ Supabase Postgres Best Practices](#postgres-best-practices)
37
+ - [⚡ Progressive Disclosure & Skill Architecture](#progressive-disclosure)
38
+ - [⚡ Project & Workspace Hygiene Sentinel](#project-hygiene)
39
+ - [⚡ Structured Analysis & Output Formatting](#output-skill)
40
+ - [⚡ Caveman Chat Token Brevity Protocol](#caveman)
41
+ - [⚡ Clean Code & ub-mode Quality Sentinel](#clean-code)
42
+ - [⚡ Communication Doctrine (BLUF & STE)](#communication-doctrine)
43
+ - [⚡ STRIDE Threat Modeling & Attack Surface Sentinel](#threat-modeling)
44
+ - [⚡ MCP Server & Tool Engineering Standards](#mcp-engineering)
45
+ - [⚡ Herdr Coding Agent Multiplexer & Orchestrator](#herdr)
46
+ - [⚡ Thermo Architectural & Maintainability Audit](#thermo)
47
+ - [⚡ PStack Engineering Discipline](#pstack-discipline)
48
+
49
+ ---
50
+
51
+ ## Core Multi-Skill Suites
52
+
53
+ <a id="superpowers"></a>
54
+ ### 📦 Superpowers Software Engineering Suite (15 modules)
55
+
56
+ - **Upstream Source**: [https://github.com/obra/superpowers](https://github.com/obra/superpowers)
57
+ - **Suite Type**: Multi-Skill Suite
58
+
59
+ #### Included Modules:
60
+
61
+ * **`brainstorming`**: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation." ([Contract File](../skills/brainstorming/SKILL.md))
62
+ * **`writing-plans`**: Use when you have a spec or requirements for a multi-step task, before touching code ([Contract File](../skills/writing-plans/SKILL.md))
63
+ * **`executing-plans`**: Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available ([Contract File](../skills/executing-plans/SKILL.md))
64
+ * **`subagent-driven-development`**: Use when executing implementation plans with independent tasks in the current session ([Contract File](../skills/subagent-driven-development/SKILL.md))
65
+ * **`dispatching-parallel-agents`**: Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies ([Contract File](../skills/dispatching-parallel-agents/SKILL.md))
66
+ * **`test-driven-development`**: Use when implementing any feature or bugfix, before writing implementation code ([Contract File](../skills/test-driven-development/SKILL.md))
67
+ * **`systematic-debugging`**: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes ([Contract File](../skills/systematic-debugging/SKILL.md))
68
+ * **`verification-before-completion`**: Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always ([Contract File](../skills/verification-before-completion/SKILL.md))
69
+ * **`finishing-a-development-branch`**: Use when implementation is complete, all tests pass, and you need to decide how to integrate the work ([Contract File](../skills/finishing-a-development-branch/SKILL.md))
70
+ * **`using-git-worktrees`**: Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback ([Contract File](../skills/using-git-worktrees/SKILL.md))
71
+ * **`requesting-code-review`**: Use when completing tasks, implementing major features, or before merging to verify work meets requirements ([Contract File](../skills/requesting-code-review/SKILL.md))
72
+ * **`receiving-code-review`**: Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation ([Contract File](../skills/receiving-code-review/SKILL.md))
73
+ * **`using-superpowers`**: Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions ([Contract File](../skills/using-superpowers/SKILL.md))
74
+ * **`diagnosing-superpowers`**: Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. ([Contract File](../skills/diagnosing-superpowers/SKILL.md))
75
+ * **`writing-skills`**: Use when creating new skills, editing existing skills, or verifying skills work before deployment ([Contract File](../skills/writing-skills/SKILL.md))
76
+
77
+ [↑ Back to top](#toc)
78
+
79
+ ---
80
+
81
+ <a id="taste-studio"></a>
82
+ ### 📦 Taste Design & Aesthetic Studio (10 modules)
83
+
84
+ - **Upstream Source**: [https://github.com/Leonxlnx/taste-skill](https://github.com/Leonxlnx/taste-skill)
85
+ - **Suite Type**: Multi-Skill Suite
86
+
87
+ #### Included Modules:
88
+
89
+ * **`taste-skill`**: Frontend craft, anti-slop, and high-taste design skill for UI adjustments, interactive interfaces, new features, components, redesigns, landing pages, and web apps. The agent infers the right design direction, eliminates generic AI defaults, enforces design tokens and design systems, and ships polished, intentional interfaces. ([Contract File](../skills/taste-skill/SKILL.md))
90
+ * **`brandkit`**: Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts. ([Contract File](../skills/brandkit/SKILL.md))
91
+ * **`minimalist-skill`**: Clean editorial-style interfaces. Warm monochrome palette, typographic contrast, flat bento grids, muted pastels. No gradients, no heavy shadows. ([Contract File](../skills/minimalist-skill/SKILL.md))
92
+ * **`brutalist-skill`**: Raw mechanical interfaces fusing Swiss typographic print with military terminal aesthetics. Rigid grids, extreme type scale contrast, utilitarian color, analog degradation effects. For data-heavy dashboards, portfolios, or editorial sites that need to feel like declassified blueprints. ([Contract File](../skills/brutalist-skill/SKILL.md))
93
+ * **`soft-skill`**: Teaches the AI to design like a high-end agency. Defines the exact fonts, spacing, shadows, card structures, and animations that make a website feel expensive. Blocks all the common defaults that make AI designs look cheap or generic. ([Contract File](../skills/soft-skill/SKILL.md))
94
+ * **`redesign-skill`**: Upgrades existing websites and apps to premium quality. Audits current design, identifies generic AI patterns, and applies high-end design standards without breaking functionality. Works with any CSS framework or vanilla CSS. ([Contract File](../skills/redesign-skill/SKILL.md))
95
+ * **`image-to-code-skill`**: Elite website image-to-code skill for Codex. For visually important web tasks, it must first generate the design image(s) itself, deeply analyze them, then implement the website to match them as closely as possible. In Codex, it must prefer large, readable, section-specific images instead of tiny compressed boards, generate fresh standalone images for sections or detail views instead of cropping old ones, avoid lazy under-generation, avoid cards-inside-cards-inside-cards UI, and keep the hero clean, spacious, readable, and visible on a small laptop. ([Contract File](../skills/image-to-code-skill/SKILL.md))
96
+ * **`stitch-skill`**: Semantic Design System Skill for Google Stitch. Generates agent-friendly DESIGN.md files that enforce premium, anti-generic UI standards — strict typography, calibrated color, asymmetric layouts, perpetual micro-motion, and hardware-accelerated performance. ([Contract File](../skills/stitch-skill/SKILL.md))
97
+ * **`imagegen-frontend-web`**: Elite frontend image-direction skill for generating premium, conversion-aware website design references. CRITICAL OUTPUT RULE — generate ONE separate horizontal image FOR EVERY section. A landing page with 8 sections produces 8 images. Never compress multiple sections into one image. Enforces composition variety (not always left-text / right-image), background-image freedom, varied CTAs, varied hero scales (giant / mid / mini minimalist), narrative concept spine, second-read moments, and a single consistent palette across all images. Optimized for landing pages, marketing sites, and product comps that developers or coding models can accurately recreate. ([Contract File](../skills/imagegen-frontend-web/SKILL.md))
98
+ * **`imagegen-frontend-mobile`**: Elite mobile app image-generation skill for creating premium, app-native screen concepts and flows. Designed for iOS, Android, and cross-platform mobile products. Prioritizes clean hierarchy, comfortably readable text, strong multi-screen consistency, controlled color palettes, non-generic creative direction, textured surfaces, image-led composition, tasteful custom iconography, and clean phone mockup framing. By default, screens should be shown inside a subtle premium iPhone or similar phone mockup with a visible frame, while the main focus stays on the app content itself. This skill generates images only. It does not write code. ([Contract File](../skills/imagegen-frontend-mobile/SKILL.md))
99
+
100
+ [↑ Back to top](#toc)
101
+
102
+ ---
103
+
104
+ <a id="antislop"></a>
105
+ ### 📦 Anti-Slop Quality & Token Efficiency Suite (6 modules)
106
+
107
+ - **Upstream Source**: [https://github.com/obra/antislop](https://github.com/obra/antislop)
108
+ - **Suite Type**: Multi-Skill Suite
109
+
110
+ #### Included Modules:
111
+
112
+ * **`antislop`**: "Anti Slop: Rules for AI Coding Agents. The core filter. Load always to stop generic AI slop." ([Contract File](../skills/antislop/SKILL.md))
113
+ * **`antislop-code`**: "Code comment hygiene for AI coding agents: remove generic AI-slop comments, keep the valuable ones, never touch the code." ([Contract File](../skills/antislop-code/SKILL.md))
114
+ * **`antislop-copywriting`**: "Copy and text skill for antislop. Use when writing or editing prose: headlines, tone, CTAs, and anti-AI-writing patterns. Load with the core." ([Contract File](../skills/antislop-copywriting/SKILL.md))
115
+ * **`antislop-ui`**: "UI and visual skill for antislop. Use when building or editing any interface: color, layout, components, motion. Load with the core." ([Contract File](../skills/antislop-ui/SKILL.md))
116
+ * **`antislop-human`**: "Human and accessibility skill for antislop. Contrast, keyboard, focus, and states for real people. Includes the contrast checker." ([Contract File](../skills/antislop-human/SKILL.md))
117
+ * **`antislop-layoutmobile`**: "Mobile layout skill for antislop. Use for layouts that reflow across screen sizes, phone to desktop: grids, overflow, tap targets. Load with the core." ([Contract File](../skills/antislop-layoutmobile/SKILL.md))
118
+
119
+ [↑ Back to top](#toc)
120
+
121
+ ---
122
+
123
+ <a id="cross-model-bridges"></a>
124
+ ### 📦 Tri-Directional Cross-Model Bridges (3 modules)
125
+
126
+ - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
127
+ - **Suite Type**: Multi-Skill Suite
128
+
129
+ #### Included Modules:
130
+
131
+ * **`claude-collaborator`**: Coordinate with Claude Code CLI (claude.exe) to cross-validate changes, request second-opinion reviews on git diffs, or validate test runs. ([Contract File](../skills/claude-collaborator/SKILL.md))
132
+ * **`gemini-collaborator`**: Coordinate with Google Antigravity / Gemini CLI (agy.exe) to cross-validate changes, request second opinions on architecture/diffs, or execute adversarial code reviews. ([Contract File](../skills/gemini-collaborator/SKILL.md))
133
+ * **`codex-collaborator`**: Coordinate with OpenAI Codex CLI (codex.exe) to cross-validate changes, request second-opinion reviews on git diffs, or validate test runs. ([Contract File](../skills/codex-collaborator/SKILL.md))
134
+
135
+ [↑ Back to top](#toc)
136
+
137
+ ---
138
+
139
+ <a id="trailofbits-appsec"></a>
140
+ ### 📦 Trail of Bits High-Assurance AppSec Suite (3 modules)
141
+
142
+ - **Upstream Source**: [https://github.com/trailofbits/skills](https://github.com/trailofbits/skills)
143
+ - **Suite Type**: Multi-Skill Suite
144
+
145
+ #### Included Modules:
146
+
147
+ * **`trailofbits-audit-context`**: Understand a codebase before looking for bugs in it - what each function assumes, what it guarantees, and what it depends on elsewhere. Use when starting an audit, threat model, or architecture review on unfamiliar code, and before any vulnerability-hunting pass. ([Contract File](../skills/trailofbits-audit-context/SKILL.md))
148
+ * **`trailofbits-insecure-defaults`**: Audits codebases for insecure defaults, fail-open patterns, fallback credentials, permissive access control, debug endpoints, and weak cryptography using Trail of Bits vulnerability patterns. Use when reviewing configuration, authentication, encryption, authorization bypasses, or security controls. ([Contract File](../skills/trailofbits-insecure-defaults/SKILL.md))
149
+ * **`trailofbits-triage-brocards`**: Systematically evaluates incoming vulnerability reports against 7 principled brocards to accept, dismiss, or request clarification before committing engineering resources. ([Contract File](../skills/trailofbits-triage-brocards/SKILL.md))
150
+
151
+ [↑ Back to top](#toc)
152
+
153
+ ---
154
+
155
+ ## Standalone Power Toolkits
156
+
157
+ <a id="ponytail"></a>
158
+ ### ⚡ Ponytail Code Restraint
159
+
160
+ - **Module Name**: `ponytail`
161
+ - **Description**: Forces AI coding agents to think like a pragmatic, lazy senior developer. Enforces the Decision Ladder: YAGNI checks, codebase reuse, standard library first, native platform features, and zero premature abstractions while strictly preserving security and error handling.
162
+ - **Upstream Source**: [https://github.com/DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail)
163
+ - **Contract File**: [`skills/ponytail/SKILL.md`](../skills/ponytail/SKILL.md)
164
+
165
+ [↑ Back to top](#toc)
166
+
167
+ ---
168
+
169
+ <a id="karpathy-guidelines"></a>
170
+ ### ⚡ Karpathy Simplicity Guidelines
171
+
172
+ - **Module Name**: `karpathy-guidelines`
173
+ - **Description**: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria.
174
+ - **Upstream Source**: [https://github.com/karpathy/guidelines](https://github.com/karpathy/guidelines)
175
+ - **Contract File**: [`skills/karpathy-guidelines/SKILL.md`](../skills/karpathy-guidelines/SKILL.md)
176
+
177
+ [↑ Back to top](#toc)
178
+
179
+ ---
180
+
181
+ <a id="strix-security"></a>
182
+ ### ⚡ Strix Differential Security Probing
183
+
184
+ - **Module Name**: `strix-security`
185
+ - **Description**: Autonomous AI penetration testing and dynamic HTTP differential probing methodology (based on usestrix/strix). Never trust code comments alone; verify every mounted route, static asset prefix, reverse-proxy rule, and Host-header boundary with concrete Proof-of-Concept (PoC) HTTP probes across Anonymous, Unprivileged, Cross-Tenant/Venue, and Authorized principals.
186
+ - **Upstream Source**: [https://github.com/strix-security/strix](https://github.com/strix-security/strix)
187
+ - **Contract File**: [`skills/strix-security/SKILL.md`](../skills/strix-security/SKILL.md)
188
+
189
+ [↑ Back to top](#toc)
190
+
191
+ ---
192
+
193
+ <a id="security-audit-sweep"></a>
194
+ ### ⚡ Security Audit Sweep Sentinel
195
+
196
+ - **Module Name**: `security-audit-sweep`
197
+ - **Description**: Generic security audit sweep for web applications, APIs, and microservices: performs dynamic differential HTTP probing, validates IAM role entitlements, scans dependency vulnerabilities, and checks for secret leakage.
198
+ - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
199
+ - **Contract File**: [`skills/security-audit-sweep/SKILL.md`](../skills/security-audit-sweep/SKILL.md)
200
+
201
+ [↑ Back to top](#toc)
202
+
203
+ ---
204
+
205
+ <a id="owasp-security"></a>
206
+ ### ⚡ OWASP Top 10 Web Defense
207
+
208
+ - **Module Name**: `owasp-security`
209
+ - **Description**: Reviews code for security vulnerabilities and guides secure implementation using OWASP Top 10:2025, ASVS 5.0, the OWASP Top 10 for LLM Applications (2026), and the OWASP Top 10 for Agentic Applications (2026). Use when reviewing code or a diff for security issues, implementing authentication, authorization, sessions, or cryptography, handling untrusted input, files, or URLs, hardening config, dependencies, or CI, or building LLM and AI agent features.
210
+ - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
211
+ - **Contract File**: [`skills/owasp-security/SKILL.md`](../skills/owasp-security/SKILL.md)
212
+
213
+ [↑ Back to top](#toc)
214
+
215
+ ---
216
+
217
+ <a id="cloudflare-security-audit"></a>
218
+ ### ⚡ Cloudflare Edge & WAF Security
219
+
220
+ - **Module Name**: `cloudflare-security-audit`
221
+ - **Description**: Security guidance and vulnerability review for codebases, APIs, services, CLI tools, libraries, and daemons. Use for security questions, focused reviews, vulnerability research, security audits, or pen tests. Run the complete workflow only for explicit codebase audit or pen-test requests, full/comprehensive/end-to-end reviews, or requested report artifacts.
222
+ - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
223
+ - **Contract File**: [`skills/cloudflare-security-audit/SKILL.md`](../skills/cloudflare-security-audit/SKILL.md)
224
+
225
+ [↑ Back to top](#toc)
226
+
227
+ ---
228
+
229
+ <a id="snyk-agent-scan"></a>
230
+ ### ⚡ Snyk Dependency & Vulnerability Scan
231
+
232
+ - **Module Name**: `snyk-agent-scan`
233
+ - **Description**: Scans AI agent skills, MCP configurations, prompts, and tooling environments for prompt injections, secret leakage, tool poisoning, and security vulnerabilities using Snyk Agent Scan CLI. Use when reviewing installed skills, testing agent security, auditing MCP servers, or auditing agent supply chain risks.
234
+ - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
235
+ - **Contract File**: [`skills/snyk-agent-scan/SKILL.md`](../skills/snyk-agent-scan/SKILL.md)
236
+
237
+ [↑ Back to top](#toc)
238
+
239
+ ---
240
+
241
+ <a id="postgres-best-practices"></a>
242
+ ### ⚡ Supabase Postgres Best Practices
243
+
244
+ - **Module Name**: `postgres-best-practices`
245
+ - **Description**: "Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill BEFORE writing or changing anything that lives in a Postgres database: creating or altering tables and columns (including choosing column types), schema design, migrations and declarative schema files, RLS policies and the tests that verify them, indexes, triggers, database functions, queues and scheduled jobs (pg_cron, pgmq), vector/semantic search (pgvector), and restoring dumps (pg_restore) or importing data. Also load it when diagnosing slow queries, high CPU, timeouts, EXPLAIN plans, connection exhaustion, locking, bloat, or rows visible to the wrong user or tenant. This is not just a performance guide — schema, migration, security, and SQL authoring tasks need these rules too, even for a one-column change or a single query."
246
+ - **Upstream Source**: [https://github.com/supabase/postgres-best-practices](https://github.com/supabase/postgres-best-practices)
247
+ - **Contract File**: [`skills/postgres-best-practices/SKILL.md`](../skills/postgres-best-practices/SKILL.md)
248
+
249
+ [↑ Back to top](#toc)
250
+
251
+ ---
252
+
253
+ <a id="progressive-disclosure"></a>
254
+ ### ⚡ Progressive Disclosure & Skill Architecture
255
+
256
+ - **Module Name**: `progressive-disclosure`
257
+ - **Description**: Structuring modular agent skills and toolsets with progressive disclosure to eliminate prompt bloat and avoid multi-agent sprawl.
258
+ - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
259
+ - **Contract File**: [`skills/progressive-disclosure/SKILL.md`](../skills/progressive-disclosure/SKILL.md)
260
+
261
+ [↑ Back to top](#toc)
262
+
263
+ ---
264
+
265
+ <a id="project-hygiene"></a>
266
+ ### ⚡ Project & Workspace Hygiene Sentinel
267
+
268
+ - **Module Name**: `project-hygiene`
269
+ - **Description**: Audit and enforce codebase hygiene across any project: eliminate dead code, purge unused dependencies and exports, enforce architectural module boundaries, clear stale build caches, and verify type safety.
270
+ - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
271
+ - **Contract File**: [`skills/project-hygiene/SKILL.md`](../skills/project-hygiene/SKILL.md)
272
+
273
+ [↑ Back to top](#toc)
274
+
275
+ ---
276
+
277
+ <a id="output-skill"></a>
278
+ ### ⚡ Structured Analysis & Output Formatting
279
+
280
+ - **Module Name**: `output-skill`
281
+ - **Description**: Overrides default LLM truncation behavior. Enforces complete code generation, bans placeholder patterns, and handles token-limit splits cleanly. Apply to any task requiring exhaustive, unabridged output.
282
+ - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
283
+ - **Contract File**: [`skills/output-skill/SKILL.md`](../skills/output-skill/SKILL.md)
284
+
285
+ [↑ Back to top](#toc)
286
+
287
+ ---
288
+
289
+ <a id="caveman"></a>
290
+ ### ⚡ Caveman Chat Token Brevity Protocol
291
+
292
+ - **Module Name**: `caveman`
293
+ - **Description**: Slashes chat token consumption by dropping conversational filler, pleasantries, and polite ceremony.
294
+ - **Upstream Source**: [https://github.com/JuliusBrussee/caveman](https://github.com/JuliusBrussee/caveman)
295
+ - **Contract File**: [`skills/caveman/SKILL.md`](../skills/caveman/SKILL.md)
296
+
297
+ [↑ Back to top](#toc)
298
+
299
+ ---
300
+
301
+ <a id="clean-code"></a>
302
+ ### ⚡ Clean Code & ub-mode Quality Sentinel
303
+
304
+ - **Module Name**: `clean-code`
305
+ - **Aliases**: `/clean-code`, `/ub-mode`
306
+ - **Description**: Enforces Uncle Bob's Clean Code discipline, TDD cycles, laziness protocol, and mathematical quality gates (CRAP < 10, DRY similarity < 0.8, mutant-killing test design).
307
+ - **Upstream Source**: [https://github.com/unclebob/ub-mode](https://github.com/unclebob/ub-mode)
308
+ - **Contract File**: [`skills/clean-code/SKILL.md`](../skills/clean-code/SKILL.md)
144
309
 
145
310
  [↑ Back to top](#toc)
146
311
 
147
312
  ---
148
313
 
149
- ## Standalone Power Toolkits
150
-
151
- <a id="ponytail"></a>
152
- ### ⚡ Ponytail Code Restraint
153
-
154
- - **Module Name**: `ponytail`
155
- - **Description**: Forces AI coding agents to think like a pragmatic, lazy senior developer. Enforces the Decision Ladder: YAGNI checks, codebase reuse, standard library first, native platform features, and zero premature abstractions while strictly preserving security and error handling.
156
- - **Upstream Source**: [https://github.com/DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail)
157
- - **Contract File**: [`skills/ponytail/SKILL.md`](../skills/ponytail/SKILL.md)
158
-
159
- [↑ Back to top](#toc)
314
+ <a id="communication-doctrine"></a>
315
+ ### ⚡ Communication Doctrine (BLUF & Simplified Technical English)
160
316
 
317
+ - **Module Name**: `communication-doctrine`
318
+ - **Description**: Enforces zero-latency Bottom Line Up Front (BLUF) headers on subagent handoffs, code reviews, and plans, alongside Simplified Technical English (STE) imperative syntax that eliminates ambiguous qualifiers.
319
+ - **Contract File**: [`skills/communication-doctrine/SKILL.md`](../skills/communication-doctrine/SKILL.md)
320
+
321
+ [↑ Back to top](#toc)
322
+
161
323
  ---
162
324
 
163
- <a id="karpathy-guidelines"></a>
164
- ### ⚡ Karpathy Simplicity Guidelines
325
+ <a id="threat-modeling"></a>
326
+ ### ⚡ STRIDE Threat Modeling & Attack Surface Sentinel
165
327
 
166
- - **Module Name**: `karpathy-guidelines`
167
- - **Description**: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria.
168
- - **Upstream Source**: [https://github.com/karpathy/guidelines](https://github.com/karpathy/guidelines)
169
- - **Contract File**: [`skills/karpathy-guidelines/SKILL.md`](../skills/karpathy-guidelines/SKILL.md)
328
+ - **Module Name**: `threat-modeling`
329
+ - **Description**: Systematic STRIDE threat modeling, trust boundary mapping, and mitigation verification for architecture, API, and cloud infrastructure changes.
330
+ - **Contract File**: [`skills/threat-modeling/SKILL.md`](../skills/threat-modeling/SKILL.md)
170
331
 
171
332
  [↑ Back to top](#toc)
172
333
 
173
334
  ---
174
335
 
175
- <a id="strix-security"></a>
176
- ### ⚡ Strix Differential Security Probing
336
+ <a id="mcp-engineering"></a>
337
+ ### ⚡ MCP Server & Tool Engineering Standards
177
338
 
178
- - **Module Name**: `strix-security`
179
- - **Description**: Autonomous AI penetration testing and dynamic HTTP differential probing methodology (based on usestrix/strix). Never trust code comments alone; verify every mounted route, static asset prefix, reverse-proxy rule, and Host-header boundary with concrete Proof-of-Concept (PoC) HTTP probes across Anonymous, Unprivileged, Cross-Tenant/Venue, and Authorized principals.
180
- - **Upstream Source**: [https://github.com/strix-security/strix](https://github.com/strix-security/strix)
181
- - **Contract File**: [`skills/strix-security/SKILL.md`](../skills/strix-security/SKILL.md)
339
+ - **Module Name**: `mcp-engineering`
340
+ - **Description**: Standards, JSON-RPC 2.0 protocol compliance, schema validation, and stdio/SSE transport discipline for authoring Model Context Protocol (MCP) servers and tools.
341
+ - **Contract File**: [`skills/mcp-engineering/SKILL.md`](../skills/mcp-engineering/SKILL.md)
182
342
 
183
343
  [↑ Back to top](#toc)
184
344
 
185
345
  ---
186
346
 
187
- <a id="security-audit-sweep"></a>
188
- ### ⚡ Security Audit Sweep Sentinel
347
+ <a id="herdr"></a>
348
+ ### ⚡ Herdr Coding Agent Multiplexer & Orchestrator
189
349
 
190
- - **Module Name**: `security-audit-sweep`
191
- - **Description**: Generic security audit sweep for web applications, APIs, and microservices: performs dynamic differential HTTP probing, validates IAM role entitlements, scans dependency vulnerabilities, and checks for secret leakage.
192
- - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
193
- - **Contract File**: [`skills/security-audit-sweep/SKILL.md`](../skills/security-audit-sweep/SKILL.md)
350
+ - **Module Name**: `herdr`
351
+ - **Description**: Control Herdr, a terminal workspace manager for coding agents. Inspect or control panes, tabs, workspaces, commands, or coordinate with peer agents (claude, codex, gemini/agy, etc.) in persistent terminal sessions.
352
+ - **Contract File**: [`skills/herdr/SKILL.md`](../skills/herdr/SKILL.md)
194
353
 
195
354
  [↑ Back to top](#toc)
196
355
 
197
356
  ---
198
357
 
199
- <a id="owasp-security"></a>
200
- ### ⚡ OWASP Top 10 Web Defense
358
+ <a id="thermo"></a>
359
+ ### ⚡ Thermo Architectural & Maintainability Audit
201
360
 
202
- - **Module Name**: `owasp-security`
203
- - **Description**: Reviews code for security vulnerabilities and guides secure implementation using OWASP Top 10:2025, ASVS 5.0, the OWASP Top 10 for LLM Applications (2026), and the OWASP Top 10 for Agentic Applications (2026). Use when reviewing code or a diff for security issues, implementing authentication, authorization, sessions, or cryptography, handling untrusted input, files, or URLs, hardening config, dependencies, or CI, or building LLM and AI agent features.
204
- - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
205
- - **Contract File**: [`skills/owasp-security/SKILL.md`](../skills/owasp-security/SKILL.md)
361
+ - **Module Name**: `thermo`
362
+ - **Description**: Unusually strict architectural and maintainability review focusing on "Code Judo" structural simplification, spaghetti conditional elimination, and modularity health.
363
+ - **Contract File**: [`skills/thermo/SKILL.md`](../skills/thermo/SKILL.md)
206
364
 
207
365
  [↑ Back to top](#toc)
208
366
 
209
367
  ---
210
368
 
211
- <a id="cloudflare-security-audit"></a>
212
- ### ⚡ Cloudflare Edge & WAF Security
369
+ <a id="pstack-discipline"></a>
370
+ ### ⚡ PStack Engineering Discipline
213
371
 
214
- - **Module Name**: `cloudflare-security-audit`
215
- - **Description**: Security guidance and vulnerability review for codebases, APIs, services, CLI tools, libraries, and daemons. Use for security questions, focused reviews, vulnerability research, security audits, or pen tests. Run the complete workflow only for explicit codebase audit or pen-test requests, full/comprehensive/end-to-end reviews, or requested report artifacts.
216
- - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
217
- - **Contract File**: [`skills/cloudflare-security-audit/SKILL.md`](../skills/cloudflare-security-audit/SKILL.md)
372
+ - **Module Name**: `pstack-discipline`
373
+ - **Description**: High-rigor engineering discipline from the pstack / poteto framework: "Prove It Works", "Fix Root Causes", "Test Behavior, Not Implementation", and "Subtract Before You Add".
374
+ - **Contract File**: [`skills/pstack-discipline/SKILL.md`](../skills/pstack-discipline/SKILL.md)
218
375
 
219
376
  [↑ Back to top](#toc)
220
377
 
221
378
  ---
222
-
223
- <a id="snyk-agent-scan"></a>
224
- ### ⚡ Snyk Dependency & Vulnerability Scan
225
-
226
- - **Module Name**: `snyk-agent-scan`
227
- - **Description**: Scans AI agent skills, MCP configurations, prompts, and tooling environments for prompt injections, secret leakage, tool poisoning, and security vulnerabilities using Snyk Agent Scan CLI. Use when reviewing installed skills, testing agent security, auditing MCP servers, or auditing agent supply chain risks.
228
- - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
229
- - **Contract File**: [`skills/snyk-agent-scan/SKILL.md`](../skills/snyk-agent-scan/SKILL.md)
230
-
231
- [↑ Back to top](#toc)
232
-
233
- ---
234
-
235
- <a id="postgres-best-practices"></a>
236
- ### ⚡ Supabase Postgres Best Practices
237
-
238
- - **Module Name**: `postgres-best-practices`
239
- - **Description**: "Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill BEFORE writing or changing anything that lives in a Postgres database: creating or altering tables and columns (including choosing column types), schema design, migrations and declarative schema files, RLS policies and the tests that verify them, indexes, triggers, database functions, queues and scheduled jobs (pg_cron, pgmq), vector/semantic search (pgvector), and restoring dumps (pg_restore) or importing data. Also load it when diagnosing slow queries, high CPU, timeouts, EXPLAIN plans, connection exhaustion, locking, bloat, or rows visible to the wrong user or tenant. This is not just a performance guide — schema, migration, security, and SQL authoring tasks need these rules too, even for a one-column change or a single query."
240
- - **Upstream Source**: [https://github.com/supabase/postgres-best-practices](https://github.com/supabase/postgres-best-practices)
241
- - **Contract File**: [`skills/postgres-best-practices/SKILL.md`](../skills/postgres-best-practices/SKILL.md)
242
-
243
- [↑ Back to top](#toc)
244
-
245
- ---
246
-
247
- <a id="project-hygiene"></a>
248
- ### ⚡ Project & Workspace Hygiene Sentinel
249
-
250
- - **Module Name**: `project-hygiene`
251
- - **Description**: Audit and enforce codebase hygiene across any project: eliminate dead code, purge unused dependencies and exports, enforce architectural module boundaries, clear stale build caches, and verify type safety.
252
- - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
253
- - **Contract File**: [`skills/project-hygiene/SKILL.md`](../skills/project-hygiene/SKILL.md)
254
-
255
- [↑ Back to top](#toc)
256
-
257
- ---
258
-
259
- <a id="output-skill"></a>
260
- ### ⚡ Structured Analysis & Output Formatting
261
-
262
- - **Module Name**: `output-skill`
263
- - **Description**: Overrides default LLM truncation behavior. Enforces complete code generation, bans placeholder patterns, and handles token-limit splits cleanly. Apply to any task requiring exhaustive, unabridged output.
264
- - **Upstream Source**: [https://github.com/bepaldes/heimdall-agent](https://github.com/bepaldes/heimdall-agent)
265
- - **Contract File**: [`skills/output-skill/SKILL.md`](../skills/output-skill/SKILL.md)
266
-
267
- [↑ Back to top](#toc)
268
-
269
- ---
270
-
271
- <a id="caveman"></a>
272
- ### ⚡ Caveman Chat Token Brevity Protocol
273
-
274
- - **Module Name**: `caveman`
275
- - **Description**: Slashes chat token consumption by dropping conversational filler, pleasantries, and polite ceremony.
276
- - **Upstream Source**: [https://github.com/JuliusBrussee/caveman](https://github.com/JuliusBrussee/caveman)
277
- - **Contract File**: [`skills/caveman/SKILL.md`](../skills/caveman/SKILL.md)
278
-
279
- [↑ Back to top](#toc)
280
-
281
- ---
282
-