
Spec-linked implementation owner
Product clarity and acceptance criteria owner
Direction Suggester
Feature Editor
# hephaestus-assist Use this as the normal-user entrypoint for Hephaestus. ## Purpose Provide a single-assistant experience while preserving strict internal lifecycle, role contracts, DB-first retrieval, and security gates. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. This skill MUST follow `.hephaest
# hephaestus-ci-triage Use this skill for deterministic CI failure ontology classification and owner routing. ## Purpose Convert failed CI evidence into class, confidence, and role handoffs with DB-first traceability. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/ci-automation-contract.md`. This skill MUST follow `.hephaestus/promp
# hephaestus-decision-recorder Use this skill to persist decision rationale, peer critiques, and final planning decisions. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Responsibilities - Persist `decision_rationale` and `feature_decisions` as authoritative planning memory. - Enforce two-pass peer
# hephaestus-direction-suggester Use this skill after plan stabilization to suggest next directions and roadmap adjacencies. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Responsibilities - Suggest adjacent opportunities, MVP cuts, sequencing improvements, and missing requirements. - Activate only
# hephaestus-execute Use this skill as the explicit implementation gear. ## Purpose Implement planned slices with strict spec linkage and serialized write-heavy work. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/ci-automation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Use When - Sp
# hephaestus-feature-editor Use this skill to normalize, split, merge, and deduplicate feature candidates. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Responsibilities - Normalize candidate feature shape (`problem`, `user_value`, `intent_tags`, `dependencies`, `constraints`, `risk_tags`). - Compu
Implementer
# hephaestus-laziness-audit Use this skill as a targeted anti-laziness gate before code is considered ship-ready. ## Purpose Audit implementation quality for common lazy-AI failure patterns and produce a ship-gating report. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/ci-automation-contract.md`. This skill MUST follow `.hephaestus
# hephaestus-product-strategy Use this skill to frame product planning intent, user value, and constraints before feature slicing. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Responsibilities - Convert conversational prompts and referenced files into normalized product intent. - Persist planning
# hephaestus-requirements-analyst Use this skill to convert refined features into requirements, acceptance criteria, and task-ready slices. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Responsibilities - Generate requirement statements and acceptance criteria for each active feature. - Persist `ta
# hephaestus-review Use this skill as the explicit quality gate before ship. ## Purpose Perform risk-first review for correctness, security, and maintainability. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/ci-automation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Use When - Verific
# hephaestus-roadmap-advisor Use this skill to prioritize and sequence refined features into a practical roadmap. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Responsibilities - Build roadmap sequencing and MVP cut suggestions grounded in DB evidence. - Persist `roadmap_items` and prioritization r
# hephaestus-run Use this as the default Hephaestus orchestrator skill. ## Purpose Drive `Request -> Intake -> Spec -> Plan -> Execute -> Verify -> LazinessAudit -> Review -> SecurityAudit -> Ship -> Retro` with explicit artifacts and handoffs. When invoked through normal user mode (`hephaestus-assist` / `hephaestus ask`), keep this orchestration in the background and emit milestone-only user output. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`.
Spec Architect
# hephaestus-supply-chain-gate Use this skill for deterministic A03/A08 dependency and integrity gate checks. ## Purpose Enforce supply-chain and artifact-integrity controls before ship. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/ci-automation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`
# hephaestus-threat-surface-sync Use this skill to keep trust boundaries and threat assumptions aligned with spec/plan changes. ## Purpose Persist architecture/security surface deltas as structured DB memory for later verification and review. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Use When
Verifier
Product Strategist
Requirements Analyst
# hephaestus-ci-fix-suggest Use this skill to generate policy-safe CI fix suggestions from recurrence and cluster priors. ## Purpose Produce ranked fix candidates with mechanism hypothesis, risk note, and verification plan. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/ci-automation-contract.md`. This skill MUST follow `.hephaestus
# hephaestus-security-audit Use this skill as the explicit OWASP Top 10:2025 security gate before ship. ## Purpose Perform a structured security audit aligned to OWASP Top 10:2025 and persist security findings/blockers to DB. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/ci-automation-contract.md`. This skill MUST follow `.hephaest
Design correctness and implementation drift owner
Intake
# hephaestus-log-triage Use this skill to turn noisy logs into actionable rework items. ## Purpose Triage execution, test, and CI logs into severity-ranked issues with owners and next actions. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/ci-automation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contra
Orchestrator
Planner
Reviewer
# Hephaestus Skill (Compatibility Alias) This legacy alias maps to `hephaestus-assist` in normal mode and `hephaestus-run` for explicit operator orchestration. Use `hephaestus-assist` as the default normal-user entrypoint. All flows inherit `.hephaestus/prompts/master-agent-directive.md`. All flows use DB-first retrieval via `.hephaestus/db/hephaestus_memory.sqlite3`. All flows follow `.hephaestus/prompts/db-navigation-contract.md`. All flows follow `.hephaestus/prompts/security-review-contrac
Roadmap Advisor
Decision Recorder
# hephaestus-ci-flake-detect Use this skill to classify flaky CI behavior from retries and recurrence history. ## Purpose Distinguish flaky/transient failures from deterministic regressions using evidence thresholds. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/ci-automation-contract.md`. This skill MUST follow `.hephaestus/prompt
# hephaestus-spec-plan Use this skill as the explicit design and planning gear after intake. ## Purpose Produce an implementation-ready specification and an execution plan with clear ownership and dependencies. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Use When - Intake artifacts are complete.
CI, build, runtime environment health owner
# hephaestus-retrieval-audit Use this skill to produce a minimum-sufficient DB-first evidence bundle with audit persistence. ## Purpose Generate intent-aware, scope-aware evidence bundles that stay within role budgets and remain traceable. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Use When - `
# hephaestus-verify Use this skill as the explicit verification gear. ## Purpose Validate behavior against acceptance criteria and produce reproducible evidence. ## Master Directive This skill MUST follow `.hephaestus/prompts/master-agent-directive.md`. This skill MUST follow `.hephaestus/prompts/db-navigation-contract.md`. This skill MUST follow `.hephaestus/prompts/ci-automation-contract.md`. This skill MUST follow `.hephaestus/prompts/security-review-contract.md`. ## Use When - Execute
Correctness, security, and maintainability owner
Stage readiness and artifact completeness owner
Behavior, tests, and reproducibility owner