honey-badger-deploy

name	honey-badger-deploy
description	Scaffold and deploy authentication systems based on project configuration. Activates when the user says "scaffold auth", "setup authentication", "deploy auth system", "add master password", "add Argon2id", "session management", "auth deployment", "password hashing", "encryption setup", or invokes /honey-badger-deploy. Reads project.config.json to determine auth strategy (master password, Better Auth, custom) and scaffolds accordingly.
allowed-tools	["Read","Write","Edit","Bash","Grep","Glob"]
user-invocable	true
argument-hint	[project-path] [--strategy master-password|better-auth|custom]

// honey-badger-deploy SKILL.md / Developer: Marcus Daley / 2026-02-27 // Auth deployment skill — scaffolds authentication systems per project config // Supports: master password (HBV), Better Auth (multi-user), custom strategies

Auth System Deployment

Scaffold a complete authentication system based on project.config.json settings.

Supported Strategies

Strategy	Use Case	Components
master-password	Single-user local apps (HBV)	Argon2id hashing, HMAC sessions, AES-256-GCM encryption
better-auth	Multi-user web apps	Better Auth framework, OAuth, RBAC
custom	Special requirements	User-defined, skill provides scaffolding hooks

Quick Start

/honey-badger-deploy                              # Auto-detect from project.config.json
/honey-badger-deploy --strategy master-password    # Force master password strategy
/honey-badger-deploy D:\my-project                 # Target a specific project

Workflow

Step 1: Read Project Config

// Load project.config.json and extract auth settings

Step 2: Validate Prerequisites

// Check for required dependencies (argon2, better-auth, etc.)

Step 3: Scaffold Auth Files

// Generate auth module, encryption module, middleware, client hooks

Step 4: Wire Dependencies

// Register auth in composition root, add routes, configure middleware

Step 5: Verify

// Run type check, confirm routes respond, test password flow

References

• Argon2id tuning: references/argon2id-tuning.md
• Session security: references/session-security.md
• Encryption patterns: references/encryption-patterns.md
• OWASP password storage: references/owasp-password-storage.md

Scripts

• scripts/scaffold-auth.sh — Generate auth file structure for new projects