# Hephaestus Build

Use when the user types /prompts:hep-build or /agentlas-build, mentions @Hephaestus for...

- Repository: https://github.com/agentlas-ai/Agentlas-OS (1593 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-build -g -a claude-code -y`
Codex: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-build -g -a codex -y`
Cursor: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-build -g -a cursor -y`
Gemini CLI: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-build -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add agentlas-ai/Agentlas-OS`

## Description

Use when the user types /prompts:hep-build or /agentlas-build, mentions @Hephaestus for build work, asks to create a single Agentlas agent, create a multi-agent team, or package an existing local/external agent into Agentlas architecture.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Hephaestus Build

## Procedure

1. Treat this as the public Codex build surface. Do not expose or ask the user
   to invoke the older internal support skill names.
2. Resolve the trusted engine root before reading any build contract:

   ```bash
   ENGINE=""
   for candidate in \
     "${CODEX_PLUGIN_ROOT:-}" \
     "${CLAUDE_PLUGIN_ROOT:-}" \
     "${PLUGIN_ROOT:-}" \
     "$HOME/.agentlas/runtime/current/host_adapters/codex/plugins/agentlas-core-engine-meta-agent" \
     "$HOME/.agentlas/runtime/current/host_adapters/claude/plugins/agentlas-core-engine-meta-agent" \
     "$HOME/.agentlas/runtime/current" \
     "."
   do
     if [ -n "$candidate" ] && [ -f "$candidate/AGENTS.md" ] && [ -f "$candidate/package-contract.json" ] && [ -f "$candidate/contracts/builder-interview-research-gate.md" ]; then
       ENGINE="$candidate"
       break
     fi
   done
   [ -n "$ENGINE" ] || { echo "Hephaestus engine not found. Run the installer first." >&2; exit 1; }
   RUNNER=""
   for candidate in "$HOME/.agentlas/runtime/current/bin/hephaestus" "$ENGINE/bin/hephaestus"; do
     if [ -x "$candidate" ]; then RUNNER="$candidate"; break; fi
   done
   [ -n "$RUNNER" ] || { echo "Hephaestus runner not found." >&2; exit 1; }
   ```

   For an interactive request whose first argument is `session`, do not resolve
   a generic `PACKAGE_TARGET` and do not ask for a JSON/JSONL export. Ask first:
   "이 세션에서 만든 에이전트를 기본 전역 Agentlas 에이전트 폴더에 만들까요? 다른 위치를 원하면 경로를 알려주세요. 별도 위치를 지정하지 않으면 전역 폴더에 만듭니다."
   If no alternate location is named, use `AGENTLAS_AGENT_HOME` or
   `~/.agentlas/agentlas-agent` and create a new safe-slug child package. If a
   destination is supplied, validate that exact folder. Never overwrite an
   existing child. The current conversation is the source; do not inspect
   recent sessions or host databases.

The rest: https://github.com/agentlas-ai/Agentlas-OS/blob/HEAD/codex/plugins/agentlas-core-engine-meta-agent/skills/hephaestus-build/SKILL.md