Agent skill

Hephaestus Graph

by agentlas-ai in agentlas-ai/Agentlas-OS

A skill your agent uses when the user types /hep-graph or asks to create, list, inspect, or request a run of an Agentlas automation graph.

Apache-2.0Auto-check passedAgent Workflows

Install Hephaestus Graph

skills CLI
$ npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-graph -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install agentlas-ai/Agentlas-OS hephaestus-graph --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/agentlas-ai/Agentlas-OS.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hephaestus-graph .claude/skills/hephaestus-graph && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hephaestus-graph
GitHub stars
1.6k
Token cost
~498 tokens
SKILL.md length
225 words
Files
1
Skills in repo
53
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user types /hep-graph or asks to create, list, inspect, or request a run of an Agentlas automation graph.

  • The user types /hep-graph
  • SKILL.md covers Resolve the independent… and Commands
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Request a run of an Agentlas automation graph

What it does

Hephaestus Graph is an agent skill from agentlas-ai/Agentlas-OS. Use when the user types /hep-graph or asks to create, list, inspect, or request a run of an Agentlas automation graph.

Its SKILL.md is about 500 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows. The repository describes itself as: Agent OS: keep specialist agents in a hub, spin up a temporary orchestrator per task. Local-first, works with any model. The licence is Apache-2.0.

When your agent uses it

  • The user types /hep-graph
  • Request a run of an Agentlas automation graph

Example prompts

  • “/hephaestus-graph”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit cfdebf8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hephaestus Graph loads about 498 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 225 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~498

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from agentlas-ai/Agentlas-OS at commit cfdebf8, republished under its Apache-2.0 licence (© agentlas-ai). 225 words, ~498 tokens.

Download SKILL.mdSave it as .claude/skills/hephaestus-graph/SKILL.md (or your agent's skills folder).
name
hephaestus-graph
description
Use when the user types /hep-graph or asks to create, list, inspect, or request a run of an Agentlas automation graph.

Hephaestus Graph

Saved graphs live in the local Agentlas database shared with Agentlas Desktop. This skill may create, list, inspect, or request a graph run; it does not execute the graph itself.

Resolve the independent Agentlas CLI

Use the first executable path:

bash
CLI=""
for candidate in \
  "$(command -v agentlas 2>/dev/null)" \
  "$HOME/.agentlas/runtime/current/bin/agentlas" \
  "./bin/agentlas"
do
  if [ -n "$candidate" ] && [ -x "$candidate" ]; then CLI="$candidate"; break; fi
done
[ -n "$CLI" ] || { echo "Agentlas CLI not found. Install it with: npm i -g agentlas" >&2; exit 1; }

Do not substitute Gemini CLI, Hephaestus routing, or Hub search when the Agentlas CLI is missing.

Commands

  • No arguments or list: run "$CLI" graph list and report each graph's trigger, step count, and on/off state.
  • show <name>: run "$CLI" graph show "<name>". Preserve the tree wiring, external-effect and ask-first marks, branch sides, repeat edges, verification checklist, code steps, and any required input in the summary.
  • new <request>: run "$CLI" graph new "<request>" as an interview. Relay every unanswered question and never invent schedule, external-effect, repetition, or checklist answers. The final save confirmation is the graph's approval. A new graph starts switched off.
  • run <name>: the user's direct run request is sufficient authority. Do not ask for a second approval. Show the graph first; if it requires an input, obtain that missing value without inventing it. Then run "$CLI" graph run "<name>" -y, adding --input "<value>" when required.

Report exactly that a run was requested and will be picked up by Agentlas Desktop. Never claim the graph executed. On any non-zero exit, relay the exact refusal and stop; do not retry with a guess.

© agentlas-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/hephaestus-graph of agentlas-ai/Agentlas-OS.

Open the folder on GitHubat commit cfdebf8

Compare with similar skills

Hephaestus Graph next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hephaestus Graph compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hephaestus Graph this skillagentlas-ai/Agentlas-OS1.6k—~498Automated safety check: PassApache-2.0
MCP Server Builderanthropics/skills180k64 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k11 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k35 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers296k2 repos~5.1kAutomated safety check: PassMIT
Claude Code Agent Developmentanthropics/claude-plugins-official38k8 repos~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 64 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 11 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 35 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    296k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 8 repos~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    795 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed

More from agentlas-ai/Agentlas-OS

All 53 skills in this repo
  • Agentlas Security Scan

    agentlas-ai/Agentlas-OS

    A skill your agent uses when an agent folder must pass the Agentlas Cloud 2-stage security scan (static rules + BYOK LLM judgment) before private sync or public publish, or when asked to…

    1.6k GitHub starsUsed in 1 repo~822 tokens
    Auto-check passed
  • Hephaestus Build

    agentlas-ai/Agentlas-OS

    A skill your agent uses 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…

    1.6k GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Hephaestus Upload

    agentlas-ai/Agentlas-OS

    A skill your agent uses when the user types $hephaestus-upload, /hep-upload, or /agentlas-upload, or asks to upload, publish, or list an Agentlas agent or team.

    1.6k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Routing Card Authoring

    agentlas-ai/Agentlas-OS

    A skill your agent uses whenever a build emits or repairs .agentlas/routing-card.json — the shared card contract for the single-agent builder, the team builder, and the packager.

    1.6k GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed
  • Team Builder Packaging

    agentlas-ai/Agentlas-OS

    A skill your agent uses when generating or auditing a multi-role agent team package with orchestrator, PM Soul, Memory Curator, Policy Gate, workers, eval, QA, handoffs, and runtime adapters.

    1.6k GitHub stars~642 tokensUpdated yesterday
    Auto-check passed
  • Hep Browser

    agentlas-ai/Agentlas-OS

    Use the Agentlas browser hardpoint for browser-required work.

    1.6k GitHub starsUsed in 1 repo~774 tokens
    Auto-check passed

Categories

Questions about Hephaestus Graph

What does Hephaestus Graph do?

A skill your agent uses when the user types /hep-graph or asks to create, list, inspect, or request a run of an Agentlas automation graph. Hephaestus Graph is an agent skill from agentlas-ai/Agentlas-OS. Use when the user types /hep-graph or asks to create, list, inspect, or request a run of an Agentlas automation graph.

When should I use Hephaestus Graph?

Hephaestus Graph fits situations like: the user types /hep-graph; request a run of an Agentlas automation graph.

How do I install Hephaestus Graph in Claude Code?

Run `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-graph -a claude-code`. Or copy the skill folder (skills/hephaestus-graph in agentlas-ai/Agentlas-OS) into .claude/skills/hephaestus-graph in your project. Claude Code loads it when a task matches its description.

How do I install Hephaestus Graph in Codex?

Run `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-graph -a codex`. Or copy the skill folder (skills/hephaestus-graph in agentlas-ai/Agentlas-OS) into .agents/skills/hephaestus-graph in your project. Codex loads it when a task matches its description.

Can I use Hephaestus Graph in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-graph -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hephaestus-graph, .gemini/skills/hephaestus-graph, .github/skills/hephaestus-graph and .opencode/skills/hephaestus-graph in your project.

What does Hephaestus Graph need to run?

SKILL.md names no scripts, command-line tools or credentials: Hephaestus Graph is instructions for the agent only. Our summary lists: Node.js.

Does Hephaestus Graph access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hephaestus Graph safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hephaestus Graph use?

Hephaestus Graph is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hephaestus Graph use?

About 498 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hephaestus Graph?

Skills that share tags, products or a category with Hephaestus Graph: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 296k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hephaestus Graph?

agentlas-ai (a GitHub organization) maintains it in agentlas-ai/Agentlas-OS, which has 1,575 GitHub stars. The repository holds 53 skills in this directory. The repository was last updated on October 6, 2026.

Source: agentlas-ai/Agentlas-OS on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.